tru.ID's success depends on you, the developer, being successful. As previously stated, all of our developer tools are open-source and available to you. The tru.ID CLI is one of these tools, and today we've released a new version with several changes to make implementing SIM-based authentication with tru.ID even easier.
The latest version of the tru.ID CLI contains several updates. These are summarised in the following bullet points and further explained in their own sections below:
In the previous version, the CLI only supported authentication with your workspace credentials (`client_credentials` grant), which you would have configured when running the command `tru setup`.
With the new version (v1.0.5), we've replaced this with `tru login`. You will need to enter the Identity Provider of your choosing from Google, GitHub, or Microsoft. Using this new functionality, you don't need to find your credentials, but instead, use your trusted identity provider.
With the PhoneCheck and SubscriberCheck API updates to version 0.2, more configuration is required for the developer demo server, and the decision was made to remove this feature as a plugin for the CLI and keep it as an independent repository. If you still wish to continue using the developer demo server, please clone the repository on GitHub.
To install the CLI, you need npm (minimum version 14.0.0) installed locally on your machine; then in your Terminal, run the following command:
Before you can access anything with the CLI, you need to let it know who you are. You can log in with the following command, but be sure to choose the Identity Provider you chose when creating an account on tru.ID:
A workspace is a container for users' accounts and billing accounts. There are two different kinds of workspaces you can belong to, and these are:
You can view which workspaces you're a member of by running the command:
You will need to choose which one is to be the active workspace for your CLI with the following command:
A project is a method for applications to access tru.ID APIs. A project serves two purposes:
With the CLI, you can carry out three commands for projects. These are listed in the examples below:
For more information on how to set up your environment for using tru.ID APIs, please check out the Set up your Environment page on the tru.ID Developer Docs.