Registros de Aplicaciones¶

Introducción¶

La página Registros de aplicaciones permite a los administradores de organizaciones de Harmony registrar aplicaciones OAuth 2.0 (3LO) de 3 externo para usarlas con determinados conectores de Cloud Studio. Una vez que la aplicación 3LO de externo esté registrada en la página Registros de aplicaciones, puede autenticar una conexión utilizando OAuth 2.0 de 3 patas.

Para obtener más información sobre cómo autenticar una conexión con 3LO, consulte Autenticación 3LO.

En la página Registros de aplicaciones, los administradores de la organización pueden registrar aplicaciones privadas con conectores habilitados para 3LO, configurar los detalles del proveedor de OAuth y definir el comportamiento de los tokens de actualización. Para abrirlo, seleccione Management Console > Customizaciones > Registros de aplicaciones en el menú Harmony Portal:

Puedes ver, crear, editar, o eliminar registros, y ver y editar opciones avanzadas para un registro. Un conector se puede registrar varias veces. Cada una se considera una aplicación de conector única.

Vista¶

Sin registros, el cuerpo de la página contiene una barra de herramientas y una tabla vacía:

Con los registros, el cuerpo de la página contiene una barra de herramientas y una tabla que enumera los registros disponibles:

• Buscar: Ingrese texto para encontrar entradas coincidentes.

• Crear nuevo: Crear un nuevo registro.

• Acciones: Pase el cursor sobre una fila para revelar los íconos de acciones:

  • Opciones avanzadas: Mostrar opciones avanzadas para el registro.

  • Editar: Editar el registro.

  • Eliminar: Eliminar el registro.

Haga clic en cualquier encabezado de columna (excepto Acciones) para ordenar la tabla en orden ascendente según esa columna. Haga clic nuevamente para invertir el orden de clasificación.

Crear¶

Para crear un nuevo registro de aplicación de conector, siga estos pasos:

1. Haga clic Crear nuevo. Aparece una nueva fila en la tabla:

   

2. Establezca valores para los siguientes campos:

   En la sección Crear nuevo registro de aplicación:

   • Nombre: Un nombre para el registro que es exclusivo para el conector.

   • Descripción: Una descripción para el registro.

   • Conector: Haga clic para abrir el menú y luego seleccione uno de los conectores compatibles. Actualmente, el conector Jira admite 3LO.

   • ID de cliente: El identificador de cliente asignado por el proveedor de OAuth.

   • Secreto de cliente: El secreto de cliente asignado por el proveedor de OAuth.

   • Alcance: Uno o más espacios separados OAuth 2.0 scopes.

   En la sección Configuración:

   • URL de autenticación: La URL a la que enviar una solicitud de autorización.

   • URL del token de acceso: La URL a la que enviar una solicitud de token de acceso.

   • Actualizar URL del token: La URL para solicitar un nuevo token de acceso.

3. Haga clic Guardar para guardar los valores, o Cancelar para cancelar:

   

4. Cuando se guarda correctamente, el registro aparece como una nueva entrada en la tabla:

   

Editar¶

Para editar un registro, siga estos pasos:

1. Pase el cursor sobre un registro en la tabla para revelar los íconos de acciones, luego haga clic en Editar. Aparece el panel Editar registro de aplicación:

   

2. En el panel Editar registro de aplicación, edite los campos y luego haga clic en Guardar para guardar los cambios o en Cancelar para cancelar.

   Nota

   El Conector de un registro no se puede cambiar desde su valor inicial.

3. Lea el mensaje de notificación que aparece en la parte superior derecha de la ventana. Para cerrar la notificación, haga clic en Icono Cerrar.

Borrar¶

Para eliminar un registro, siga estos pasos:

1. Pase el cursor sobre un registro en la tabla para revelar los íconos de acciones, luego haga clic en Borrar.

2. Se abre un cuadro de diálogo Eliminar registro de aplicación:

   

3. Ingrese el texto ELIMINAR y luego haga clic en Eliminar, o haga clic en Cancelar para cancelar la acción.

Opciones Avanzadas¶

El cajón Opciones avanzadas contiene la configuración predeterminada proporcionada por el proveedor de OAuth para cada registro. token y para las solicitudes de autenticación, token y actualización.

