Accorder à une organisation un accès par application

Auth0 vous permet d’accorder à des applications l’accès à une organisation afin de contrôler les applications auxquelles les membres de cette organisation peuvent se connecter. Par défaut, les organisations utilisent un modèle d’accès implicite selon lequel les membres peuvent accéder à toute application qui :

a activé Auth0 Organizations
- possède une connexion active configurée

Lorsque vous activez l’accès par application pour une organisation, seuls les membres peuvent accéder aux applications que vous autorisez explicitement. Vous configurez l’accès par application pour chaque organisation. Lorsque vous l’activez pour une organisation, les autres organisations de votre tenant ne sont pas touchées.

Avant de commencer

Pour configurer l’accès par application :

Votre jeton Management API doit disposer des scopes suivants : update:organizations et create:organization_clients.
Auth0 Organizations doit être activé pour votre application.
Configurez votre application pour utiliser les types d’autorisation authorization_code ou implicit. Les applications qui n’utilisent pas ces types d’autorisation peuvent être associées à une organisation, mais le paramètre Accès des membres n’a aucun effet sur la connexion.
En accès anticipé, chaque organisation prend en charge jusqu’à 100 associations avec des applications destinées aux utilisateurs.

Activer l’accès par application

Lorsque vous activez l’accès par application pour une organisation, vous faites passer l’organisation d’un contrôle d’accès implicite à un contrôle d’accès explicite. Les membres ne peuvent se connecter qu’aux applications auxquelles vous avez explicitement accordé l’accès. Vous pouvez préconfigurer des autorisations d’application avant d’activer le contrôle d’accès. Auth0 enregistre les autorisations que vous ajoutez lorsque l’accès par application est désactivé; elles prennent effet lorsque vous l’activez. Lorsque l’accès par application est activé, Auth0 bloque les applications propriétaires sans autorisation explicite. Les applications tierces sans autorisation explicite continuent de suivre la politique d’accès aux applications tierces de l’organisation. Pour déroger à cette politique pour une application tierce précise, ajoutez-la à la liste et définissez directement son Accès des membres.

Auth0 Dashboard
Management API

Accédez à Auth0 Dashboard > organisations et sélectionnez l’organisation.
Sélectionnez l’onglet Applications.
Activez la bascule Accès par application.
Sélectionnez Enregistrer.

Effectuez une requête PATCH au endpoint Mettre à jour une organisation en définissant is_app_entitlement_active sur true.

Auth0 CLI
cURL

Vous utilisez Auth0 CLI ? Si ce n’est pas déjà fait, configurez et authentifiez votre session CLI avant d’exécuter cette commande.

auth0 api patch "organizations/ORG_ID" \
  --data '{
    "is_app_entitlement_active": true
  }'

cURL

curl --request PATCH \
  --url 'https://YOUR_DOMAIN/api/v2/organizations/ORG_ID' \
  --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "is_app_entitlement_active": true
  }'

Paramètre	Description
`is_app_entitlement_active`	Détermine si l’accès explicite par application est appliqué pour cette organisation. Définissez-le sur `true` pour l’activer. La valeur par défaut est `false`.

Accorder l’accès à une application

Lorsque vous ajoutez une application à une organisation, le paramètre Accès des membres vous permet de contrôler si les membres peuvent se connecter au moyen de cette application.

Auth0 Dashboard
Management API

Accédez à Auth0 Dashboard > organisations et sélectionnez l’organisation.
Sélectionnez l’onglet Applications.
Sélectionnez + Add Application.
Recherchez et sélectionnez l’application.
Activez Accès des membres pour permettre aux membres de l’organisation de se connecter au moyen de cette application.
Sélectionnez Save.

Pour modifier l’accès des membres pour une association d’application existante, activez ou désactivez la bascule Accès des membres dans la table des applications, puis sélectionnez Save.Consultez la colonne Authentication pour déterminer si l’application prend en charge la connexion des utilisateurs. Si les types d’autorisation d’une application n’incluent pas authorization_code ou implicit, Authentication affiche Not applicable et la bascule Accès des membres est désactivée. Pour activer l’accès des membres pour cette application, mettez à jour ses types d’autorisation dans les paramètres de l’application.Les applications tierces (strict) peuvent également être ajoutées et s’affichent dans la table avec l’étiquette Third-party. L’ajout d’une application tierce et l’activation de Accès des membres remplacent la politique accès aux applications tierces de l’organisation pour cette application précise.

