IRIS CloudDesarrolladores
Referencia de la APIAbrir IRIS Cloud
ES

Crear un token de API

Tu token de API conecta una integración a los datos de tu organización. Créalo y adminístralo en tu cuenta de IRIS Cloud.

Crea un token en IRIS Cloud#

  1. Inicia sesión en IRIS Cloud

    Usa tu cuenta existente en el entorno al que quieras conectarte.

  2. Abre la cuenta de usuario (User Account)

    Busca la sección IRIS Cloud API Tokens. Abrir la cuenta de usuario en IRIS Cloud ↗

    Cuenta de IRIS Cloud sin tokens de API.
    Cuenta de IRIS Cloud sin tokens de API. Abrir imagen en tamaño original ↗
  3. Selecciona Create Token (Crear token)

    Asigna al token un nombre único y reconocible, como Integración de producción. Añade una descripción opcional para identificar el sistema que lo usará.

    Ventana Create Token con campos de nombre, descripción opcional y vencimiento.
    Ventana Create Token con campos de nombre, descripción opcional y vencimiento. Abrir imagen en tamaño original ↗
  4. Elige la vigencia y crea el token

    Selecciona 30, 90, 180 o 365 días, o Never (Nunca). Haz clic en Create (Crear) para generar el token.

    Opciones de vencimiento: Never, 30, 90, 180 o 365 días.
    Opciones de vencimiento: Never, 30, 90, 180 o 365 días. Abrir imagen en tamaño original ↗
    Formulario completado, listo para crear el token.
    Formulario completado, listo para crear el token. Abrir imagen en tamaño original ↗

Cópialo antes de cerrar#

En Token Created (Token creado), selecciona Copy Token (Copiar token) y guárdalo en el gestor de secretos o en la configuración protegida del entorno de tu integración.

Ventana Token Created: copia el token antes de cerrar.
Ventana Token Created: copia el token antes de cerrar. Abrir imagen en tamaño original ↗

Usa tu token en la guía rápida o pégalo en Authorize en la referencia de la API.

Administra tus tokens#

La tabla de la cuenta muestra el nombre, la descripción, la fecha de creación, el último uso, el vencimiento y el estado de cada token. Tu organización puede tener hasta tres tokens activos.

Tabla de tokens con fechas de uso, vencimiento, estado y acciones de revocación.
Tabla de tokens con fechas de uso, vencimiento, estado y acciones de revocación. Abrir imagen en tamaño original ↗

Si alcanzas el límite, revisa tus integraciones y revoca un token que ya no necesites antes de crear otro. Un token con fecha de vencimiento deja de funcionar cuando vence.

Notificación al alcanzar el límite de tres tokens activos.
Notificación al alcanzar el límite de tres tokens activos. Abrir imagen en tamaño original ↗

Revoca o sustituye un token#

En la tabla de tokens de API, selecciona la acción de revocación, revisa la confirmación y elige Revoke Token (Revocar token). La revocación no se puede deshacer y las integraciones que usan ese token dejarán de funcionar.

Confirmación Revoke Token y aviso de que las integraciones dejarán de funcionar.
Confirmación Revoke Token y aviso de que las integraciones dejarán de funcionar. Abrir imagen en tamaño original ↗

Al sustituir un token, crea primero el nuevo si hay una plaza disponible. Actualiza y verifica la integración y después revoca el token anterior. Si todas las plazas están ocupadas, planifica el cambio antes de revocar un token que siga en uso.

SIGUE LEYENDOAutenticación
IRIS Cloud · Connect APIAPI 1.0.0 · Producción