Autenticación de la API de Looker

Para realizar cualquier acción con la API de Looker, primero debes autenticarte en ella. Los pasos que debes seguir dependen de si usas o no un SDK.

Autenticación con un SDK

Este es el método recomendado para la autenticación de API:

  1. Crea las credenciales de la API en la página Usuarios de la sección Administrador de tu instancia de Looker. Si no eres administrador de Looker, pídele a este que cree las credenciales de la API por ti.

    Las credenciales de la API siempre están vinculadas a una cuenta de usuario de Looker. Las solicitudes a la API se ejecutan "como" el usuario asociado con las credenciales de la API. Las llamadas a la API solo mostrarán datos que el usuario pueda ver y solo modificarán lo que este tenga permitido modificar.

  2. Las credenciales de API que generaste incluyen un ID de cliente y un secreto del cliente. Deberás proporcionarlas al SDK. Encontrarás las instrucciones para hacerlo en la documentación del SDK.

Luego, el SDK se encargará de obtener los tokens de acceso necesarios y de insertarlos en todas las solicitudes a la API posteriores.

Autenticación sin un SDK

El método recomendado es la autenticación de la API con un SDK. Sigue estos pasos para autenticar sin un SDK:

  1. Crea las credenciales de la API en la página Usuarios de la sección Administrador de tu instancia de Looker. Si no eres administrador de Looker, pídele a este que cree las credenciales de la API por ti.

    Las credenciales de la API siempre están vinculadas a una cuenta de usuario de Looker. Las solicitudes a la API se ejecutan "como" el usuario asociado con las credenciales de la API. Las llamadas a la API solo mostrarán datos que el usuario pueda ver y solo modificarán lo que este tenga permitido modificar.

  2. Obtén un token de acceso de OAuth 2.0 a corto plazo mediante una llamada al extremo login de la API. Deberás proporcionar las credenciales de la API que generaste en el paso 1, que incluyen un ID y un secreto del cliente.

  3. Colocar ese token de acceso en el encabezado de autorización HTTP de las solicitudes a la API de Looker Un ejemplo de solicitud a la API de Looker con un encabezado de autorización podría verse así:

    GET /api/3.0/user HTTP/1.1
    Host: test.looker.com
    Date: Wed, 19 Oct 2016 12:34:56 -0700
    Authorization: token mt6Xc8jJC9GfJzKBQ5SqFZTZRVX8KY6k49TMPS8F
    

El token de acceso de OAuth 2.0 se puede usar en varias solicitudes a la API, hasta que venza o se invalide cuando se llama al extremo logout. Las solicitudes a la API que usen un token de acceso vencido fallarán con una respuesta HTTP 401 Authorization Required.

Interacción de la API con la configuración de acceso del usuario

La autenticación de la API de Looker es completamente independiente del acceso de los usuarios de Looker. Los protocolos de autenticación de usuarios, como las contraseñas de un solo uso (OTP, 2FA) y la autenticación del directorio (LDAP, SAML, etc.) no se aplican a la autenticación de la API de Looker.

Por este motivo, borrar la información de un usuario de un protocolo de autenticación de usuarios no borra sus credenciales de API. Cuando usas los procedimientos de la página de documentación Borra información personal del usuario, se quitan todos los datos personales de un usuario de Looker, lo que impide que este acceda a su cuenta, incluso a través de la API.

Administra las credenciales de las APIs

  • Se pueden vincular varios conjuntos de credenciales de la API a una sola cuenta de usuario de Looker.
  • Las credenciales de API se pueden crear y borrar sin afectar el estado de la cuenta de usuario.
  • Si borras una cuenta de usuario de Looker, se invalidarán todas las credenciales de la API vinculadas a ella.
  • El secreto del cliente de la API debe mantenerse privado. Evita almacenar los secretos de cliente de API en el código fuente o en otros lugares que puedan ver muchas personas.
  • En producción, evita usar credenciales de API vinculadas a las cuentas de administrador de Looker. Crea cuentas de usuario con privilegios mínimos específicamente para actividades de API (a menudo llamadas "cuentas de servicio") y crea credenciales de API en esas cuentas. Otorga solo los permisos necesarios para las actividades de API previstas.

Autenticación HTTPS

Incluso si usas un SDK cliente para ocuparte de los detalles de autenticación, es posible que quieras saber cómo funciona la autenticación de la API de Looker. Para obtener detalles de bajo nivel sobre la autenticación, consulta Cómo autenticarte en la API de Looker en GitHub.

Autenticación con OAuth

Looker puede usar el protocolo de Uso compartido de recursos multiorigen (CORS) para permitir que las aplicaciones web realicen llamadas a la API de Looker desde fuera del dominio de una instancia de Looker. Consulta la página de documentación de Autenticación de la API de Looker con OAuth para obtener información sobre cómo configurar la autenticación de CORS.