Effectuez une requête POST vers le endpoint Create Organization Client Associations. Vous pouvez ajouter jusqu’à 10 applications par requête, pour un maximum de 100 par organization.

Auth0 CLI
cURL

auth0 api post "organizations/ORG_ID/clients" \
  --data '{
    "clients": [
      {
        "client_id": "YOUR_CLIENT_ID",
        "use_for_member_access": true
      }
    ]
  }'

cURL

curl --request POST \
  --url 'https://YOUR_DOMAIN/api/v2/organizations/ORG_ID/clients' \
  --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "clients": [
      {
        "client_id": "YOUR_CLIENT_ID",
        "use_for_member_access": true
      }
    ]
  }'

Parameter	Description
`client_id`	Le Client ID de l’application à associer à l’organisation.
`use_for_member_access`	Lorsque la valeur est `true`, les membres de l’organisation peuvent se connecter au moyen de cette application lorsque l’accès par application est activé. Ne s’applique qu’aux applications dont les types d’autorisation sont `authorization_code` ou `implicit`. La valeur par défaut est `false`.

Vous pouvez associer des applications machine-to-machine à une organisation et définir use_for_member_access, mais cela n’a aucun effet sur la connexion des membres. Vous pouvez préconfigurer cette valeur avant de convertir l’application en un type destiné aux utilisateurs.

Révoquer l’accès à une application

Auth0 Dashboard
Management API

Accédez à Auth0 Dashboard > Organizations et sélectionnez l’organisation.
Sélectionnez l’onglet Applications.
Dans le menu de dépassement (…) à côté de l’application, sélectionnez Remove.

Effectuez une requête DELETE au endpoint Delete Organization Client Associations. Vous pouvez supprimer jusqu’à 10 applications par requête. L’opération est idempotente : la suppression d’une association inexistante ne renvoie pas d’erreur.

Auth0 CLI
cURL

auth0 api delete "organizations/ORG_ID/clients" \
  --data '{
    "clients": [
      { "client_id": "YOUR_CLIENT_ID" }
    ]
  }'

cURL

curl --request DELETE \
  --url 'https://YOUR_DOMAIN/api/v2/organizations/ORG_ID/clients' \
  --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "clients": [
      { "client_id": "YOUR_CLIENT_ID" }
    ]
  }'

Répertorier les applications d’une organisation

Utilisez l’Management API pour récupérer toutes les applications associées à une organisation, y compris le statut d’accès des membres pour chacune d’elles.

Auth0 CLI
cURL

auth0 api get "organizations/ORG_ID/clients"

cURL

curl --request GET \
  --url 'https://YOUR_DOMAIN/api/v2/organizations/ORG_ID/clients' \
  --header 'Authorization: Bearer YOUR_MANAGEMENT_API_TOKEN'

La réponse inclut chaque application associée et sa valeur use_for_member_access. Elle utilise la pagination par curseur.

Limites

Chaque organisation prend en charge jusqu’à 100 associations d’applications destinées aux utilisateurs en accès anticipé. Cette limite s’applique aux applications dont le type est admissible à use_for_member_access (SPA, application Web régulière, native). Les limites d’association machine à machine sont susceptibles de changer pendant l’accès anticipé.
Les paramètres au niveau de la connexion et du client ne peuvent pas contourner l’application des contrôles d’accès par application. Les applications tierces qui ne sont pas explicitement répertoriées dans l’onglet Applications d’une organisation ne sont pas assujetties aux contrôles d’accès par application — elles continuent de suivre la politique d’accès aux applications tierces de l’organisation.

Quickstarts

Auth0 Overview

Configure Auth0

Applications

Accorder à une organisation un accès par application

Avant de commencer

Activer l’accès par application

Accorder l’accès à une application

Révoquer l’accès à une application

Répertorier les applications d’une organisation

Limites

En savoir plus

Avant de commencer

​Activer l’accès par application

​Accorder l’accès à une application

​Révoquer l’accès à une application

​Répertorier les applications d’une organisation

​Limites

​En savoir plus

Activer l’accès par application

Accorder l’accès à une application

Révoquer l’accès à une application

Répertorier les applications d’une organisation

Limites

En savoir plus