Para abrirlo, coloque el cursor sobre un registro en la tabla y luego haga clic en Opciones avanzadas. El cajón aparece al final de la página:

El cajón contiene estas pestañas:

• Política de tokens

• Solicitud de autenticación

• Solicitud de token

• Solicitud de actualización

Política de Tokens¶

La pestaña Política de token contiene configuraciones para el token:

Están disponibles las siguientes configuraciones:

• Habilitar caducidad del token de actualización: Haga clic para habilitar la caducidad del token de actualización generado en esta página. Cuando se usa en combinación con la configuración Recibir notificación de vencimiento de una conexión, el valor configurado en el campo Días para notificación de vencimiento correspondiente de la conexión se usa para notificarle la cantidad configurada de días antes de la expiración del token de actualización configurada. aquí. Si está habilitado, se le notificará, con un banner de aplicación y un correo, cuando los tokens estén a punto de caducar o si ya han caducado. Ambas formas de notificación te indican qué hacer en cada caso.

  Para establecer el período de vencimiento, ingrese un número entero mayor que cero, luego haga clic en el menú y seleccione uno de Segundos, Horas o Días:

  

  Consejo

  La configuración recomendada para este valor debe coincidir con la utilizada en el propio proveedor de OAuth. Por ejemplo, si el vencimiento del token de actualización de un proveedor de OAuth es de 1 año, establezca el valor Expirar después en 1 año.

• Habilitar vencimiento de inactividad del token de actualización: Haga clic para habilitar el vencimiento de inactividad del token. Para establecer el período de vencimiento, ingrese un número entero mayor que cero, luego haga clic en el menú y seleccione uno de Segundos, Horas o Días:

  

  Consejo

  La configuración recomendada para este valor debe coincidir con la utilizada en el propio proveedor de OAuth. Por ejemplo, si el vencimiento de inactividad del token de actualización de un proveedor de OAuth es de 90 días, establezca el valor Expirar después en 90 días.

• Habilitar token de actualización rotativo: Haga clic para habilitar la rotación de token:

  

Haga clic en Guardar para guardar los cambios o en Cancelar para abandonarlos.

Solicitud de Autenticación¶

La pestaña Solicitud de autenticación contiene configuraciones para la solicitud de autenticación del token:

• URL de autenticación: La URL a la que enviar una solicitud de autorización.

• Parámetros: Para agregar parámetros para la solicitud, siga estos pasos:

  1. Introduzca valores para Clave y Valor.

  2. Para elegir el método para enviar parámetros, haga clic en el menú Enviar en y luego seleccione uno de Solicitar URL o Solicitar encabezado.

  3. Haga clic en Agregar. El parámetro aparece como una nueva fila en la tabla.

  4. Repita los tres pasos anteriores para todos los parámetros.

Haga clic en Guardar para guardar los cambios o en Cancelar para abandonarlos.

Solicitud de Token¶

La pestaña Solicitud de token contiene configuraciones para la solicitud de token:

• URL del token de acceso: La URL a la que enviar una solicitud de token de acceso.

• Parámetros: Para agregar parámetros para la solicitud, siga estos pasos:

  1. Introduzca valores para Clave y Valor.

  2. Para elegir el método para enviar parámetros, haga clic en el menú Enviar y luego seleccione uno de Solicitar URL, Encabezado de solicitud o Cuerpo de solicitud.

  3. Haga clic en Agregar. El parámetro aparece como una nueva fila en la tabla.

  4. Repita los tres pasos anteriores para todos los parámetros.

Haga clic en Guardar para guardar los cambios o en Cancelar para abandonarlos.

Solicitud de Actualización¶

La pestaña Solicitud de actualización contiene configuraciones para la solicitud de actualización del token:

• URL del token de actualización: La URL para solicitar un nuevo token de acceso.

• Parámetros: Para agregar parámetros para la solicitud, siga estos pasos:

  1. Introduzca valores para Clave y Valor.

  2. Para elegir el método para enviar parámetros, haga clic en el menú Enviar y luego seleccione uno de Solicitar URL, Encabezado de solicitud o Cuerpo de solicitud.

  3. Haga clic en Agregar. El parámetro aparece como una nueva fila en la tabla.

  4. Repita los tres pasos anteriores para todos los parámetros.

Haga clic en Guardar para guardar los cambios o en Cancelar para abandonarlos.