Saltar al contenido principal Saltar al contenido complementario

Administrar las claves de API

Las claves de API son identificadores únicos que se utilizan para la autenticación y que permiten a los usuarios, desarrolladores o programas acceder a las API de forma segura. Son esenciales para rastrear y controlar el uso de las API, ayudando a evitar abusos y garantizando una comunicación segura.

video thumbnail

Usar claves de API para conectarse a las API de Qlik Cloud

Puede utilizar claves de API para interactuar con la referencia a la API REST de Qlik. Herramientas como Postman o qlik-cli pueden usarse para el acceso a la API. Para más información, vea Vista general de las API de Qlik y qlik-cli.

Ejemplo: usar Postman para conectarse a las API de Qlik

Haga lo siguiente:

  1. Inicie Postman.

  2. Configure el método HTTP como GET.

  3. Agregue la URL del punto de conexión de la API de Qlik Cloud.

    Por ejemplo, para mostrar todos los espacios del espacio empresarial inquilino:

    https://your-tenant.eu.qlikcloud.com/api/v1/spaces

  4. En la pestaña Auth, seleccione Token de portador como Tipo de autenticación.

  5. Introduzca su clave de API en el campo Token.

  6. Haga clic en Enviar.

Si la solicitud es correcta, la API devolverá una respuesta JSON. En este ejemplo, la respuesta incluiría una lista de espacios.

Habilitar las claves de API en el espacio empresarial inquilino

Nota informativaEste ajuste está obsoleto y se eliminará en una futura versión. Tras su eliminación, la creación de claves de API estará controlada exclusivamente por el permiso Administrar claves de API.

Los administradores del espacio empresarial inquilino pueden controlar si se permite a los usuarios generar claves de API en el espacio empresarial inquilino.

Haga lo siguiente:

  1. En el centro de actividades Administración, vaya a la página de Configuración.
  2. Seleccione la pestaña Control de funciones.
  3. En la sección Claves de API, active o desactive la opción Habilitar claves de API.

Configurar los ajustes de las claves de API

Haga lo siguiente:

  1. En el centro de actividades Administración, vaya a la página de Configuración.

  2. Seleccione la pestaña Control de funciones.
  3. En la sección Claves de API, ajuste los siguientes parámetros según sea necesario:

    • Cambiar la fecha de vencimiento máximo del token: indique el periodo de caducidad de los tokens de API recién generados. Las claves de API existentes conservarán su valor de caducidad original. No hay límite superior para este valor.

    • Cambiar el máximo de claves activas de API por usuario: establezca el límite de claves de API que puede tener un usuario. Este límite solo se aplica a claves nuevas. Si se alcanza el límite, los usuarios no podrán crear claves adicionales. El valor máximo es 1000.

Es posible que tenga que actualizar su navegador para ver los cambios reflejados en la sección Claves de API de su página de configuración personal.

Generar y administrar claves de API

Generar las claves de API

Para generar nuevas claves de API, debe tener un rol personalizado con el permiso Administrar claves de API o el permiso debe estar activado en la configuración de Usuario predeterminado.

Haga lo siguiente:

  1. Haga clic en el icono de su perfil de usuario y seleccione Configuración.

  2. Vaya a la sección Claves de API y haga clic en Generar nueva clave.

  3. Proporcione una descripción y establezca una hora de caducidad para la clave de API.

  4. Haga clic en Generar para crear la clave.

  5. Copie la clave API generada y almacénela de forma segura. Nota: la clave no se puede recuperar más tarde.

Editar claves de API

Puede cambiar el nombre de una clave de API después de su creación.

Eliminar claves de API

Nota informativaEliminar claves de API es permanente y no se puede deshacer. Asegúrese de que esta acción no interrumpa ningún proceso o integración en curso que dependa de la clave.

Haga lo siguiente:

  1. Haga clic en el icono de su perfil de usuario y seleccione Configuración.

  2. Vaya a la sección Claves de API.

  3. Haga clic en Más junto a la clave de que desee eliminar y seleccione Eliminar.

  4. Para eliminar todos, haga clic en Eliminar todos sobre la lista de claves.

Supervisar y revocar claves de API

Puede ver todas las claves de API asociadas a su espacio empresarial inquilino en la sección Claves de API del centro de actividades Administración. Puede buscar claves por nombre, ID o propietario.

Estados de la clave de API

Las claves de API pueden tener los siguientes estados:

  • Activa: la clave de API está siendo utilizada en este momento.
  • Caducada: se ha alcanzado la fecha de caducidad.
  • Revocada: la clave de API se ha revocado y ya no puede utilizarse.

Revocar claves de API

Como administrador de un espacio empresarial inquilino, supervisar activamente las actividades de las claves de API es esencial para mantener la seguridad. Si se detectan actividades sospechosas, puede revocar la clave de API.

Nota informativaRevocar una clave de API la desactiva inmediatamente, afectando a cualquier proceso o integración en curso que dependa de ella. La revocación es irreversible; una clave de API revocada no puede volver a activarse.

Haga lo siguiente:

  1. En el centro de actividades Administración, vaya a Eventos.

  2. Busque actividades sospechosas, como el uso excesivo de una clave API en particular.

  3. Haga clic en Flecha hacia abajo junto al evento para ampliar sus detalles y copiar el ID de la clave API.

  4. Vaya a la sección de Claves de API y busque la clave de API por su ID.

  5. Haga clic en Más junto a la clave y seleccione Revocar. Sólo puede revocar claves con estado Activo.

  6. Para revocar varias claves de API, selecciónelas en la tabla y haga clic en Revocar en la esquina superior derecha.

Mejores prácticas para la gestión de claves de API

  • Mantenga la confidencialidad de las claves: almacene las claves de API de forma segura y evite exponerlas en repositorios públicos de código.

  • Regenere periódicamente: regenere de forma periódica sus claves de API para mejorar la seguridad.

  • Supervise el uso: compruebe regularmente las actividades de las claves de API para identificar cualquier comportamiento sospechoso.

¿Esta página le ha sido útil?

Si encuentra algún problema con esta página o su contenido (errores tipográficos, pasos que faltan o errores técnicos), no dude en ponerse en contacto con nosotros.