Show Menu
TÓPICOS×

Conector do SharePoint

Conector Day JCR para Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versão 4.0.
Este artigo inclui detalhes sobre o Adobe JCR Connector para Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versão 4.0.
O conector SharePoint suporta as seguintes funcionalidades básicas:
  • Lendo conteúdo e metadados do SharePoint.
  • Confirmando as configurações de segurança do SharePoint para conteúdo acessado aplicando autenticação e autorização nativas do SharePoint
  • Integração de conteúdo usando o Content Finder
  • Uso de componentes AEM, como Recurso externo para exibir imagens e vídeos do SharePoint
  • Sincronizar o SharePoint com ativos AEM
Todas as funcionalidades são implementadas usando os serviços Web nativos do SharePoint como interface para conteúdo e serviços do SharePoint.
O SharePoint Connector também é compatível com o AEM 6.1 Service Pack 2. O conector não suporta mais a montagem do repositório virtual e, portanto, não pode ser montado. Se desejar 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 no SharePoint para obter informações sobre esses tópicos. O conector exige que essas partes da infraestrutura sejam instaladas, configuradas e operadas corretamente.

Introdução

Para começar a usar o conector, faça o seguinte:
  • Verifique se você tem pelo menos o Java 7 instalado.
  • Baixe o arquivo de distribuição do pacote do conector do Compartilhamento de pacotes.
  • Copie um arquivo license.properties válido para o diretório que contém o arquivo cq-quickstart-6.4.0.jar .
  • Clique/toque duas vezes no arquivo .jar para iniciar o AEM ou inicie-o na linha de comando.
  • Instale o pacote do conector do Gerenciador de pacotes.
  • Configure as opções do conector.

Instalação do conector do SharePoint

O conector é um pacote de conteúdo que facilita a instalação. Instale o pacote usando o Package Manager e defina o URL do servidor SharePoint e outras opções de configuração. O conteúdo do SharePoint está disponível no repositório do AEM.

Requisitos de instalação

O conector exige o seguinte:
  • Java Runtime Environment 1.7 ou posterior
  • Serviços Web do SharePoint disponíveis através da rede
  • URL do servidor SharePoint
  • Credenciais e permissões do usuário para repositórios CRX e SharePoint
O conector do SharePoint está disponível para download a partir do compartilhamento de pacotes .

Plataformas compatíveis

O conector suporta o seguinte:
  • Versões do AEM:
    • AEM 6.4, 6.3
  • Versões do Microsoft SharePoint:
    • Microsoft Office SharePoint Server (MOSS) 2010
    • Microsoft Office SharePoint Server (MOSS) 2013
  • Se precisar de suporte para implantações personalizadas do conector (OEM, requisitos especiais, métodos de autenticação personalizados), entre em contato com o escritório da Adobe da sua região.
O conector só suporta configurações oficialmente suportadas pela Microsoft. Consulte os requisitos de sistema MOSS 2010 e MOSS 2013 .

Instalação padrão

O Compartilhamento de pacotes AEM é usado para distribuir recursos de produtos, exemplos e hot fixes. Para obter detalhes, consulte a documentação Compartilhamento de pacotes.
Para acessar o Compartilhamento de pacotes na página de boas-vindas do AEM, toque/clique em Ferramentas e selecione Compartilhamento de pacotes . Você precisa de uma ID da Adobe válida que inclua o endereço de email da sua empresa. Além disso, depois de fazer logon em sua conta, solicite acesso ao Compartilhamento de pacotes.

Integração com o AEM

Para instalar o pacote de conteúdo do conector.
  1. Abra um ticket de suporte da 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 em Instalar na página de descrição do pacote.
  4. Na caixa de diálogo Instalar pacote , toque/clique em Instalar .
    Observação : Verifique se você está conectado como administrador.
  5. Quando o pacote estiver instalado, toque/clique em Fechar .

Configuração do conector do SharePoint

Depois de instalar o conector SharePoint, configure o aplicativo e as camadas do SharePoint para o conector.
Defina o URL do servidor SharePoint para tornar o repositório do SharePoint compatível com o JCR. Você pode definir parâmetros adicionais para configurar a conexão com o servidor SharePoint. Além disso, configure a autenticação com o conector do SharePoint.

Configurar a conexão com o servidor SharePoint

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 o conjunto Day JCR Connector for Microsoft Sharepoint .
  3. Edite os valores de configuração.
  4. Defina o URL do SharePoint Server como o valor de Espaços de Trabalho .
  5. Tap/click Save .
