Introduzione agli aggiornamenti della CLI tru.ID

Il successo di IDlayr dipende dal successo di voi sviluppatori. Come precedentemente dichiarato, tutti i nostri strumenti per sviluppatori sono open-source e disponibili per voi. Il IDlayr CLI è uno di questi strumenti e oggi abbiamo rilasciato una nuova versione con diverse modifiche per rendere ancora più semplice l'implementazione dell'autenticazione basata su SIM con IDlayr.
Quali sono gli aggiornamenti?
L'ultima versione della CLI di IDlayr contiene diversi aggiornamenti. Questi sono riassunti nei punti seguenti e ulteriormente spiegati nelle rispettive sezioni:
- È stato aggiunto il supporto di oAuth2 per supportare la configurazione della CLI e l'autenticazione dell'account.
- Il `dev-server` è stato rimosso come funzione della CLI.
- `-workflow` è stato rimosso dai comandi di creazione di PhoneCheck (`phonechecks:create`) e SubscriberCheck (`subscriberchecks:create`).
Autenticazione
Nella versione precedente, la CLI supportava solo l'autenticazione con le credenziali dello spazio di lavoro (grant `client_credentials`), configurate durante l'esecuzione del comando `tru setup`.
Con la nuova versione (v1.0.5), abbiamo sostituito questa opzione con `tru login`. È necessario inserire l'Identity Provider scelto da Google, GitHub o Microsoft. Utilizzando questa nuova funzionalità, non è necessario trovare le proprie credenziali, bensì utilizzare il proprio fornitore di identità affidabile.
La rimozione del comando Dev-Server
Con il Controllo del telefono e Controllo abbonati Con l'aggiornamento delle API alla versione 0.2, sono necessarie ulteriori configurazioni per il server demo per sviluppatori e si è deciso di rimuovere questa funzione come plugin per la CLI e di mantenerla come repository indipendente. Se si desidera continuare a usare il server demo per sviluppatori, si può clonare il repository su GitHub.
Come posso utilizzare la CLI?
Installare
Per installare la CLI, è necessario che npm (versione minima 14.0.0) sia installato localmente sul vostro computer; quindi, nel vostro Terminale, eseguite il seguente comando:
Prima di poter accedere a qualsiasi cosa con la CLI, è necessario farle sapere chi si è. È possibile accedere con il seguente comando, ma assicurarsi di scegliere l'Identity Provider scelto al momento della creazione di un account su IDlayr:
Spazi di lavoro
A spazio di lavoro è un contenitore per gli account degli utenti e i conti di fatturazione. Esistono due tipi diversi di spazi di lavoro a cui si può appartenere, che sono:
- Se vi siete iscritti a IDlayr da soli, avrete uno spazio di lavoro creato per voi. Per impostazione predefinita, sarete i proprietari di questo spazio di lavoro, ovvero avrete il pieno controllo dei progetti e della fatturazione.
- Se vi siete iscritti a IDlayr tramite un invito da parte di un altro utente IDlayr, per impostazione predefinita vi unirete al suo spazio di lavoro con il livello di accesso che vi ha concesso, che può essere amministratore o spettatore. Inoltre, avrete anche uno spazio di lavoro separato di cui sarete proprietari.
È possibile visualizzare gli spazi di lavoro di cui si è membri eseguendo il comando:
È necessario scegliere quale sarà l'area di lavoro attiva per la CLI con il seguente comando:
Progetti
A progetto è un metodo per le applicazioni di accedere alle API di IDlayr. Un progetto ha due scopi:
- Per fornire le credenziali. Ogni utente all'interno dell'area di lavoro dovrà generare le proprie credenziali, eliminando la necessità di condividere le credenziali per un progetto.
- Per raggruppare logicamente le chiamate API. Avere progetti separati per scopi o applicazioni specifiche aumenta la sicurezza e migliora il monitoraggio dell'uso di ciascun progetto.
Con la CLI è possibile eseguire tre comandi per i progetti. Questi sono elencati negli esempi seguenti:
Per ulteriori informazioni su come configurare l'ambiente per l'utilizzo delle API di IDlayr, consultare il documento Impostare l'ambiente pagina sul sito Documenti per gli sviluppatori di IDlayr.