Crear y administrar tokens de acceso de HighBond

Cree o gestione sus tokens de acceso personales de HighBond en la página Administrar tokens de API disponible a través de su página de perfil de Launchpad.

¿Qué es un token de acceso?

Un token de acceso es una cadena que identifica a un usuario y autentica el acceso a otras aplicaciones.

El token de acceso que requiere depende de lo que necesita hacer:

• Importar datos de Proyectos de Diligent One a Analytics : token de API de HighBond o Analytics
• Importar datos de Resultados de Diligent One a Analytics : token de API de HighBond o Analytics
• Exportar datos de Resultados de Diligent One desde Analytics : token de API de HighBond o Analytics
• Obtener acceso programático a la plataforma Diligent One: token de API de HighBond
• Obtener acceso programático a los Logs de actividad de Launchpad: token de API de Logs de actividad

  Nota

  El acceso a los logs de actividad de Launchpad solo está disponible para los administradores del sistema.

Token de Analytics

El token de Analytics se genera automáticamente cada vez que usted activa Analytics y se almacena en su registro.

• Si está utilizando Analytics 14 o inferior y crea manualmente un Token de acceso de ACLGRC, el token se clasifica en Launchpad como un tipo de token de Analytics.
• Si está utilizando Analytics 14.1 y crea manualmente un Token de acceso de HighBond, el token se clasifica en Launchpad como un tipo de token de Analytics.

Cómo funciona

En Launchpad, la página Administrar tokens de API muestra todos los tokens de acceso que usted ha generado.

Puede utilizar la página Administrar tokens de API para hacer lo siguiente:

• copiar sus tokens
• proporcionar una etiqueta para describir o identificar tokens de acceso
• bloquear tokens de acceso para evitar que sean modificados o eliminados
• eliminar tokens de acceso

Permisos

Cualquier usuario puede crear un token de Analytics. Usted debe ser administrador del sistema en al menos una instancia de Diligent One para crear un token de API de HighBond o un token de API de logs de actividad.

Todos los usuarios pueden administrar sus propios tokens de acceso.

Crear tokens de acceso

1. Abra Launchpad.

Nota

Si su empresa utiliza más de una instancia en Diligent One, asegúrese de que la instancia apropiada esté activa.

2. Seleccione > Mi perfil.
3. Junto a Tokens de la aplicación, haga clic en Administrar. Se abre la página Administrar tokens API.
4. Haga clic en +Agregar token y seleccione la opción apropiada de la lista desplegable (p. ej., API de HighBond, Analytics o API de logs de actividades). Aparece un panel lateral Nuevo token.
5. Complete los campos en el panel lateral para crear un token.

   Nota

   Todos los campos son obligatorios para crear un token, incluyendo el de Descripción. La única excepción es si opta por no incluir la caducidad del token. En ese caso, no sería necesario completar el número de días en los que debe caducar un token, ya que de forma predeterminada sería Nunca.

   1. Introduzca una descripción.

      Consejo

      En la descripción, incluya todos los lugares en los que se utilizará este token y su finalidad. La razón es que los tokens deben reemplazarse cuando caducan, y agregar una descripción detallada ahorra tiempo y esfuerzo cuando hay que reemplazarlos.

   2. Opcional. Activar o desactivar la caducidad del token.

      Nota

      La posibilidad de establecer la caducidad de los tokens debería estar activada (selector en posición de activado) de forma predeterminada. Si esta opción está desactivada, el token no caducará nunca.

   3. Introduzca el número de días en los que debe caducar el token hasta un máximo de un año (365 días) a partir de la fecha de creación del token.
   4. Introduzca la contraseña de su cuenta de Diligent One para verificar su identidad.
6. Haga clic en Generar token. El panel lateral se actualiza con un mensaje que confirma que el token se generó correctamente e incluye el identificador del token, la fecha de caducidad (la fecha y hora en que caducará el token) y la Descripción.
7. Haga clic en Copiar. El mensaje Copiado al portapapeles confirma que el token se copió correctamente.

   Precaución

   Guarde el token antes de cerrar este panel lateral. Como medida de seguridad, esta es su única oportunidad de acceder a él. Si no guarda el token y lo olvida, deberá crear uno nuevo.
8. Haga clic en Cerrar. Se cierra el panel lateral Nuevo token.
9. Pegue el token en una aplicación o en un script.

   Nota

   Trate el token como si fuera una contraseña y no lo comparta con otras personas.

Localizar y aprovechar los tokens de acceso

En la página Administrar tokens de API, podrá encontrar los tokens existentes, editar las descripciones de los tokens, bloquearlos para que no puedan editarse ni borrarse, y eliminarlos.

1. Abra Launchpad.

Nota

Si su empresa utiliza más de una instancia en Diligent One, asegúrese de que la instancia apropiada esté activa.

2. Seleccione > Mi perfil.
3. Junto a Tokens de la aplicación, haga clic en Administrar. Se abre la página Administrar tokens API.
4. Realice una de las siguientes acciones.

Buscar tokens de acceso

Para localizar tokens, puede buscar, ordenar y filtrar para encontrar los tokens específicos que necesita. Realice una de las siguientes acciones:

