Ir para o conteúdo

Pré-requisitos do Jira OAuth 2.0 de Três Pernas

Introdução

Esta página aborda os pré-requisitos e as etapas para configurar o conector Jira para usar a autenticação OAuth 2.0 (3LO) de três etapas com um aplicativo privado configurado no Management Console Registros de aplicativos página.

Aplicativos privados são aplicativos OAuth de três etapas que você configura para a instância do Jira e depois registra no Management Console Registros de aplicativos com estes valores do aplicativo OAuth de três etapas:

  • ID do cliente e segredo do cliente
  • Escopos
  • URL de autorização
  • URL do token de acesso
  • Atualizar URL do token

Nota

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

Configurar o Aplicativo Jira OAuth

Antes de registrar um aplicativo OAuth no Management Console App Registrations, você deverá criar o aplicativo OAuth para a instância do Jira.

Para obter informações sobre como configurar um aplicativo OAuth de três etapas, consulte a documentação a seguir (dependendo do tipo de instância):

URL de Retorno de Chamada

Ao configurar seu aplicativo OAuth no Jira, certifique-se de que Callback URL esteja definido como um dos seguintes URLs (dependendo da sua região da 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

Funções

No mínimo, estas funções devem ser atribuídas 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 das funções acima, as instâncias do Jira Server e do Jira Data Center exigem o offline_access papel.

Instruções

Estas são as instruções para obtenção dos valores necessários para o cadastro do aplicativo:

  1. Configurar um aplicativo OAuth de três etapas para a instância do Jira.

  2. Navegue até seu aplicativo 3LO em Jira aplicativos página.

  3. Para obter o ID do cliente e o Segredo do cliente do registro do aplicativo, navegue até Detalhes de autenticação em Configurações e obtenha o ID do cliente e o Segredo valores.

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

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

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

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

Depois que o aplicativo OAuth de três etapas for registrado em Registros de aplicativos, ele está disponível para seleção no menu Aplicativo OAuth em Aplicativos privados na seção Conexão Jira.