Jira in situ con autorización de terceros mediante OAuth 2.0 — referencia

Quién puede hacerlo: administradores de la empresa
Qué planes: plan Enterprise

Este artículo ofrece detalles técnicos para usar un servidor de autorización de terceros con OAuth 2.0 para integrar Jira con Miro. 

Para saber cómo configurar una conexión, consulta Conectar a Jira on-premise con servidores de autorización de terceros mediante OAuth 2.0.

Cómo funciona la integración de Jira con Miro usando autorización on-premise y OAuth 2.0

El siguiente gráfico muestra el flujo de comunicación entre Miro y un servidor de autorización de Jira on-premise.

Integración de Miro y Jira mediante un servidor de autorización local a través de una puerta de enlace API

Parámetros de configuración

Para configurar el flujo de autorización entre Miro y Jira usando un servidor de autorización de terceros con OAuth 2.0, debes especificar los siguientes parámetros:

• Servidor de autorización
  • URL de solicitud de autorización
  • URL de solicitud de token
  • Alcance
• Configuración de la aplicación de autorización
  • ID de cliente
  • Secreto de cliente
• Instancia de Jira
  • URL pública de Jira
  • URL base de Jira; URL interna

✏️ Miro proporciona la URL de redireccionamiento que el servidor de autorización valida frente a la aplicación registrada.

Más información: Consulta Conectar Jira local con servidores de autorización de terceros mediante OAuth 2.0.

Solicitudes de autorización de usuario entre Miro y el servidor de autorización local

Para una integración entre Miro y Jira que use un servidor de autorización de terceros, el siguiente diagrama muestra el flujo de la solicitud de autorización del usuario.

Solicitud de autorización del usuario

Solicitud de autorización

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

El usuario puede agregar parámetros a la solicitud de autorización como pares clave-valor en la configuración.

Solicitud 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}' \

Una vez que Miro recibe el código de autorización, envía el parámetro state y solicita un par de tokens.

Intercambio de tokens de actualización

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}' \

Asegúrate de que la operación de token de actualización esté habilitada; habilita el acceso sin conexión a las API.

Solicitudes de API de Jira

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

Cada solicitud usa la URL pública de Jira proporcionada como URL base y el token de acceso del usuario como token Bearer.