Jira on-premise com autorização de terceiros usando OAuth 2.0: referência

Quem pode fazer isso: Admins da empresa
Quais planos: Enterprise

Este artigo fornece detalhes técnicos sobre o uso de um servidor de autorização de terceiros com OAuth 2.0 para integrar o Jira à Miro. 

Para saber como configurar a conexão, consulte Conectar ao Jira local com servidores de autorização de terceiros usando OAuth 2.0.

Como a integração do Jira com a Miro usando autorização local e OAuth 2.0 funciona

O gráfico a seguir mostra o fluxo de comunicação entre a Miro e um servidor de autorização local do Jira.

Integração entre Miro e Jira usando um servidor de autorização on-premise por meio de um gateway de API

Parâmetros de configuração

Para configurar o fluxo de autorização entre a Miro e o Jira usando um servidor de autorização de terceiros com OAuth 2.0, é necessário especificar os seguintes parâmetros:

• Servidor de autorização
  • URL de solicitação de autorização
  • URL de solicitação de token
  • Escopo
• Configuração do aplicativo de autorização
  • ID do cliente
  • Segredo do cliente
• Instância do Jira
  • URL público do Jira
  • URL base do Jira; URL interno

✏️ A Miro fornece a URL de redirecionamento que o servidor de autorização valida em relação ao aplicativo registrado.

Mais informações: Veja Conectar o Jira on-premise a servidores de autorização de terceiros usando OAuth 2.0.

Solicitações de autorização do usuário entre a Miro e o servidor de autorização on-premise

Para uma integração entre a Miro e o Jira usando um servidor de autorização de terceiros, o gráfico a seguir mostra o fluxo de solicitação de autorização do usuário.

Solicitação de autorização do usuário

Solicitação de autorização

https://{authorization_URL}?
    response_type=code&
    client_id={CLIENT_ID}&
    redirect_uri={Miro Redirect URI}&
    scope={scope}&     
    state={state}

O usuário pode adicionar parâmetros à solicitação de autorização como pares chave-valor na configuração.

Solicitação de token

curl --request POST \
    --url '{token request URL}' \
    --header 'content-type: application/x-www-form-urlencoded' \
    --data grant_type=authorization_code \
    --data 'client_id={CLIENT_ID}' \
    --data 'client_secret={CLIENT_SECRET}' \
    --data 'code={Obtained Authorization Code}' \
    --data 'redirect_uri={Miro Redirect URI}' \

Depois que a Miro recebe o código de autorização, fornece o status e solicita um par de tokens.

Troca de tokens de atualização

curl --request POST \
    --url '{token request URL}' \   
    --header 'content-type: application/x-www-form-urlencoded' \
    --data grant_type=refresh_token \
    --data 'client_id={CLIENT_ID}' \
    --data 'refresh_token={current valid refresh token}' \

Certifique-se de que a operação de refresh token esteja ativada; ative o acesso offline às APIs.

Chamadas de API do Jira

curl --request GET \
    --url {Jira Public URL}/rest/api/{apiversion}/... \
    --header 'authorization: Bearer {accessToken}' \
    --header 'content-type: application/json'

Cada requisição usa a URL pública do Jira fornecida como URL base e o token de acesso do usuário como token Bearer.