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 3 patas (3LO) de externo para usarlas con ciertas aplicaciones. Integration Studio Conectores. Una vez que la aplicación 3LO de externo esté registrada 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.

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 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 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:

En el caso de 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 las entradas que coincidan.

• 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 el encabezado de cualquier 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 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 sea único 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, estos conectores admiten 3LO:

     • BMC Helix ITSM
     • HTTP versión 2
     • 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.

   • Ámbito: 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 aparece 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 revelar los íconos de acciones y luego 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 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. 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 Cerrar.

Borrar

Para eliminar un registro, siga estos pasos:

1. Coloque el cursor sobre un registro en la tabla para revelar los íconos de acciones y luego haga clic en Eliminar.

2. Se abre el 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 las configuraciones predeterminadas proporcionadas por el proveedor de OAuth para el token de cada registro y para las solicitudes de autenticación, token y actualización.

Para abrirlo, pase el cursor sobre un registro en la tabla y luego haga clic en Opciones avanzadas. El cajón aparece en la parte inferior 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 la caducidad del token de actualización: Haga clic para habilitar la caducidad del token de actualización generado en esta página. Cuando se utiliza en combinación con la configuración Recibir notificación de caducidad de una conexión, el valor configurado en el campo Días para la notificación de caducidad correspondiente de la conexión se utiliza para notificarle la cantidad de días configurados antes de la caducidad del token de actualización configurado aquí. Si está habilitado, se le notifica, con un banner de la aplicación y un correo, cuando los tokens están por caducar o si ya han caducado. Ambas formas de notificación 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:

  

  Sugerencia

  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 por inactividad del token de actualización: Haga clic para habilitar la caducidad del token por inactividad. Para configurar el período de caducidad, ingrese un número entero mayor que cero, luego haga clic en el menú y seleccione uno de los siguientes: Segundos, Horas o Días:

  

  Sugerencia

  La configuración recomendada para este valor debe coincidir con la utilizada en el propio proveedor de OAuth. Por ejemplo, si el vencimiento por inactividad del token de actualización de un proveedor de OAuth es de 90 días, configure el valor Caduca 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 abandonarlos.

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 se 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, luego seleccione URL de solicitud o Encabezado de solicitud.

  3. Haga clic 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 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, luego seleccione URL de solicitud, Encabezado de solicitud o Cuerpo de solicitud.

  3. Haga clic 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 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, luego seleccione URL de solicitud, Encabezado de solicitud o Cuerpo de solicitud.

  3. Haga clic 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.