Ir para o conteúdo

Pré-requisitos do Jira 3-legged OAuth 2.0

Introdução

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

Os aplicativos privados são aplicativos OAuth de três pernas que você configura para a instância do Jira e depois registra no Management Console Registros de aplicativos página com esses 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), o registro do aplicativo não é necessário.

Configurar o Aplicativo Jira OAuth

Antes de registrar um aplicativo OAuth no Management Console Registros de aplicativos, você deve 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 seguinte documentação (dependendo do tipo de instância):

URL de Retorno de Chamada

Ao configurar seu aplicativo OAuth no Jira, certifique-se de que o URL de retorno de chamada esteja definido como um dos seguintes URLs (dependendo da região da sua organização):

Região URL
Ásia-Pacífico 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, essas 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 obter os valores necessários para o registro do aplicativo:

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

  2. Navegue até seu aplicativo 3LO em Meus aplicativos do Jira Developer Console) página.

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

  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 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 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.

Uma vez que o aplicativo OAuth de 3 pernas é registrado em App Registrations página está disponível para ser selecionada no menu Aplicativo OAuth em Aplicativos Privados na conexão Jira.