> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une phase de lancement du produit";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>Cette fonctionnalité est offerte avec les forfaits {linkify(`${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Pour y participer, communiquez avec " + contact + ". "}
            {terms && <>En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit énoncées dans le {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} d’Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La fonctionnalité {feature} est en {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 PHP SDK v9" stage="beta" />

Le SDK Auth0 pour PHP fournit une classe `Auth0\SDK\API\Management`, qui regroupe les méthodes permettant d’accéder à la [Management API](https://auth0.com/docs/api/management/v2) 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](https://auth0.com/docs/api/management/v2) pour voir tout ce qu’il est possible de faire !

<div id="authentication">
  ## Authentification
</div>

Pour utiliser la <Tooltip tip="Un produit qui permet aux clients d’effectuer des tâches administratives." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Management+API">Management API</Tooltip>, 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](/docs/fr-ca/secure/tokens/access-tokens/management-api-access-tokens) 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](/docs/fr-ca/libraries/auth0-php/using-the-authentication-api-with-auth0-php).

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](https://auth0.com/docs/api/management/v2) 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](https://manage.auth0.com/#/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 :

```php lines theme={null}
$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.

<div id="example-search-users-by-email">
  ### Exemple - Rechercher des utilisateurs par courriel
</div>

Ce point de terminaison est documenté [ici](https://auth0.com/docs/api/management/v2#!/Users/get_users).

```php lines theme={null}
$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());
}
```

<div id="example-get-all-clients">
  ### Exemple - Obtenir tous les Clients
</div>

Ce point de terminaison est documenté [ici](https://auth0.com/docs/api/management/v2#!/Clients/get_clients).

```php lines theme={null}
$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());
}
```

<div id="learn-more">
  ## En savoir plus
</div>

* [Premiers pas avec Auth0-PHP](/docs/fr-ca/libraries/auth0-php)
* [Gérer le login, le logout et les profils utilisateur](/docs/fr-ca/libraries/auth0-php/auth0-php-basic-use)
* [Utiliser l’Authentication API](/docs/fr-ca/libraries/auth0-php/using-the-authentication-api-with-auth0-php)
* [Valider les JWT (JSON Web Tokens)](/docs/fr-ca/libraries/auth0-php/validating-jwts-with-auth0-php)
* [Résoudre les problèmes liés à votre intégration Auth0-PHP](/docs/fr-ca/libraries/auth0-php/troubleshoot-auth0-php-library)