Página de registros de aplicaciones en la Management Console de Jitterbit

Introducción

La página Registros de Aplicaciones permite a los administradores de la organización Harmony registrar aplicaciones OAuth 2.0 de tres vías (3LO) de externo para usarlas con ciertos conectores de Integration Studio. Una vez registrada la aplicación 3LO de externo en la página Registros de Aplicaciones, puede autenticar una conexión mediante OAuth 2.0 de tres vías.

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

Nota

Si está utilizando una aplicación en la nube (proporcionada por Jitterbit), no es necesario registrar la aplicación para configurar una conexión.

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

Puedes ver, crear, editar, o eliminar registros, y ver y editar opciones avanzadas para un registro. Un conector puede registrarse 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 con los registros disponibles:

• Buscar: Introduce texto para encontrar las entradas que coinciden.

• Crear nuevo: Crear un nuevo registro.

• Acciones: Pasa el cursor sobre una fila para ver los iconos de acciones:

  • Opciones avanzadas: Mostrar opciones avanzadas para el registro.

  • Editar: Editar el registro.

  • Eliminar: Eliminar el registro.

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

Crear

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

1. Haga clic en 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 único para el conector.

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

   • Conector: Haga clic para abrir el menú y seleccione uno de los conectores compatibles. Actualmente, estos conectores son compatibles con 3LO:

     • BMC Helix ITSM
     • HTTP v2
     • Jira
     • Slack

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

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

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

   

4. Una vez guardado correctamente, el registro aparecerá como una nueva entrada en la tabla:

   

Editar

Para editar un registro, siga estos pasos:

1. Coloque el cursor sobre un registro en la tabla para ver los iconos de acciones y haga clic en Editar. Aparece el panel Editar registro de la aplicación:

   

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

   Nota

   El Conector de un registro no se puede cambiar de 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 el botón Icono de Cerrar.

Borrar

Para eliminar un registro, siga estos pasos:

1. Coloque el cursor sobre un registro en la tabla para ver los iconos de acciones y haga clic en Eliminar.

2. Se abrirá el cuadro de diálogo Eliminar registro de la aplicación:

   

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

Opciones avanzadas

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

Para abrirlo, coloque el cursor sobre un registro en la tabla y 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

Consejo

Si una pestaña tiene configuraciones no válidas, el botón Guardar se vuelve inactivo y aparece un símbolo de error. Aparece junto a la etiqueta de la pestaña.

Política de tokens

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

Importante

Habilite las configuraciones de la pestaña Política de token solo si también están habilitadas en el proveedor OAuth.

Están disponibles las siguientes configuraciones:

• Habilitar la caducidad del token de actualización: Haga clic para habilitar la caducidad del token de actualización generado en esta página. Al combinarse con la opción Recibir notificación de caducidad de una conexión, el valor configurado en el campo Días para la notificación de caducidad de la conexión se utiliza para notificarle el número de días antes de la caducidad del token de actualización configurado aquí. Si esta opción está habilitada, se le notificará mediante un banner de la aplicación y un correo cuando los tokens estén a punto de caducar o si ya han caducado. Ambas notificaciones le indican qué hacer en cada caso.

  Cuando esta configuración está habilitada, la notificación correo se envía a los administradores de la organización Harmony (miembros de un rol con el permiso_Admin_ y el usuario que implementó el proyecto por última vez).

  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 la caducidad del token de actualización de un proveedor de OAuth es de 1 año, configure el valor Caducidad después de en 1 año.

• Habilitar caducidad del token de actualización por inactividad: Haga clic para habilitar la caducidad del token por inactividad. Para establecer el periodo de caducidad, introduzca un número entero mayor que cero, haga clic en el menú y seleccione 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 plazo de inactividad del token de actualización de un proveedor de OAuth es de 90 días, configure el valor Caducidad después de en 90 días.

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

  

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

Solicitud de autenticación

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

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

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

  1. Ingrese valores para Clave y Valor.

  2. Para elegir el método de envío de parámetros, haga clic en el menú Enviar y luego seleccione URL de solicitud o Encabezado de solicitud.

  3. Haga clic Añadir. 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 descartarlos.

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 a la solicitud, siga estos pasos:

  1. Ingrese valores para Clave y Valor.

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

  3. Haga clic Añadir. 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 descartarlos.

Solicitud de actualización

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

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

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

  1. Ingrese valores para Clave y Valor.

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

  3. Haga clic Añadir. 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 descartarlos.