Conector SharePoint sharepoint-connector
Conector JCR do dia para Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versão 4.0.
Este artigo inclui detalhes sobre o Adobe JCR Connector for Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versão 4.0.
O conector SharePoint é compatível com as seguintes funcionalidades básicas:
- Leitura de conteúdo e metadados do SharePoint.
- Confirmando as configurações de segurança do SharePoint para o conteúdo acessado aplicando a autenticação e a autorização nativas do SharePoint
- Integração de conteúdo usando o Localizador de conteúdo
- Uso de componentes AEM, como Recurso externo para exibir imagens e vídeos do SharePoint
- Sincronização do SharePoint com o AEM Assets
Todas as funcionalidades são implementadas usando os serviços Web nativos da SharePoint como interface para o conteúdo e os serviços da SharePoint.
Introdução getting-started
Para começar a usar o conector, faça o seguinte:
-
Certifique-se de ter pelo menos o Java 7 instalado.
-
Baixe o arquivo de distribuição do pacote de conectores do Compartilhamento de pacotes.
-
Copiar um license.properties para o diretório que contém a variável cq-quickstart-6.4.0.jar arquivo.
-
Clique/toque duas vezes no arquivo .jar para iniciar o AEM ou inicie-o a partir da linha de comando.
-
Instale o pacote de conectores no Gerenciador de pacotes.
-
Configure as opções do conector.
Instalação do conector SharePoint installing-sharepoint-connector
O conector é um pacote de conteúdo que facilita a instalação fácil. Instale o pacote usando o Gerenciador de pacotes e, em seguida, defina o URL do servidor do SharePoint
e outras opções de configuração. O conteúdo do SharePoint está disponível no repositório AEM.
Requisitos de instalação installation-requirements
O conector requer o seguinte:
- Java Runtime Environment 1.7 ou posterior
- Serviços Web da SharePoint disponíveis através da rede
- URL do servidor SharePoint
- Credenciais do usuário e permissões para repositórios CRX e SharePoint
- Plataformas compatíveis
O conector SharePoint está disponível para download no compartilhamento de pacotes.
Plataformas compatíveis supported-platforms
O conector é compatível com o seguinte:
-
AEM versões:
- AEM 6.4, 6.3
-
Versões do Microsoft SharePoint:
- Microsoft Office SharePoint Server (MOSS) 2010
- Microsoft Office SharePoint Server (MOSS) 2013
-
Se você precisar de suporte para implantações personalizadas do conector (OEM, requisitos especiais, métodos de autenticação personalizados), entre em contato com o Adobe da sua região.
Instalação padrão standard-installation
AEM o Compartilhamento de pacotes é usado para distribuir recursos do produto, exemplos e hot fixes. Para obter detalhes, consulte o Documentação de compartilhamento de pacotes.
Para acessar o Compartilhamento de pacotes na página de boas-vindas do AEM, toque/clique Ferramentas e depois selecione Compartilhamento de pacotes. Você precisa de uma Adobe ID válida que inclua o endereço de email de sua empresa. Além disso, depois de fazer logon em sua conta, solicite acesso ao Compartilhamento de pacotes.
Integração com AEM integrating-with-aem
Para instalar o pacote de conteúdo do conector.
-
Abra um tíquete de suporte do Adobe para solicitar o pacote de recursos do conector.
-
Baixe o pacote quando ele estiver disponível e abra o Gerenciador de pacotes para sua instância do AEM.
-
Toque/clique Instalar na página de descrição do pacote.
-
No Instalar pacote , toque/clique Instalar.
Observação: Certifique-se de estar conectado como administrador.
-
Quando o pacote estiver instalado, toque/clique em Fechar.
Configuração do conector SharePoint configuring-sharepoint-connector
Depois de instalar o conector do SharePoint, configure o aplicativo e as camadas do SharePoint para o conector.
Defina o URL do servidor do SharePoint para tornar seu repositório do SharePoint compatível com o JCR. Você pode definir parâmetros adicionais para configurar a conexão com o servidor do SharePoint. Além disso, configure a autenticação com o conector do SharePoint.
Configuração da conexão com o servidor SharePoint configuring-the-connection-with-the-sharepoint-server
Para definir o URL do servidor SharePoint e as opções avançadas, execute estas etapas:
- Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.
- Procure a variável Conector JCR do dia para Microsoft Sharepoint pacote.
- Edite os valores de configuração.
- Defina o URL do servidor do SharePoint como o valor de Áreas de trabalho.
- Toque/clique Salvar.
Parâmetros de 'Espaços de trabalho' e 'Nome padrão do espaço de trabalho':
Por padrão, o conector expõe um único espaço de trabalho JCR. O servidor do SharePoint exposto por esse espaço de trabalho é definido por meio do parâmetro de configuração "URL do servidor do Sharepoint".
O conector também pode ser configurado para vários espaços de trabalho. Nesse caso, cada espaço de trabalho é associado ao URL do respectivo servidor do SharePoint que é exposto por meio do espaço de trabalho. Para adicionar um espaço de trabalho, adicione uma definição de espaço de trabalho ao parâmetro Espaços de trabalho . Uma definição de espaço de trabalho tem o seguinte formato:<name>
= <url>
em que<name>
é o nome do espaço de trabalho JCR e<url>
é o URL do servidor SharePoint para esse espaço de trabalho.
No AEM, execute mais uma etapa além das etapas de configuração acima. Lista de permissões o 'com.day.cq.dam.cq-dam-jcr-connectors Pacote '.
Para lista de permissões pacotes no AEM, execute as seguintes etapas:
-
Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.
-
Procure por serviço "Apache Sling Login Admin Whitelist".
-
Selecione Ignorar a lista de permissões.
-
Adicionar 'com.day.cq.dam.cq-dam-jcr-connectors' em pacotes de lista de permissões padrão
-
Clique em Salvar.
Para obter mais informações sobre parâmetros relacionados à autenticação, consulte Autenticação.
Verificar a configuração do Sharepoint verifying-the-sharepoint-setup
Depois de configurar o conector, verifique o seguinte:
- O servidor do SharePoint é executado e os serviços da Web são acessíveis para a instância do conector
- As credenciais do usuário do SharePoint são válidas e o usuário tem as permissões necessárias do SharePoint
- O conector está instalado e configurado corretamente
Configuração da sincronização DAM com o servidor do SharePoint configuring-dam-sync-with-the-sharepoint-server
Para sincronizar o SharePoint Assets com o AEM, execute as seguintes etapas:
- Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.
- Procure pelo serviço "Default DAMAssetSynchronization".
- Edite os valores de configuração.
- Defina o nome de usuário e a Senha correspondente do usuário com acesso no site do SharePoint.
- Clique em Salvar.
Ative o Serviço de sincronização DAM, que é desativado por padrão:
- Navegue até os Componentes do console da Web OSGi: http://localhost:4502/system/console/components
- Procure por "com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService".
- Clique em Ativar.
Como opção, você pode configurar o atraso de sincronização entre diferentes ciclos de sincronização:
- Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr
- Procure por "DAY CQ DAM JCR Connector Asset Synchronization Service".
- Edite os valores de configuração.
- Defina o valor do Período de sincronização (em segundos).
- Clique em Salvar.
Configurar autenticação configuring-authentication
O Sharepoint inclui os métodos de autenticação Clássico e Baseado em Reivindicações , ambos com suporte para os seguintes tipos de autenticação:
- Básico
- Baseado em Forms
Em particular, os seguintes tipos de autenticação estão disponíveis:
- Classic-Basic
- Baseado no Forms clássico
- Reivindicações - Básicas
- Baseado em reivindicações Forms
O AEM JCR Connector for Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versão 4.0. oferece suporte à autenticação baseada em declarações (sugerida pela Microsoft), que opera nos seguintes modos:
- Autenticação básica/NTLM: O conector primeiro tenta se conectar usando a autenticação básica. Se não estiver disponível, ele alternará para autenticação baseada em NTLM.
- Autenticação baseada em Forms: O SharePoint valida os usuários com base nas credenciais que os usuários digitam em um formulário de logon (normalmente uma página da Web). O sistema emite um token para solicitações autenticadas que contém uma chave para restabelecer a identidade de solicitações subsequentes.
Configurar a autenticação baseada em Forms
Vá para: http://localhost:4502/system/console/bundles
- Clique em OSGI -> Configuração
- Pesquise "Conector Day JCR para Microsoft Sharepoint"
- Clique em "Editar os valores de configuração"
- Defina o valor de "Fábrica de Conexão do Sharepoint" como "com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory"
- Clique em Salvar
Configurando a Autenticação Básica (Windows)
- Desativar Autenticação de Token.
- Ir para http://localhost:4502/system/console/bundles.
- Clique em OSGI > Configuração.
- Procurar por Conector JCR do dia para Microsoft Sharepoint.
- Clique em
Edit the configuration values
. - Defina o valor da Fábrica de Conexões do Sharepoint como
com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
. - Clique em Salvar.
Somente um usuário autenticado no AEM e no SharePoint pode acessar o conteúdo do SharePoint por meio do conector.
Você também pode usar a extensão do conector para autenticação para criar um módulo de autenticação personalizado, que, por exemplo, mapeia o acesso de usuários AEM a usuários específicos do SharePoint. Crie AEM usuários correspondentes a usuários do SharePoint (o nome de usuário e a senha devem corresponder) para poder ver o conteúdo do SharePoint mapeado para a instância do conector.
Para criar um usuário no AEM:
- Faça logon em http://localhost:9502/with o usuário administrador.
- Clique em Ferramentas.
- Clique em Segurança.
- Clique em Usuários.
- Clique em Criar usuário
- Forneça a ID do usuário (nome de usuário com acesso no SharePoint)
- Forneça a senha correspondente
- Clique no símbolo de marca de verificação verde para criar o usuário
Para adicionar o usuário no grupo de administradores:
- Ir para Administração de Grupo
- Clique no nó "a"
- Clique em "administradores"
- Digite a ID de usuário criada acima na caixa de texto antes de Procurar botão
- Clique no símbolo de marca de verificação verde para adicionar o usuário ao grupo de administradores
Desativar Autenticação de Token disable-token-authentication
-
Baixe e instale o pacote
basic auth
.zip
do Compartilhamento de pacotes. -
Feche o Início Rápido.
-
Abra o arquivo \crx-quickstart\repository\repository.xml.
-
Encontre a tag
<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
-
Inserir a tag
<param name="disableTokenAuth" value="true"/>
dentro da tag mencionada na etapa 4. -
Salve e feche o arquivo xml.
-
Reinicie o QuickStart e faça logon com suas credenciais.
Suporte a diferentes métodos de autenticação do servidor SharePoint supporting-different-authentication-methods-of-the-sharepoint-server
Em sua versão padrão, o conector é compatível com o IIS padrão Windows autenticação (Básica) e autenticação baseada em Forms (baseada em token). O outros métodos de autenticação O pode ser suportado pelo mecanismo de extensibilidade.
As etapas a seguir fornecem diretrizes sobre a extensão da autenticação padrão para suportar vários métodos de autenticação do servidor SharePoint:
-
Implementar
com.day.crx.spi.sharepoint.security.SharepointConnectionFactory
para lidar com o lado do cliente do seu processo de autenticação específico. -
Instale o
SharepointConnectionFactory
implementação como um pacote de fragmentos com o host de fragmentocom.day.crx.spi.crx2sharepoint-bundle
.Ao usar Maven, adapte a seguinte configuração do
maven-bundle-plugin
de acordo com os requisitos do seu projeto:code language-xml <plugin> <groupId>org.apache.felix</groupId> <artifactId>maven-bundle-plugin</artifactId> <extensions>true</extensions> <configuration> <instructions> <Export-Package /> <Private-Package> <!-- your private package here --> </Private-Package> <Fragment-Host> com.day.crx.spi.crx2sharepoint-bundle </Fragment-Host> </instructions> </configuration> </plugin>
-
Registre o
SharepointConnectionFactory
implementação na configuração do conector. Na janela de configuração do conector, clique em Opções avançadas. No para Fábrica do Sharepoint Connection , especifique o nome da implementaçãocom.day.crx.spi.sharepoint.auth.CustomConnectionFactory
. -
Reinicie o conector.