Página de Registros de Aplicaciones en la Consola de Administración de Jitterbit

Descripción General

Introducción

En esta página se pueden registrar aplicaciones de terceros con OAuth 2.0 de 3 patas (3LO) para su uso con ciertos conectores de Studio. Una vez que la aplicación de terceros 3LO está registrada aquí, se puede autenticar una conexión utilizando OAuth 2.0 de 3 patas.

Para más información sobre cómo autenticar una conexión con 3LO, consulta autenticación 3LO.

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

Ver

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

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

• Buscar: Ingresa texto para encontrar entradas coincidentes.

• Crear Nuevo: Crear un nuevo registro.

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

  • Opciones avanzadas: Muestra opciones avanzadas para el registro.

  • Editar: Editar el registro.

  • Eliminar: Eliminar el registro.

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

Crear

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

1. Haz clic en Crear Nuevo. Aparece una nueva fila en la tabla:

   

2. Establece valores para los siguientes campos:

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

   • Nombre: Un nombre para el registro que sea único para el conector.

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

   • Conector: Haz clic para abrir el menú, luego selecciona uno de los conectores soportados. Actualmente, estos conectores soportan 3LO:

     • BMC Helix ITSM
     • Gmail
     • Google Drive
     • Google Sheets
     • HTTP v2
     • Jira
     • MCP Client
     • Slack
     • Snowflake

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

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

   • Alcance: Uno o más [alcances de OAuth 2.0] separados por espacios.

   En la sección de Configuración:

   • URL de autenticación: La URL a la que se envía una solicitud de autorización.

   • URL del token de acceso: La URL a la que se envía una solicitud de token de acceso.

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

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

   

4. Cuando se guarde correctamente, el registro aparecerá como una nueva entrada en la tabla:

   

Editar

Para editar un registro, sigue estos pasos:

1. Pasa el cursor sobre un registro en la tabla para revelar los íconos de acciones, luego haz clic en Editar. Aparecerá el panel de Editar registro de aplicación:

   

2. En el panel de Editar registro de aplicación, edita los campos, luego 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. Lee el mensaje de notificación que aparece en la parte superior derecha de la ventana. Para cerrar la notificación, haz clic en el ícono Cerrar.

Eliminar

Para eliminar un registro, sigue estos pasos:

1. Pasa el cursor sobre un registro en la tabla para revelar los íconos de acciones, luego haz clic en Eliminar.

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

   Texto del diálogo

   Eliminar registro de aplicación
   ¿Estás seguro de que deseas eliminar el registro de la aplicación appRegistrationName? Esta acción no se puede deshacer.

   Por favor, escribe "DELETE" para confirmar.

3. Ingresa el texto DELETE y luego haz clic en Eliminar, o haz clic en Cancelar para cancelar la acción.

Opciones avanzadas

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

Para abrirlo, pasa el cursor sobre un registro en la tabla y luego haz clic en Opciones avanzadas. El panel aparece en la parte inferior de la página:

El panel 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 tokens contiene configuraciones para el token:

Las siguientes configuraciones están disponibles:

• Habilitar la expiración del token de actualización: Cuando se activa y se utiliza en combinación con las configuraciones de Recibir notificación de expiración y Días para la notificación de expiración de una conexión, recibirás notificaciones por correo electrónico y un banner de notificación a lo largo del portal Harmony recordándote que obtengas un nuevo token de actualización cuando el actual esté expirado o esté próximo a expirar. Cuando un token de actualización expira, todas las operaciones dependientes fallarán en tiempo de ejecución.

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

  Para establecer el período de expiración, ingresa un número entero mayor que cero, luego haz clic en el menú y selecciona uno de Segundos, Horas o Días:

  

  Consejo

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

• Habilitar la expiración por inactividad del token de actualización: Cuando se activa, los tokens de actualización que han estado inactivos durante el tiempo especificado se marcan como expirados en la plataforma Harmony. Utiliza el campo Expirar después para especificar el intervalo después del cual un token de actualización inactivo se marca como expirado.

  Importante

  Utiliza esta configuración en alineación con la configuración de inactividad del proveedor de OAuth. Habilitar esta configuración cuando el proveedor de OAuth no tiene definida una configuración de inactividad hará que los tokens de actualización válidos se consideren incorrectamente como expirados en la plataforma Harmony. Por el contrario, si el proveedor de OAuth sí tiene esta configuración definida, pero no está habilitada y especificada aquí en el portal de Harmony, el endpoint podría utilizar un token de actualización obsoleto, lo que podría causar problemas según las reglas del token de actualización del proveedor de OAuth.

  • Expirar después: Para establecer el período de expiración, ingresa un número entero mayor que cero, luego haz clic en el menú y selecciona 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 expiración por inactividad del token de actualización de un proveedor de OAuth es de 90 días, establece el valor de Expirar después en 90 días.

• Habilitar rotación del token de actualización: Haz clic para habilitar la rotación de tokens:

  

Haz clic en Guardar para guardar los cambios, o 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 se debe enviar una solicitud de autorización.

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

  1. Ingresa valores para Clave y Valor.

  2. Para elegir el método para enviar parámetros, haz clic en el menú Enviar en, luego selecciona uno de URL de solicitud o Encabezado de solicitud.

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

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

Haz 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 de token de acceso: La URL a la que se debe enviar una solicitud de token de acceso.

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

  1. Ingresa valores para Clave y Valor.

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

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

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

Haz 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 de 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, sigue estos pasos:

  1. Ingresa valores para Clave y Valor.

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

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

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

Haz clic en Guardar para guardar los cambios, o en Cancelar para abandonarlos.