Ir para o conteúdo

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

Pré-requisitos

  • É necessário 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 da aplicação do Azure.

  1. Acesse IDE > Security Providers.

  2. Clique em + Security Provider. A página Provider abre. Forneça os seguintes detalhes:

    • Em Settings:

      • Name: Identifica o provedor de segurança e aparece na URL. Exemplo: OAuth
      • Type: OAuth
      • Enabled: Selecione para ativar este provedor de segurança.
    • Em Authentication:

      • OAuth Grant: Authorization Code
      • OAuth Client Authentication: Basic
      • OAuth Resource Authentication: Bearer
    • Em Sign In:

      • Redirect on Challenge: True
  3. Clique em Save.

Criar registro de aplicação do Microsoft Azure

Registre uma aplicação 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 Quickstart: Register an application do Microsoft.

  1. Acesse o portal do Azure e faça login.

  2. Clique em Microsoft Entra ID.

  3. Navegue até App registrations e clique em New registration.

  4. Digite um App Name. Exemplo: OAuth

  5. Em Redirect URI (optional):

    • Selecione Web na lista de plataformas.
    • Digite a URI do provedor de segurança: https://<App-Builder-Instance>/signin-<Security-Provider-Name>
  6. Clique em Register.

  7. Clique em API permissions e depois em Add a permission.

  8. Clique no bloco SharePoint e selecione Delegated permissions.

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

    • AllSites Manage
    • AllSites Read
    • AllSites Write
  10. Expanda Project e ative ProjectRead e ProjectWrite.

  11. Clique em Add permissions.

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

    • Directory (tenant) ID: Usado nas URLs de autorização e endpoint de token.
    • Application (client) ID: Usado como nome de usuário da credencial.

    Para obter ajuda ao localizar esses valores, consulte How to find your Microsoft Entra tenant ID.

  13. Em Client credentials, clique em Add a certificate or secret.

  14. Clique em + New client secret, digite uma Description, selecione uma data de expiração e clique em Add.

  15. Copie imediatamente o Value do segredo do cliente — ele é mostrado apenas uma vez e é necessário como 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 Directory (tenant) ID:

    • Authorization Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Token Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/
  18. Clique em + Credential e forneça o seguinte:

    • Type: Client
    • User Name: Application (client) ID do Azure
    • Password: Valor do segredo do cliente do Azure
  19. Clique em Save.

  20. No painel Properties, clique em + Property e digite o seguinte no campo Value:

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

  21. Clique em Save.

Criar uma fonte de dados do Microsoft SharePoint

  1. Acesse IDE > Data Servers.

  2. No painel Data Servers, clique em + Server. O diálogo Server abre. Digite as seguintes informações:

    • Server Name: Digite um nome. Exemplo: SharePoint
    • Type: Microsoft SharePoint
    • Url: Caminho completo para o diretório do SharePoint da empresa. Exemplo: https://<companyname>.sharepoint.com/sites/<directory>
  3. Expanda Security Settings e selecione o provedor de segurança OAuth na lista Security Provider.

  4. Clique em Save.

  5. No painel Data Servers, selecione o servidor que acabou de criar. Um card aparece no painel direito. Clique duas vezes no card ou clique no ícone para ver as opções avançadas.

  6. Em Data Storage Layer, clique em Import e conclua o fluxo OAuth quando solicitado. A caixa de diálogo Import Schema abre.

  7. Clique na aba Views, localize o schema a importar (por exemplo, Lists) e clique em Import Schema.

  8. Feche a caixa de diálogo Import Schema.

  9. Em Business Logic Layer, clique em Logic. A página Rules by Table abre.

  10. No painel Tables, localize o schema que importou. Clique no ícone Results para confirmar os dados.