Auth0 CLI

Découvrez comment utiliser Auth0 CLI pour gérer la configuration de votre tenant, automatiser des tâches et intégrer Auth0 à vos flux de travail de développement et de déploiement.

Avant de commencer

Configurez un tenant Auth0.

Auth0 CLI est un outil en ligne de commande qui offre un accès direct à l’Auth0 Management API, ce qui vous permet de gérer votre tenant Auth0 depuis votre terminal. Il est conçu pour une utilisation interactive pendant le développement et peut aussi être intégré à des scripts d’automatisation.

Pour consulter la référence complète des commandes CLI et des renseignements détaillés sur son utilisation, lisez 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, notamment la connexion des utilisateurs et les identifiants de machine à machine
• Gestion des ressources : Opérations CRUD complètes pour les applications, les API, les connexions, les utilisateurs, et plus encore
• Multiplateforme : Disponible sur macOS, Linux et Windows
• Sortie JSON : Sortie exploitable par des scripts et des outils d’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 avec des 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 tenant à l’aide de fichiers de configuration. Idéal pour gérer la configuration complète d’un tenant dans plusieurs environnements.

​

Auth0 CLI vs Terraform Provider

• Auth0 CLI : Commandes impératives pour des modifications immédiates. Sans 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 l’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

Configurer avec Scoop :

scoop bucket add auth0 https://github.com/auth0/scoop-auth0-cli.git
scoop install auth0

Ou téléchargez la version la plus récente sur la page des versions de GitHub.

​

S’authentifier

Pour utiliser l’Auth0 CLI, 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 au moyen 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 "[e-mail]" --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 "[e-mail]"

​

Gérer les paramètres du tenant

# Afficher le tenant actuel
auth0 tenants list

# Mettre à jour les paramètres du tenant
auth0 tenants-settings update set [flags]

​

Utilisation dans des scripts

L’Auth0 CLI prend en charge la sortie JSON pour faciliter l’analyse par des 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

​

Utiliser le mode Agent

Le mode Agent rend le comportement de la CLI prévisible pour qu’un agent d’IA puisse la piloter sans supervision. Activez-le à l’aide de l’option --agent-mode ou de la variable d’environnement AUTH0_AGENT_MODE :

auth0 apps list --agent-mode

AUTH0_AGENT_MODE=true auth0 apps list

Le mode Agent active la sortie JSON structurée, désactive les invites interactives et la couleur, et garantit un code de sortie non nul en cas d’échec. Dans la plupart des cas, il n’est pas nécessaire de l’activer explicitement : l’interface de ligne de commande (CLI) détecte quand elle ne communique pas avec un terminal interactif (par exemple, lorsqu’elle est exécutée par Claude Code, Cursor ou une tâche d’intégration continue) et applique automatiquement le même comportement.

Par défaut, le mode Agent produit une sortie JSON indentée. Pour les Workflows à volume élevé ou sensibles au nombre de jetons, ajoutez l’option --json-compact pour obtenir les mêmes données sans les espaces superflus :

auth0 apps list --agent-mode --json-compact

En mode Agent, les commandes de diffusion en continu, comme auth0 logs tail, utilisent toujours le format compact.

​

Découvrir l’ensemble des commandes

Un agent peut cartographier toute la CLI en un seul appel, plutôt que de parcourir --help niveau par niveau :

auth0 commands --flat

Ajoutez --detailed pour inclure les options, les arguments et les valeurs par défaut de chaque commande, et pour savoir si elle requiert une authentification.

​

Vérifier la structure d’une charge utile avant de l’envoyer

--schema affiche la charge utile de requête attendue par une commande, telle que définie dans la spécification OpenAPI :

auth0 apps create --schema

--data envoie la charge utile sous la forme d’un seul objet JSON et la valide localement avant que la requête n’atteigne l’API :

# Avec du JSON intégré :
auth0 apps create --data '{"name":"My App","app_type":"spa"}'

# Avec du JSON provenant d'un fichier :
auth0 apps create --data @app.json

# Avec du JSON transmis par `stdin`
jq .example app.json | auth0 apps create

​

Erreurs structurées

En mode Agent, chaque échec renvoie une enveloppe d’erreur JSON plutôt qu’un message en texte brut :

{
  "error": {
    "code": "validation",
    "reason": "local_validation",
    "message": "...",
    "details": [
      {
        "field": "name",
        "reason": "property \"name\" is missing"
      }
    ]
  }
}

L’objet error contient :

• code, la catégorie d’échec. Les valeurs possibles sont usage, auth, validation, not_found, rate_limit, conflict, network, api et unknown (la valeur par défaut lorsqu’aucune valeur plus précise ne s’applique).
• reason, une catégorie d’échec plus précise. La liste des valeurs possibles de reason n’est pas exhaustive — elle s’allonge à mesure que le CLI fournit des détails d’échec plus fins —, alors considérez code comme le contrat stable et reason comme un contexte supplémentaire.
• details, des renseignements au niveau des champs lorsqu’une charge utile ne passe pas la validation.

Un agent peut ainsi orienter son traitement selon ces valeurs plutôt que d’analyser une phrase.

​

Rechercher dans la documentation depuis le terminal

auth0 docs search interroge la documentation publique d’Auth0 sans quitter le terminal et sans exiger d’authentification :

auth0 docs search "organizations"

En mode Agent, les résultats comprennent des URL vers le Markdown brut qu’un agent peut récupérer directement.

​

Documentation et soutien

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

• Référentiel GitHub d’Auth0 CLI
• Documentation d’Auth0 CLI

​

Prochaines étapes

Deploy CLI

Découvrez comment gérer la configuration du tenant à l’aide du Deploy CLI

Terraform Provider

Découvrez l’infrastructure-as-code avec Terraform

Management API

Accédez directement à Auth0 Management API