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.
-
Acesse IDE > Security Providers.
-
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.
- Name: Identifica o provedor de segurança e aparece na URL. Exemplo:
-
Em Authentication:
- OAuth Grant: Authorization Code
- OAuth Client Authentication: Basic
- OAuth Resource Authentication: Bearer
-
Em Sign In:
- Redirect on Challenge: True
-
-
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.
-
Acesse o portal do Azure e faça login.
-
Clique em Microsoft Entra ID.
-
Navegue até App registrations e clique em New registration.
-
Digite um App Name. Exemplo:
OAuth -
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>
-
Clique em Register.
-
Clique em API permissions e depois em Add a permission.
-
Clique no bloco SharePoint e selecione Delegated permissions.
-
Expanda AllSites e ative as seguintes permissões:
- AllSites Manage
- AllSites Read
- AllSites Write
-
Expanda Project e ative ProjectRead e ProjectWrite.
-
Clique em Add permissions.
-
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.
-
Em Client credentials, clique em Add a certificate or secret.
-
Clique em + New client secret, digite uma Description, selecione uma data de expiração e clique em Add.
-
Copie imediatamente o Value do segredo do cliente — ele é mostrado apenas uma vez e é necessário como senha da credencial no App Builder.
-
Retorne ao App Builder e abra o provedor de segurança criado anteriormente.
-
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/
- Authorization Endpoint:
-
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
-
Clique em Save.
-
No painel Properties, clique em + Property e digite o seguinte no campo Value:
https://<companyname>.sharepoint.com/.default offline_access -
Clique em Save.
Criar uma fonte de dados do Microsoft SharePoint
-
Acesse IDE > Data Servers.
-
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>
- Server Name: Digite um nome. Exemplo:
-
Expanda Security Settings e selecione o provedor de segurança OAuth na lista Security Provider.
-
Clique em Save.
-
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.
-
Em Data Storage Layer, clique em Import e conclua o fluxo OAuth quando solicitado. A caixa de diálogo Import Schema abre.
-
Clique na aba Views, localize o schema a importar (por exemplo,
Lists) e clique em Import Schema. -
Feche a caixa de diálogo Import Schema.
-
Em Business Logic Layer, clique em Logic. A página Rules by Table abre.
-
No painel Tables, localize o schema que importou. Clique no ícone Results para confirmar os dados.