Passer au contenu principal

Avant de commencer

Configurez un locataire Auth0.
Auth0 CLI est un outil en ligne de commande qui offre un accès direct à la Management API d’Auth0, ce qui vous permet de gérer votre locataire Auth0 depuis votre terminal. Il est conçu pour une utilisation interactive pendant le développement et peut être intégré à des scripts d’automatisation.
Pour consulter la référence complète des commandes CLI et obtenir des renseignements détaillés sur leur utilisation, consultez la documentation de référence d’Auth0 CLI.

​
Fonctionnalités clés

  • Gestion interactive : Créez, mettez à jour et gérez les ressources Auth0 à partir de la ligne de commande
  • Prise en charge de l’authentification : Plusieurs méthodes d’authentification, y compris l’authentification des utilisateurs et les identifiants machine à machine
  • Gestion des ressources : Opérations CRUD complètes pour les applications, les API, les connexions, les utilisateurs et plus encore
  • Multiplateforme : Disponible pour macOS, Linux et Windows
  • Sortie JSON : Sortie exploitable par des scripts et pour l’automatisation

​
Cas d’utilisation

Auth0 CLI est idéal pour :
  • Processus de développement : configurer rapidement les ressources Auth0 pendant le développement
  • Tests : créer des applications et des utilisateurs de test pour les tests automatisés
  • Débogage : inspecter et modifier la configuration d’Auth0 en temps réel
  • Scripts : automatiser les tâches répétitives à l’aide de scripts shell
  • Intégration CI/CD : intégrer la configuration d’Auth0 à vos pipelines de déploiement

​
Comparaison avec d’autres outils

​
Auth0 CLI vs Deploy CLI

  • Auth0 CLI : Gestion interactive des ressources, une commande à la fois. Idéal pour le développement et les tâches ponctuelles.
  • Deploy CLI : Gestion déclarative du locataire fondée sur des fichiers de configuration. Idéal pour gérer des configurations complètes de locataire dans plusieurs environnements.

​
Auth0 CLI vs Terraform Provider

  • Auth0 CLI : commandes impératives pour apporter des changements immédiats. Aucune gestion de l’état.
  • Terraform Provider : infrastructure as code déclarative avec suivi de l’état. Idéal pour gérer l’infrastructure de production.

​
Installer Auth0 CLI

​
macOS

Configurez avec Homebrew : 
brew tap auth0/auth0-cli
brew install auth0

​
Linux

curl -sSfL https://raw.githubusercontent.com/auth0/auth0-cli/main/install.sh | sh -s -- -b /usr/local/bin

​
Windows

Configurez avec Scoop : 
scoop bucket add auth0 https://github.com/auth0/scoop-auth0-cli.git
scoop install auth0
Ou téléchargez la dernière version depuis la page des versions de GitHub.

​
S’authentifier

Pour utiliser l’interface de ligne de commande Auth0, vous devez vous authentifier. Lorsque vous exécutez la commande suivante, une fenêtre du navigateur s’ouvre pour vous permettre de vous connecter à votre compte Auth0 : 
auth0 login
Pour vous authentifier à l’aide d’une application machine à machine, utilisez la commande suivante : 
auth0 login --domain <your-domain> --client-id <client-id> --client-secret <client-secret>

​
Commandes courantes

​
Gérer les applications

# Lister toutes les applications
auth0 apps list

# Créer une nouvelle application
auth0 apps create --name "My App" --type spa

# Afficher les détails de l'application
auth0 apps show <app-id>

# Mettre à jour une application
auth0 apps update <app-id> --callbacks "http://localhost:3000/callback"

# Supprimer une application
auth0 apps delete <app-id>

​
Gérer les API

# Lister toutes les API
auth0 apis list

# Créer une nouvelle API
auth0 apis create --name "My API" --identifier "https://my-api.example.com"

# Afficher les détails de l'API
auth0 apis show <api-id>

​
Gérer les utilisateurs

# Lister les utilisateurs
auth0 users list

# Créer un utilisateur
auth0 users create --email "user@example.com" --connection "Username-Password-Authentication"

# Afficher les détails de l'utilisateur
auth0 users show <user-id>

# Mettre à jour un utilisateur
auth0 users update <user-id> --email "newemail@example.com"

​
Gérer les paramètres du locataire

# Afficher le locataire actuel
auth0 tenants list

# Mettre à jour les paramètres du locataire
auth0 tenants update

​
Utilisation dans les scripts

L’interface de ligne de commande Auth0 prend en charge la sortie JSON pour en faciliter l’analyse dans les scripts : 
# Obtenir les détails de l'application en JSON
auth0 apps show <app-id> --json

# Créer une application et capturer la sortie
auth0 apps create --name "My App" --type spa --json > app-details.json

​
Documentation et soutien

Pour obtenir la documentation complète, la référence des commandes et des exemples, consultez :

​
Prochaines étapes

Deploy CLI

Apprenez à gérer la configuration du locataire avec Deploy CLI

Terraform Provider

Explorez l’infrastructure en tant que code avec Terraform

Management API

Accédez directement à la Management API d’Auth0