Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
EN ESTA PÁGINA
 

Crear tokens de API

Los tokens de API contienen información de autenticación y están vinculados a usuarios específicos o a toda una organización. Los tokens de API envían información de identificación sobre el usuario u organización al servidor de API para indicar si el usuario tiene acceso a la API, para garantizar la seguridad.

Al igual que muchos otros proveedores de API, Juniper Mist ofrece una forma de generar tokens de API para la autenticación (en el encabezado HTTP). Al considerar tokens, Juniper Mist usa los términos token y clave indistintamente.

En Juniper Mist, hay dos tipos de tokens de API:

  • Token de organización

    Los tokens de organización son útiles cuando se crea una aplicación que automatiza el trabajo de la organización. Varios usuarios necesitarían tener acceso a la aplicación y, por lo tanto, usarían el mismo token de organización para la autenticación.

    • El token persiste bajo la organización de Mist.
    • El token no está vinculado a ningún usuario específico, lo que significa que el acceso no depende del acceso de ningún usuario a la organización.
    • Admite N tokens de organización, que pueden tener diferentes privilegios.
    • El token solo se puede usar para esa organización específica.
    • La limitación de la velocidad se realiza mediante el token individual. Por ejemplo, si OrgToken1 consume 5000 llamadas a la API y alcanza el límite de velocidad, OrgToken2 no se verá afectado.

  • Token de usuario

    Los tokens de usuario son útiles cuando necesita autenticarse por sí mismo, como cuando ejecuta un script, por ejemplo.

    • El token de API asume los mismos privilegios que los privilegios de cuenta del usuario asignado.

    • El token está vinculado al usuario específico, lo que significa que el acceso se correlaciona directamente con el acceso del usuario a la organización.
    • El token se puede usar para cualquier proveedor de servicios administrados (MSP) u organización a la que el usuario tenga acceso.
    • Admite N tokens, que tienen todos los mismos privilegios que la cuenta de usuario.
    • La limitación de la tasa es realizada por la cuenta que está vinculada al usuario. Por ejemplo, si UserToken1 consume 5000 llamadas a la API y alcanza el límite de velocidad, UserToken2 Y la cuenta que inician sesión en la GUI se ven afectados.

Puede crear tokens de API mediante el Portal de Mist o el Explorador de API de REST.

Crear un token de organización en el portal de Mist

  1. En el menú izquierdo del portal de Juniper Mist, seleccione Organización > Configuración del administrador >.
  2. Desplácese hacia abajo hasta la sección Token de API y haga clic en Crear token.
  3. Seleccione un nivel de acceso para definir los permisos para el token.

  4. Haga clic en Generar.
  5. Haga clic en el botón de copia junto al campo Clave y guárdelo en algún lugar para su custodia.
    Nota:

    La única vez que verás la clave completa y sin truncar es después de la creación. No podrá ver la clave completa nunca más. Si extravía la clave, tendrá que crear una nueva.

  6. Haga clic en Listo en la parte inferior de la ventana.
  7. Haga clic en Guardar cerca de la esquina superior derecha de la página.

Crear un token de usuario en el portal de Mist

Puede generar un token de usuario de API desde la página Mi cuenta del portal de Mist.

Para generar un token de usuario de API:

  1. En la esquina superior derecha del portal de Juniper Mist, haga clic en el icono Cuenta de Juniper Mist y, a continuación, haga clic en Mi cuenta.
  2. En la sección Token de API, haga clic en Crear token. Si ha habilitado el inicio de sesión único para su organización, no podrá crear tokens de usuario de API.
  3. Escriba un nombre para el token y haga clic en Generar. La clave generada es el token de API de usuario.
  4. Haga clic en el botón Copiar situado junto al campo Clave.

    Asegúrese de guardar la clave en algún lugar para su custodia, ya que no podrá volver a ver la clave completa. Si extravía la clave, deberá crear una nueva.

  5. Haga clic en Listo.
    Nota:

    Si necesita eliminar un token de usuario, haga clic en el token en la sección Token de API de la página Mi perfil y, a continuación, haga clic en Eliminar en la página Editar token.

Crear un token de usuario u organización mediante el Explorador de API de REST

  1. Inicie sesión en el portal de Juniper Mist.
    Nota:

    Debe haber iniciado sesión en el portal para usar el Explorador de API de REST.
  2. Abra una nueva ventana del navegador y pegue su URL: {api-host}/api/v1/self/apitokens.
    Nota:

    En lugar de {api-host}, debe usar el punto de enlace de API para su región global. Consulte Puntos de conexión de API y regiones globales.

    El Explorador de API de REST es la página de API para el control de tokens. Aquí puede crear, leer, actualizar y eliminar tokens e información de tokens. Esta página muestra inicialmente los tokens que ya ha creado.

    Esta página también le permite a usted y a otros usuarios realizar una llamada a la API directamente desde el navegador. Con el tipo de medio: applications/json ya seleccionado como predeterminado, se realizará una solicitud GET para mostrarle una lista de sus tokens. Se mostrará una clave truncada para cualquier token creado anteriormente.

  3. Haga clic en PUBLICAR.

    La respuesta será similar a este ejemplo:

  4. Copie la clave (token) y guárdela para su custodia.
    Nota:

    La API de Juniper Mist nunca volverá a mostrar el token real (clave) en su totalidad, en ningún lugar, después de crear la clave. Después de salir de esta página y regresar, la clave aparecerá pero en una versión truncada. Debe tratar esta clave como una contraseña y almacenarla en un lugar seguro. Si pierde esta clave, deberá crear una nueva.