• Buscar tokens: Introduzca los primeros caracteres del token de acceso (hasta siete caracteres) en la barra de búsqueda. Esto devuelve una lista acotada de resultados.
• Ordenar tokens: Haga clic en cualquiera de los encabezados de las columnas para ordenar los tokens por columna elegida en orden ascendente o descendente.
• Filtrar tokens: De forma predeterminada, se muestran todos los tokens generados. Sin embargo, puede filtrar la lista de tokens a un subconjunto como, por ejemplo, si un token está bloqueado o por el tipo de token: Analytics, Logs de actividad o API de HighBond. Seleccione los filtros deseados en las listas desplegables disponibles para filtrar la lista de tokens. Haga clic en Borrar para quitar todos los filtros.

Copiar un token de acceso existente

1. Haga clic en el token truncado e ingrese su contraseña de Diligent One. Aparecerá un cuadro de diálogo Confirmar su contraseña.
2. Introduzca su contraseña para verificar su identidad.
3. Haga clic en Confirmar. Aparece un cuadro de diálogo con su token.
4. Haga clic en Copiar. El mensaje Copiado al portapapeles confirma que el token se copió correctamente.
5. Cierre el cuadro de diálogo.
6. Ahora puede pegar el token en una aplicación o en un script.

Editar la descripción de un token de acceso

1. Haga clic en el lápiz . El campo Descripción se vuelve editable en línea.
2. Actualice la descripción y haga clic en la marca de verificación para guardar los cambios. La descripción actualizada aparece en la tabla.

Bloquear o desbloquear los tokens de acceso

Si quiere evitar que se eliminen los tokens y que se editen las descripciones de los tokens, puede bloquearlos. También puede desbloquear tokens para cambiar las descripciones y permitir la eliminación.

• Haga clic para abrir el candado junto a su token o para deshabilitar las opciones de eliminación de tokens y edición de descripciones. El candado aparece cerrado para indicar que el token no se puede editar ni eliminar. El lápiz y la papelera también desaparecen.
• Haga clic en el candado cerrado para desbloquear el token y permitir la eliminación de tokens y la edición de las descripciones. El candado aparecerá abierto para indicar que están permitidas la edición y la eliminación. El lápiz y la papelera también reaparecieron.

Eliminar tokens de acceso

Puede eliminar tokens individuales, varios tokens a la vez o todos los tokens de la lista. Si no necesita mantener los tokens anteriores como referencia, puede borrarlos para eliminar el desorden de la lista de tokens. Sin embargo, cualquier decisión de eliminar tokens debe tomarse con precaución y solo cuando se haya confirmado que el token ya no se utiliza en ningún sitio, ya que la eliminación es permanente y no puede deshacerse.

Eliminar un solo token

1. Haga clic en la papelera junto al token. Aparecerá un cuadro de diálogo ¿Desea eliminar # token? para confirmar la eliminación.
2. Haga clic en Eliminar token. El token se elimina permanentemente y se quita de la lista.

Atención

La eliminación de un token es permanente y no se puede deshacer. Si se elimina un token en uso, se producirá un error en cualquier proceso que lo esté utilizando. Si un token se elimina por error, habrá que volver a crearlo e introducirlo de nuevo en la aplicación o el script que se hayan visto afectados.

Eliminar varios tokens

1. Haga clic en las casillas de verificación junto a los tokens que desea eliminar. Aparece un botón rojo arriba de la lista de tokens que indica el número de tokens que se van a eliminar.
2. Haga clic en Eliminar # tokens. Aparecerá un cuadro de diálogo ¿Desea eliminar # token? para confirmar la eliminación.
3. Haga clic en Eliminar tokens. Los tokens se eliminan permanentemente y se quitan de la lista.

Atención

La eliminación de un token es permanente y no se puede deshacer. Si se elimina un token en uso, se producirá un error en cualquier proceso que lo esté utilizando. Si un token se elimina por error, habrá que volver a crearlo e introducirlo de nuevo en la aplicación o el script que se hayan visto afectados.

Eliminar todos los tokens

1. Seleccione la casilla de verificación junto al icono de información . Esto selecciona automáticamente todos los tokens de la lista y aparece un botón rojo arriba de la lista de tokens que indica el número de tokens que se van a eliminar.
2. Haga clic en Eliminar # tokens. Aparecerá un cuadro de diálogo ¿Desea eliminar # tokens? para confirmar la eliminación.
3. Haga clic en Eliminar # tokens. Los tokens se eliminan permanentemente y se quitan de la lista.

Atención

La eliminación de un token es permanente y no se puede deshacer. Si se elimina un token en uso, se producirá un error en cualquier proceso que lo esté utilizando. Si un token se elimina por error, habrá que volver a crearlo e introducirlo de nuevo en la aplicación o el script que se hayan visto afectados.

Abordar los tokens que están a punto de caducar

Se enviarán varios recordatorios hasta que el token se elimine o caduque. Los creadores de tokens recibirán correos electrónicos de notificación 30 días, 5 días y 1 día antes de la fecha de caducidad de un token. También se enviará una notificación por correo electrónico cuando el token caduque. Cuando un token caduca, todos los procesos que dependen de él darán error a menos que el token se reemplace por uno nuevo.

Reemplazar un token que está a punto de caducar por uno nuevo

Para evitar que los procesos den error, es necesario reemplazar los tokens que están a punto de caducar y los que ya caducaron por unos nuevos. Para actualizar un token, debe crear uno nuevo. Consulte Crear tokens de acceso. Una vez creado el nuevo token, localice todas las instancias que utilizan el token que está a punto de caducar y reemplácelo por el token recién creado.

Eliminar un token que está a punto de caducar

Elimine un token que está a punto de caducar para dejar de recibir notificaciones sobre su próxima caducidad y para quitar cualquier token al que ya no necesite como referencia. Consulte Eliminar tokens de acceso.