Presentación de las actualizaciones de tru.ID CLI

by Paul McGuire | mayo 23, 2022
Una pantalla que muestra el terminal tru.ID CLI.

El éxito de IDlayr depende de que usted, el desarrollador, tenga éxito. En declarado anteriormentetodos nuestros herramientas para desarrolladores son de código abierto y están a su disposición. En IDlayr CLI es una de estas herramientas, y hoy hemos lanzado una nueva versión con varios cambios para que implementar la autenticación basada en SIM con IDlayr sea aún más fácil.

¿Cuáles son las actualizaciones?

La última versión de IDlayr CLI contiene varias actualizaciones. Estas se resumen en los siguientes puntos y se explican con más detalle en sus propias secciones a continuación:

  • Se ha añadido la compatibilidad con oAuth2 para facilitar la configuración de la CLI y la autenticación de su cuenta.
  • Se ha eliminado la función `dev-server` de la CLI.
  • Se ha eliminado `-workflow` de los comandos de creación PhoneCheck (`phonechecks:create`) y SubscriberCheck (`subscriberchecks:create`).

Autenticación

En la versión anterior, la CLI sólo admitía la autenticación con las credenciales de su espacio de trabajo (concesión `client_credentials`), que habría configurado al ejecutar el comando `tru setup`.

Con la nueva versión (v1.0.5), hemos sustituido esto por `tru login`. Tendrás que introducir el proveedor de identidad que elijas de Google, GitHub o Microsoft. Usando esta nueva funcionalidad, no necesitarás encontrar tus credenciales, sino que usarás tu proveedor de identidad de confianza.

Eliminación del comando Dev-Server

Con el PhoneCheck ni Comprobación de abonados API se actualiza a la versión 0.2, se requiere más configuración para el servidor de demostración para desarrolladores, y se tomó la decisión de eliminar esta función como un plugin para la CLI y mantenerlo como un repositorio independiente. Si aún desea seguir utilizando el servidor de demostración para desarrolladores, clone el repositorio en GitHub.

¿Cómo puedo utilizar la CLI?

Instale

Para instalar el CLI, necesitas npm (versión mínima 14.0.0) instalado localmente en tu máquina; luego en tu Terminal, ejecuta el siguiente comando:

Antes de que pueda acceder a cualquier cosa con el CLI, necesita hacerle saber quien es usted. Puede iniciar sesión con el siguiente comando, pero asegúrese de elegir el proveedor de identidad que eligió al crear una cuenta en IDlayr:

Espacios de trabajo

A espacio de trabajo es un contenedor para las cuentas de los usuarios y las cuentas de facturación. Hay dos tipos diferentes de espacios de trabajo a los que puedes pertenecer, y son:

  • Si se registró en IDlayr por su cuenta, tendrá un espacio de trabajo creado para usted. Por defecto, usted es el propietario de este espacio de trabajo - es decir, tendrá el control total de los proyectos y la facturación.
  • Si se registró en IDlayr a través de una invitación de otro usuario de IDlayr, por defecto se unirá a su espacio de trabajo con el nivel de acceso que le han concedido - esto podría ser un administrador o espectador. Además, también tendrá un espacio de trabajo separado del que será propietario.

Puedes ver de qué espacios de trabajo eres miembro ejecutando el comando:

Tendrás que elegir cuál va a ser el espacio de trabajo activo para tu CLI con el siguiente comando:

Proyectos

A proyecto es un método para que las aplicaciones accedan a las APIs de IDlayr. Un proyecto sirve para dos propósitos:

  • Proporcionar credenciales. Cada usuario dentro del espacio de trabajo tendrá que generar sus credenciales, eliminando la necesidad de compartir credenciales para un proyecto.
  • Para agrupar lógicamente las llamadas a la API. Tener proyectos separados para fines o aplicaciones específicos aumenta la seguridad y mejora el seguimiento del uso de cada proyecto.

Con la CLI, puede ejecutar tres comandos para proyectos. Estos se enumeran en los ejemplos siguientes:

Si desea obtener más información sobre cómo configurar su entorno para utilizar las API de IDlayr, consulte el documento Configure su entorno en la página Documentos para desarrolladores de IDlayr.