Parâmetros de 'Espaços de trabalho' e 'Nome padrão do espaço de trabalho':
Por padrão, o conector expõe uma única área de trabalho JCR. O servidor SharePoint exposto por esta área de trabalho é definido pelo parâmetro de configuração 'URL do SharePoint Server'.
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 SharePoint exposto pela área 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. Coloque em uma lista de permissões o pacote ' com.day.cq.dam.cq-dam-jcr-connectors '.
Para adicionar pacotes de lista de permissões no AEM, execute as seguintes etapas:
  1. Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr.
  2. Procure o 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 conjuntos de listas brancas padrão
  5. Clique em Salvar.
Se você configurar vários espaços de trabalho, especifique o nome do espaço de trabalho padrão no parâmetro Nome padrão do espaço de trabalho.
Para obter informações adicionais sobre parâmetros relacionados à autenticação, consulte Autenticação .

Verificação da configuração do Sharepoint

Depois de configurar o conector, verifique o seguinte:
  • O SharePoint Server é executado e os serviços da Web estão acessíveis para a instância do conector
  • As credenciais de 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 SharePoint

Para sincronizar os ativos do SharePoint com o AEM, execute as seguintes etapas:
  1. Navegue até o Console de Gerenciamento OSGi: http://localhost:4502/system/console/configMgr .
  2. Procure o 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 que tem acesso ao site do SharePoint.
  5. Clique em Salvar.
Ative o serviço de sincronização DAM, que é desativado por padrão:
  1. Navegue até Componentes do console da Web OSGi: http://localhost:4502/system/console/components
  2. Procure "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 "DAY CQ DAM JCR Connector Asset Synchronization Service" (Serviço de sincronização de ativos do conector JCR DAM DAY CQ).
  3. Edite os valores de configuração.
  4. Defina o valor do Período de sincronização (em segundos).
  5. Clique em Salvar.

Configuração da autenticação

O Sharepoint inclui os métodos de autenticação Classic e Claims Based, que são compatíveis com os seguintes tipos de autenticação:
  • Básico
  • Baseado em formulários
Em particular, estão disponíveis os seguintes tipos de autenticação:
  • Classic-Basic
  • Baseado em formulários clássicos
  • Claims-Basic
  • Baseado em Formulários de solicitação
O AEM JCR Connector para Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versão 4.0. suporta autenticação baseada em afirmaçõ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 alterna para autenticação baseada em NTLM.
  • Autenticação baseada em formulários: 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.
Configuração da autenticação baseada em formulários
  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 "Sharepoint Connection Fatory" como "com.day.crx.spi.share.security.FormsBasedAuthenticationConnectionFactory"
  5. Clique em Salvar
Configuração da autenticação básica (Windows)
  1. Clique em OSGI > Configuração.
  2. Procure Day JCR Connector for Microsoft Sharepoint .
  3. Clique em Edit the configuration values .
  4. Defina o valor de Sharepoint Connection Fatory como com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory .
  5. Clique em Salvar .
Somente um usuário autenticado no AEM e no SharePoint pode acessar o conteúdo do SharePoint pelo 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 do AEM a usuários específicos do SharePoint. Crie usuários do AEM correspondentes a usuários do SharePoint (o nome de usuário e a senha devem corresponder) para que possam 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 (o nome do usuário tem acesso ao 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 ao grupo de administradores:
  1. Ir para Administração de grupo
  2. Clique no nó "a"
  3. Clique em "administradores"
  4. Digite a ID do usuário criada acima na caixa de texto antes do botão Procurar
  5. Clique no símbolo de marca de verificação verde para adicionar o usuário ao grupo administrativo

Desativar autenticação de token

  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. Localizar a tag <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
  5. Insira 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

Na versão padrão, o conector suporta a autenticação padrão do IIS Windows (Básica) e a autenticação baseada em formulários (baseada em token). Os outros métodos de autenticação podem ser suportados pelo mecanismo de extensibilidade.
As etapas a seguir fornecem orientações sobre a extensão da autenticação padrão para suportar vários métodos de autenticação do servidor SharePoint:
  1. Implemente com.day.crx.spi.sharepoint.security.SharepointConnectionFactory para lidar com o lado do cliente do processo de autenticação específico.
  2. Instale a SharepointConnectionFactory implementação como um pacote de fragmentos com o host do fragmento com.day.crx.spi.crx2sharepoint-bundle .
    Ao usar o Maven, adapte a seguinte configuração do maven-bundle-plugin para os requisitos do seu projeto:
               <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 a SharepointConnectionFactory implementação na configuração do conector. Na janela de configuração do conector, clique em Opções ​avançadas. No campo For Sharepoint Connection Fatory , especifique o nome da implementação com.day.crx.spi.sharepoint.auth.CustomConnectionFactory .
  4. Reinicie o conector.