Ir para o conteúdo

Pré-requisitos do OAuth 2.0 de 3 pernas (3LO) para o conector Jira no Jitterbit Integration Studio

Introdução

Esta página cobre os pré-requisitos e os passos para configurar o conector Jira para usar a autenticação OAuth 2.0 de 3 pernas (3LO) com um aplicativo privado configurado na página Registro de Aplicativos do Console de Gerenciamento.

Aplicativos privados são aplicativos OAuth de 3 pernas que você configura para a instância Jira e, em seguida, registra na página Registro de Aplicativos do Console de Gerenciamento com os seguintes valores do aplicativo OAuth de 3 pernas:

  • ID do Cliente e segredo do cliente
  • Escopos
  • URL de Autorização
  • URL do token de acesso
  • URL do token de atualização

Nota

Ao usar o aplicativo em nuvem (Jitterbit App), um registro de aplicativo não é necessário.

Configurar o aplicativo OAuth do Jira

Antes de registrar um aplicativo OAuth no Console de Gerenciamento Registro de Aplicativos, você deve criar o aplicativo OAuth para a instância Jira.

Para informações sobre como configurar um aplicativo OAuth de 3 pernas, consulte a documentação a seguir (dependendo do tipo da sua instância):

Callback URL

Ao configurar seu aplicativo OAuth no Jira, certifique-se de que a Callback URL esteja definida como uma das seguintes URLs (dependendo da região da sua organização):

Região URL
APAC https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcode
EMEA https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
NA https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode

Roles

No mínimo, esses papéis devem ser atribuídos ao aplicativo OAuth para permitir acesso a todas as atividades do conector:

  • manage:jira-configuration
  • read:jira-user
  • read:jira-work
  • read:permission:jira
  • write:jira-work

Além dos papéis acima, instâncias do Jira Server e do Jira Data Center requerem o papel offline_access.

Instructions

Estas são as instruções para obter os valores necessários para o registro do aplicativo:

  1. Configure um aplicativo OAuth de 3 etapas para a instância do Jira.

  2. Navegue até seu aplicativo 3LO na página Meus Aplicativos do Console de Desenvolvedor do Jira.

  3. Para obter o Client ID e o Client Secret do registro do aplicativo, navegue até Detalhes de Autenticação em Configurações e obtenha os valores de Client ID e Secret.

  4. Para obter o Scope do registro do aplicativo, navegue até a página Permissões e obtenha os escopos usados para o aplicativo. Na configuração do registro do aplicativo, insira cada um dos escopos do aplicativo 3LO em seu formato de código, por exemplo, read:me.

  5. Para obter a Authentication URL do registro do aplicativo, navegue até URL de autorização da API de identidade do usuário na página Autorização sob Gerador de URL de Autorização.

  6. Defina a URL do token de acesso do registro do aplicativo como https://auth.atlassian.com/oauth/token.

  7. Defina a URL do token de atualização do registro do aplicativo como https://auth.atlassian.com/oauth/token.

Uma vez que a aplicação OAuth de 3 etapas esteja registrada na página de Registros de Aplicativos, ela estará disponível para seleção no menu Aplicativo OAuth sob Aplicações Privadas na conexão Jira.