Configurer votre application pour l’accès M2M

Découvrez comment configurer votre application pour l’accès M2M à l’aide de l’Auth0 Dashboard et de la Management API.

Auth0 vous permet d’autoriser l’accès machine à machine (M2M) à vos applications. Une fois que vous créez une application dans Auth0, configurez-la pour l’accès machine à machine :

1. Définir le comportement de l’organisation pour chaque API auquel vous devez accéder.
2. Si l’application doit seulement accéder à certaines organisations, c’est-à-dire pas à toutes, Configurer l’accès machine à machine pour chaque API auquel vous devez accéder pour ces organisations précises.

​

Définir le comportement de l’organisation

Vous pouvez configurer la manière dont votre application utilise Organizations pendant le Client Credentials Flow pour chaque API, par exemple si l’application doit utiliser une organisation ou si elle peut accéder à n’importe quelle organisation, ou uniquement à celles auxquelles elle est explicitement associée.

Le tableau suivant explique les champs servant à définir le comportement de l’organisation pour l’accès M2M :

​

Tableau du comportement de l’organisation

Champ	Description	Mappage API
Prise en charge des organisations	Détermine comment cette application peut utiliser des organisations lorsqu’elle accède au moyen du Client Credentials Flow. Les options comprennent : Aucune : L’application ne doit pas utiliser d’organisations. Il s’agit de la valeur par défaut. Facultatif : L’application peut décider d’utiliser ou non une organisation. Obligatoire : L’application doit utiliser une organisation.	Prise en charge des organisations correspond à organization_usage. Options : Aucune correspond à deny Facultatif correspond à allow Obligatoire correspond à required
Autoriser l’accès machine à machine à n’importe quelle organisation	Détermine si cette application peut accéder à n’importe quelle organisation ou si elle est limitée à un ensemble d’organisations explicitement associées lorsqu’elle utilise le Client Credentials Flow. Par défaut, ce comportement n’est pas autorisé. Avertissement : Activer l’accès machine à machine à n’importe quelle organisation permet à l’application d’accéder à toute organisation sans y être explicitement associée. Cette option ne devrait être activée que pour des applications internes de confiance.	Autoriser l’accès machine à machine à n’importe quelle organisation correspond à allow_any_organization. Options : Coché correspond à true Décoché correspond à false

L’option Autoriser l’accès machine à machine à n’importe quelle organisation n’est pas offerte pour les applications tierces. Les applications tierces exigent toujours une autorisation client explicite pour chaque organisation. Pour en savoir plus, consultez Activer l’accès d’une application tierce à une organisation.

​

Définir le comportement de l’organisation pour une application

Pour définir le comportement de l’organisation pour une application, utilisez l’Auth0 Dashboard ou la Management API.

Auth0 Dashboard

Pour une application machine à machine, définissez le comportement de l’organisation dans l’Auth0 Dashboard :

1. Accédez à Auth0 Dashboard > Applications, puis sélectionnez l’application pour laquelle vous voulez configurer Organizations.
2. Sélectionnez l’onglet APIs et développez les détails de client_grant pour l’API à laquelle vous souhaitez configurer l’accès.
3. Configurez les paramètres appropriés comme indiqué dans le tableau du comportement de l’organisation.
4. Sélectionnez Save.

Sinon, s’il ne s’agit pas d’une application machine à machine :

1. Accédez à Auth0 Dashboard > APIs, puis sélectionnez l’API pour laquelle vous voulez configurer l’accès à Organizations.
2. Sélectionnez l’onglet Machine-to-Machine Applications. Il affiche toutes les applications, et pas seulement les applications machine à machine. Repérez votre application.
3. Pour autoriser l’accès, sélectionnez la bascule de votre application. Ensuite, sélectionnez votre application pour afficher les détails de configuration.
4. Configurez les paramètres appropriés comme indiqué dans le tableau du comportement de l’organisation.
5. Sélectionnez Save.

Management API

Vous pouvez aussi définir le comportement de l’organisation pour une application à l’aide de la Management API. L’objet client_grant contrôle l’accès de votre application à une API, et vous devez configurer le client_grant pour chaque API à laquelle votre application doit accéder. Pour configurer le client_grant pour l’accès M2M, utilisez les points de terminaison Create client grant ou Update client grant, ainsi que le tableau du comportement de l’organisation, pour mettre à jour les paramètres appropriés.

L’exemple de code suivant crée un objet client_grant avec un accès M2M :

L’exemple de code suivant met à jour un objet client_grant avec un accès M2M :

​

Définir l’organisation par défaut

Certains clients ne prennent pas en charge les champs non standards dans le Client Credentials Flow. Ils ne peuvent donc pas envoyer le paramètre organization requis au point de terminaison /oauth/token. Pour ces clients, vous pouvez définir une organisation par défaut qui s’applique automatiquement à toute requête Client Credentials provenant de l’application lorsque none est spécifié et que la prise en charge des organisations est required par l’API.

L’organisation par défaut s’applique lorsque organization_usage=require pour l’API (c.-à-d. l’audience cible).

Le tableau suivant décrit les champs permettant de définir une organisation par défaut pour l’accès machine-to-machine :

​

Tableau de définition de l’organisation par défaut

Champ	Description	mappage API
Organisation par défaut pour l’accès machine à machine	Définit l’organisation à appliquer aux requêtes Client Credentials qui ne contiennent pas d’organisation	Organisation par défaut pour l’accès machine à machine correspond à l’objet default_organization avec les propriétés suivantes : organization_id : l’ID de l’organisation à utiliser flows : le flux d’authentification à utiliser pour l’organisation par défaut. Ce paramètre est masqué dans l’UI et prend par défaut la valeur ["client_credentials"]

​

Définir l’organisation par défaut pour une application

Pour définir l’organisation par défaut pour une application, utilisez l’Auth0 Dashboard ou la Management API.

Auth0 Dashboard

Pour activer une organisation par défaut pour une application dans l’Auth0 Dashboard :

1. Accédez à Auth0 Dashboard > Applications, puis sélectionnez l’application que vous souhaitez configurer.
2. Sélectionnez l’onglet Organizations.
3. Configurez les paramètres appropriés comme expliqué dans le tableau de définition de l’organisation par défaut.
4. Sélectionnez Save.

Management API

Vous pouvez configurer l’organisation par défaut pour une application à l’aide des points de terminaison Create a client ou Update a client. La seule valeur de flux actuellement prise en charge est client_credentials.

L’exemple de code suivant met à jour un client pour lui attribuer une organisation par défaut :