Passer au contenu principal

Aperçu

Découvrez comment :
  1. Explorer la configuration actuelle de vos API
  2. Créer de nouvelles définitions d’API avec les scopes appropriés
  3. Mettre en œuvre une logique d’autorisation personnalisée avec Auth0 Actions
  4. Déployer et tester votre système d’autorisation
  5. Surveiller et affiner vos règles d’autorisation

Avant de commencer

  1. Créez un compte Auth0 avec des droits d’administrateur
  2. Installez Auth0 MCP Server et intégrez-le à Claude Desktop
Utilisez des interactions en langage naturel avec Auth0 MCP Server pour configurer et gérer rapidement un système complet d’autorisation d’API. En tirant parti de la capacité de Claude à interagir avec Auth0 au moyen du Model Context Protocol, vous pouvez mettre en œuvre des modèles d’autorisation complexes en quelques minutes plutôt qu’en quelques heures.

Étape 1 : Explorer la configuration actuelle de l’API

Avant de créer de nouvelles API, il est important de comprendre ce qui est déjà configuré dans votre locataire. Avec Auth0 MCP Server, vous pouvez obtenir rapidement ces informations en langage naturel. Demandez à Claude :
Montre-moi tous les serveurs de ressources (API) actuellement configurés dans mon locataire Auth0.
Claude utilisera l’outil auth0_list_resource_servers pour récupérer et afficher vos API existantes. Vous obtenez ainsi un aperçu rapide de l’ensemble de vos API, sans avoir à parcourir l’.

Étape 2 : Créer de nouvelles définitions d’API

Maintenant que vous comprenez votre configuration actuelle, vous pouvez créer de nouvelles API pour votre architecture de microservices. Au lieu de configurer chaque API séparément dans l’Auth0 Dashboard, vous pouvez les définir toutes en une seule fois. Demandez à Claude :
Je dois créer trois nouvelles API pour nos microservices :
1. Une API d'inventaire avec des scopes de lecture et d'écriture
2. Une API de commandes avec des scopes de lecture et d'écriture
3. Une API de clients avec des scopes de lecture, d'écriture et d'administration

Chaque API doit appliquer la validation des scopes.
Claude utilisera l’outil auth0_create_resource_server plusieurs fois pour configurer ces API.

Étape 3 : Mettre en œuvre la logique d’autorisation

Une fois vos API définies, vous devrez mettre en œuvre une logique d’autorisation personnalisée. Avec Auth0 MCP Server, vous pouvez décrire vos règles métier en langage naturel, et Claude générera le code Auth0 Actions approprié. Demandez à Claude :
Crée une Action qui applique les règles d'autorisation suivantes :
1. Vérifie que l'application requérante possède les scopes appropriés pour l'API à laquelle elle accède.
2. Pour l'API customers, les requêtes utilisant le scope admin doivent provenir uniquement de nos plages d'adresses IP internes (10.0.0.0/8 et 172.16.0.0/12).
3. Consigne toutes les décisions d'autorisation à des fins d'audit.
Claude utilisera l’outil auth0_create_action pour générer le code approprié et créer une Action.

Étape 4 : Déployer l’Action d’autorisation

Une fois que le code de l’Action vous convient, vous pouvez la déployer dans votre environnement de production au moyen d’une simple instruction. Demandez à Claude :
Deploy this action to run during the token issuance process.
Claude utilisera l’outil auth0_deploy_action pour déployer l’Action.

Étape 5 : Configurer les applications clientes

Ensuite, vous devrez configurer vos applications clientes pour accéder aux API appropriées avec les scopes requis. Demandez à Claude :
Create an 'inventory-manager' application on my Auth0 tenant and update the app to access the inventory and orders APIs with read and write permissions, but not the customers API.
Claude utilisera d’abord auth0_get_application pour récupérer la configuration actuelle, puis auth0_update_application pour la modifier.

Étape 6 : Vérifier la configuration

Pour vous assurer que votre système d’autorisation fonctionne correctement, vous pouvez consulter les journaux afin de repérer tout problème d’autorisation. Demandez à Claude :
Check the logs for any failed API access attempts in the last hour. Focus on authorization failures.
Claude utilisera auth0_list_logs pour trouver les entrées de journal pertinentes.

Étape 7 : Affinez les règles d’autorisation

D’après l’analyse des journaux, vous devrez peut-être affiner vos règles d’autorisation. Par exemple, vous devrez peut-être autoriser l’accès à d’autres plages d’adresses IP. Demandez à Claude :
Update the authorization action to also allow requests from our development VPN range 192.168.100.0/24.
Claude utilisera auth0_get_action pour récupérer le code actuel de l’Action, puis auth0_update_action pour le modifier. Enfin, Claude utilisera auth0_deploy_action pour déployer l’Action mise à jour.

Conclusion

En utilisant Auth0 MCP Server avec Claude, vous avez mis en place un système complet d’autorisation pour les API en :
  • créant plusieurs définitions d’API avec les scopes appropriés
  • mettant en œuvre une logique d’autorisation personnalisée avec des restrictions fondées sur l’adresse IP
  • configurant des applications clientes pour accéder à des API précises
  • surveillant et en affinant vos règles d’autorisation
Cette approche en langage naturel vous fait non seulement gagner du temps, mais vous permet aussi d’appliquer les pratiques exemplaires en matière de sécurité sans avoir une expertise approfondie du système Actions d’Auth0 ni de la syntaxe des requêtes de journaux.

Prochaines étapes

  • Implémentez des règles d’autorisation supplémentaires en fonction des attributs des utilisateurs
  • Mettez en place une surveillance régulière des journaux pour l’analyse de sécurité
  • Créez des tableaux de bord personnalisés pour visualiser les tendances d’utilisation de l’API