Conector SharePoint sharepoint-connector

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

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.

NOTE
O SharePoint Connector também é compatível com o AEM 6.1 service pack 2. O conector não oferece mais suporte à montagem do repositório virtual e, portanto, não pode ser montado. Se quiser acessar o repositório do Sharepoint usando APIs Java, use a implementação do repositório JCR do conector do Sharepoint no seu projeto.
As operações de instalação, configuração, gerenciamento e TI do servidor SharePoint e da infraestrutura de TI relacionada estão fora do escopo deste documento. Consulte a documentação do fornecedor em SharePoint para obter informações sobre esses tópicos. O conector requer que essas partes da infraestrutura sejam corretamente instaladas, configuradas e operadas.

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.

NOTE
O conector só suporta configurações oficialmente compatíveis com o Microsoft. Consulte MOSS 2010 e MOSS 2013 requisitos do sistema.

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.

  1. Abra um tíquete de suporte do Adobe para solicitar o pacote de recursos do conector.

  2. Baixe o pacote quando ele estiver disponível e abra o Gerenciador de pacotes para sua instância do AEM.

  3. Toque/clique Instalar na página de descrição do pacote.

  4. No Instalar pacote , toque/clique Instalar.

    Observação: Certifique-se de estar conectado como administrador.

  5. 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:

  1. Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.
  2. Procure a variável Conector JCR do dia para Microsoft Sharepoint pacote.
  3. Edite os valores de configuração.
  4. Defina o URL do servidor do SharePoint como o valor de Áreas de trabalho.
  5. Toque/clique Salvar.

chlimage_1-81

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:

  1. Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.

  2. Procure por serviço "Apache Sling Login Admin Whitelist".

  3. Selecione Ignorar a lista de permissões.

  4. Adicionar 'com.day.cq.dam.cq-dam-jcr-connectors' em pacotes de lista de permissões padrão

  5. Clique em Salvar.

chlimage_1-82

NOTE
Se você configurar vários espaços de trabalho, especifique o nome do espaço de trabalho padrão no parâmetro Nome do espaço de trabalho padrão .

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:

  1. Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.
  2. Procure pelo serviço "Default DAMAssetSynchronization".
  3. Edite os valores de configuração.
  4. Defina o nome de usuário e a Senha correspondente do usuário com acesso no site do SharePoint.
  5. Clique em Salvar.

Ative o Serviço de sincronização DAM, que é desativado por padrão:

  1. Navegue até os Componentes do console da Web OSGi: http://localhost:4502/system/console/components
  2. Procure por "com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService".
  3. Clique em Ativar.

Como opção, você pode configurar o atraso de sincronização entre diferentes ciclos de sincronização:

  1. Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr
  2. Procure por "DAY CQ DAM JCR Connector Asset Synchronization Service".
  3. Edite os valores de configuração.
  4. Defina o valor do Período de sincronização (em segundos).
  5. 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

  1. Clique em OSGI -> Configuração
  2. Pesquise "Conector Day JCR para Microsoft Sharepoint"
  3. Clique em "Editar os valores de configuração"
  4. Defina o valor de "Fábrica de Conexão do Sharepoint" como "com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory"
  5. Clique em Salvar

Configurando a Autenticação Básica (Windows)

  1. Desativar Autenticação de Token.
  2. Ir para http://localhost:4502/system/console/bundles.
  3. Clique em OSGI > Configuração.
  4. Procurar por Conector JCR do dia para Microsoft Sharepoint.
  5. Clique em Edit the configuration values.
  6. Defina o valor da Fábrica de Conexões do Sharepoint como com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory.
  7. 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:

  1. Faça logon em http://localhost:9502/with o usuário administrador.
  2. Clique em Ferramentas.
  3. Clique em Segurança.
  4. Clique em Usuários.
  5. Clique em Criar usuário
  6. Forneça a ID do usuário (nome de usuário com acesso no SharePoint)
  7. Forneça a senha correspondente
  8. Clique no símbolo de marca de verificação verde para criar o usuário

Para adicionar o usuário no grupo de administradores:

  1. Ir para Administração de Grupo
  2. Clique no nó "a"
  3. Clique em "administradores"
  4. Digite a ID de usuário criada acima na caixa de texto antes de Procurar botão
  5. 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

  1. Baixe e instale o pacote basic auth. zip do Compartilhamento de pacotes.

  2. Feche o Início Rápido.

  3. Abra o arquivo \crx-quickstart\repository\repository.xml.

  4. Encontre a tag <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.

  5. Inserir a tag <param name="disableTokenAuth" value="true"/> dentro da tag mencionada na etapa 4.

  6. Salve e feche o arquivo xml.

  7. 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:

  1. Implementar com.day.crx.spi.sharepoint.security.SharepointConnectionFactory para lidar com o lado do cliente do seu processo de autenticação específico.

  2. Instale o SharepointConnectionFactory implementação como um pacote de fragmentos com o host de fragmento com.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>
    
  3. 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ção com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

  4. Reinicie o conector.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8