OAuth 2.0 de três pernas do conector no Jitterbit Studio
Visão geral
A autenticação de uma conexão com OAuth 2.0 de três pernas (3LO) está disponível para determinados conectores do Studio ao usar a versão do agente 10.83 / 11.21 ou posterior. O 3LO permite que os conectores compatíveis acessem recursos em nome de um usuário (sem acessar as credenciais do usuário diretamente) através do uso de um aplicativo em nuvem ou um aplicativo privado.
Aplicativos em nuvem são aplicativos OAuth de três pernas fornecidos pelo Jitterbit.
Aplicativos privados são aplicativos OAuth de três pernas que você configura e possui no endpoint e depois registra na página Registros de aplicativo do Console de gerenciamento com estes valores do aplicativo OAuth de três pernas:
- ID do cliente e segredo do cliente
- Escopos
- URL de autorização
- URL do token de acesso
- URL do token de atualização
Após o aplicativo OAuth de três pernas ser registrado na página Registros de aplicativo, fica disponível para seleção no menu Aplicativo OAuth em Aplicativos privados na configuração de conexão. Para informações sobre como configurar uma conexão 3LO, consulte a documentação individual do conector.
Conectores compatíveis com 3LO
Atualmente, estes conectores suportam autenticação com OAuth 2.0 de três pernas:
- BMC Helix ITSM
- Gmail
- Google Docs
- Google Drive
- Google Sheets
- HTTP v2
- Jira
- Cliente MCP
- Shopify
- Slack
- Snowflake
- ZoomInfo
Arquitetura do sistema
Estas etapas detalham como uma conexão 3LO é processada dentro da arquitetura do sistema ao autenticar um conector compatível usando um registro de aplicativo OAuth 2.0:
-
Ao conectar-se ao endpoint, o usuário é direcionado para a URL de autorização do provedor OAuth.
-
Na URL de autorização, solicita-se que o usuário verifique as credenciais e consinta com a solicitação de autorização do Harmony.
-
Uma vez que a solicitação é autorizada com sucesso, o provedor OAuth emite um código de autorização para o Harmony.
-
O Harmony troca o código de autorização por um token de acesso do provedor OAuth.
-
O Harmony usa o token de acesso para recuperar o recurso necessário da API do conector.
Notas importantes
Observe o seguinte ao usar a autenticação OAuth de três pernas:
- Endpoints globais: A autenticação com OAuth de três pernas não é suportada para endpoints globais.
- Invalidação do token de acesso: A implementação 3LO do Jitterbit não suporta provedores que invalidam todos os tokens de acesso emitidos anteriormente quando um novo token de acesso é emitido (por exemplo, via atualização). Apenas um token de acesso pode ser válido por token de atualização em qualquer momento.
- Expiração por inatividade do token de atualização: Alguns provedores (por exemplo, Microsoft) expiram um token de atualização após um período de inatividade, como 90 dias sem uso. Chamar o endpoint do token de atualização em uma programação para redefinir o relógio de inatividade e evitar expiração não é suportado pela implementação 3LO do Jitterbit. Tokens de atualização são usados apenas quando uma operação requer acesso ao endpoint.
- Transferência de projeto: Cada endpoint seleciona seu próprio aplicativo OAuth (registro de aplicativo), portanto o mesmo projeto pode usar um aplicativo OAuth diferente em cada ambiente (por exemplo, um para desenvolvimento e outro para produção). Ao transferir componentes para outro ambiente, o aplicativo OAuth usado por um endpoint no ambiente de destino é preservado, a menos que você selecione Transferir aplicativo para o endpoint.
Gerenciar endpoints
Depois que a conexão foi configurada, você pode usar a página Projetos do Management Console para visualizar endpoints implantados para os quais o OAuth de 3 etapas foi configurado para um projeto (consulte a aba Endpoints).