Guia de conexão OAuth do Microsoft SharePoint para Jitterbit App Builder

Pré-requisitos

• Você deve ter uma conta do Microsoft Azure.

Criar um provedor de segurança OAuth

Crie um provedor de segurança OAuth no App Builder antes de configurar o registro do aplicativo Azure.

1. Vá para IDE > Provedores de Segurança.

2. Clique em + Autenticação de Fonte de Dados. A página Provedor é aberta. Forneça os seguintes detalhes:

   • Em Configurações:

     • Nome: Identifica o provedor de segurança e aparece na URL. Exemplo: OAuth
     • Tipo: OAuth
     • Habilitado: Selecione para habilitar este provedor de segurança.

   • Em Autenticação:

     • Concessão OAuth: Código de Autorização
     • Autenticação do Cliente OAuth: Básica
     • Autenticação de Recurso OAuth: Bearer

   • Em Entrar:

     • Redirecionar em Desafio: Verdadeiro

3. Clique em Salvar.

Criar registro de aplicativo Microsoft Azure

Registre um aplicativo no Microsoft Azure para obter as credenciais necessárias para concluir a configuração do provedor de segurança OAuth. Para uma visão geral do processo de registro, consulte o guia Introdução Rápida: Registrar um aplicativo da Microsoft.

1. Vá para o portal do Azure e faça login.

2. Clique em Microsoft Entra ID.

3. Navegue até Registros de aplicativos e clique em Novo registro.

4. Insira um Nome do Aplicativo. Exemplo: OAuth

5. Em URI de Redirecionamento (opcional):

   • Selecione Web na lista de plataformas.
   • Insira a URI para o provedor de segurança: https://<App-Builder-Instance>/signin-<Security-Provider-Name>

6. Clique em Registrar.

7. Clique em Permissões de API, depois clique em Adicionar uma permissão.

8. Clique no bloco SharePoint e selecione Permissões Delegadas.

9. Expanda AllSites e habilite as seguintes permissões:

   • AllSites Gerenciar
   • AllSites Ler
   • AllSites Escrever

10. Expanda Projeto e habilite ProjectRead e ProjectWrite.

11. Clique em Adicionar permissões.

12. Clique em Visão geral. Anote os seguintes valores — você precisará deles ao configurar o App Builder:

    • ID do diretório (inquilino): Usado nas URLs de autorização e de endpoint de token.
    • ID do aplicativo (cliente): Usado como nome de usuário da credencial.

    Para ajuda na localização desses valores, veja Como encontrar o ID do inquilino do Microsoft Entra.

13. Em Credenciais do cliente, clique em Adicionar um certificado ou segredo.

14. Clique em + Novo segredo do cliente, insira uma Descrição, selecione uma data de expiração e clique em Adicionar.

15. Copie o Valor do segredo do cliente imediatamente — ele é exibido apenas uma vez e é necessário como a senha da credencial no App Builder.

16. Retorne ao App Builder e abra o provedor de segurança criado anteriormente.

17. No painel Endpoints, clique em + Endpoints e configure o seguinte, substituindo seu ID do diretório (inquilino):

    • Endpoint de Autorização: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Endpoint de Token: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/

18. Clique em + Credencial e forneça o seguinte:

    • Tipo: Cliente
    • Nome de Usuário: ID do aplicativo (cliente) do Azure
    • Senha: Valor do segredo do cliente do Azure

19. Clique em Salvar.

20. No painel Propriedades, clique em + Propriedade e insira o seguinte no campo Valor:

    https://<companyname>.sharepoint.com/.default offline_access

21. Clique em Salvar.

Criar uma fonte de dados do Microsoft SharePoint

1. Vá para IDE > Servidores de Dados.

2. No painel Servidores de Dados, clique em + Servidor. A caixa de diálogo Servidor é aberta. Insira as seguintes informações:

   • Nome do Servidor: Insira um nome. Exemplo: SharePoint
   • Tipo: Microsoft SharePoint
   • Url: Caminho completo para o diretório SharePoint da empresa. Exemplo: https://<companyname>.sharepoint.com/sites/<directory>

3. Expanda Configurações de Segurança e selecione o provedor de segurança OAuth na lista Provedor de Segurança.

4. Clique em Salvar.

5. No painel Servidores de Dados, selecione o servidor que você acabou de criar. Um bloco aparece no painel da direita. Clique duas vezes no bloco ou clique no ícone para ver opções avançadas.

6. Em Camada de Armazenamento de Dados, clique em Importar e complete o fluxo OAuth quando solicitado. A caixa de diálogo Importar Esquema é aberta.

7. Clique na aba Visualizações, localize o esquema a ser importado (por exemplo, Listas), e então clique em Importar Esquema.

8. Saia da caixa de diálogo Importar Esquema.

9. Em Camada de Lógica de Negócios, clique em Lógica. A página Regras por Tabela é aberta.

10. No painel Tabelas, localize o esquema que você importou. Clique no ícone Resultados para confirmar os dados.