Utiliser la Management API

Accédez à la Management API d’Auth0 en PHP à l’aide de la classe Management du SDK pour rechercher des utilisateurs, gérer des applications et effectuer des opérations sur le tenant.

Le SDK Auth0 pour PHP fournit une classe Auth0\SDK\API\Management, qui regroupe les méthodes permettant d’accéder à la Management API et d’effectuer des opérations sur votre tenant Auth0. Avec cette interface, vous pouvez facilement :

• Rechercher et créer des utilisateurs
• Créer et mettre à jour des applications
• Récupérer des entrées de journal
• Gérer des Rules

… et bien plus encore. Consultez notre référence de l’API pour voir tout ce qu’il est possible de faire !

​

Authentification

Pour utiliser la Management API, vous devez vous authentifier de l’une des deux façons suivantes :

• Pour un accès temporaire ou pour faire des tests, vous pouvez générer manuellement un jeton d’API et l’enregistrer dans votre fichier .env.
• Pour un accès prolongé, vous devez créer et exécuter un Client Credentials Grant lorsque l’accès est requis. Ce processus est détaillé sur la page de l’Authentication API.

Quelle que soit la méthode, le jeton généré doit avoir les scopes requis pour les opérations que votre application doit exécuter. Consultez la documentation de l’API pour connaître les scopes requis pour le point de terminaison précis auquel vous essayez d’accéder.

Pour accorder les scopes nécessaires :

1. Accédez à APIs > Auth0 Management API > onglet Machine to Machine Applications.
2. Repérez votre application et autorisez-la.
3. Cliquez sur la flèche pour développer la ligne et sélectionnez les scopes requis.

Vous pouvez maintenant vous authentifier de l’une des deux façons ci-dessus et utiliser ce jeton pour effectuer des opérations :

$management = new \Auth0\SDK\API\Management\Wrapper\ManagementClient(
    new \Auth0\SDK\API\Management\Wrapper\ManagementClientOptions(
        domain: $_ENV['AUTH0_DOMAIN'],
        clientId: $_ENV['AUTH0_CLIENT_ID'],
        clientSecret: $_ENV['AUTH0_CLIENT_SECRET'],
    ),
);

Le ManagementClient expose les points de terminaison en tant que propriétés (par exemple, $management->users et $management->clients). Les résultats sont renvoyés sous forme d’objets typés — vous récupérez les valeurs en appelant des méthodes nommées (comme getEmail() ou getName()) plutôt qu’en désérialisant un array brut.

​

Exemple - Rechercher des utilisateurs par courriel

Ce point de terminaison est documenté ici.

$users = $management->users->list(
    new \Auth0\SDK\API\Management\Users\Requests\ListUsersRequestParameters([
        'q'             => 'email:j*',
        'perPage'       => 5,
        'includeTotals' => true,
    ]),
);

foreach ($users as $user) {
    printf("%s <%s> - %s\n", $user->getNickname() ?? 'No nickname', $user->getEmail() ?? 'No email', $user->getUserId());
}

​

Exemple - Obtenir tous les Clients

Ce point de terminaison est documenté ici.

$clients = $management->clients->list(
    new \Auth0\SDK\API\Management\Clients\Requests\ListClientsRequestParameters([
        'perPage'       => 5,
        'includeTotals' => true,
    ]),
);

foreach ($clients as $client) {
    printf("%s - %s\n", $client->getName(), $client->getClientId());
}

​

En savoir plus

• Premiers pas avec Auth0-PHP
• Gérer le login, le logout et les profils utilisateur
• Utiliser l’Authentication API
• Valider les JWT (JSON Web Tokens)
• Résoudre les problèmes liés à votre intégration Auth0-PHP