Configure Client-Initiated Backchannel Authentication

• Configurer le type d’octroi CIBA pour votre application
• Activer les canaux de notification pour votre application
• Configurer le canal de notification pour CIBA

​

Prérequis

​

Configurer le type d’octroi CIBA pour votre application

• Le client est un client de première partie, c.-à-d. que la propriété is_first_party est définie sur true.
• Le client est confidentiel et utilise un mécanisme d’authentification, c.-à-d. que la propriété token_endpoint_auth_method ne doit pas être définie sur none.
• Le client doit être conforme à OIDC, c.-à-d. que oidc_conformant doit être défini sur true. Il s’agit de la valeur par défaut pour tous les nouveaux clients.

• Auth0 Dashboard
• Management API

Pour configurer CIBA pour votre application dans l’Auth0 Dashboard :

1. Accédez à Applications > Applications dans l’Auth0 Dashboard.
2. Créez une application, puis activez Client Initiated Backchannel Authentication (CIBA) dans l’onglet Grant Types :

3. Cliquez sur Save Changes.

Pour configurer CIBA pour votre application à l’aide de la Management API, utilisez le point de terminaison Update a Client pour ajouter le type d’octroi urn:openid:params:grant-type:ciba à la liste des types d’octroi de l’objet client :

• Auth0 CLI
• cURL

Vous utilisez l’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 "clients/{YOUR_CLIENT_ID}" \
  --data '{
      "grant_types": [
          "authorization_code",
          "refresh_token",
          "urn:openid:params:grant-type:ciba"
      ]
  }'

curl --location --request PATCH 'https://{YOUR_DOMAIN}.auth0.com/api/v2/clients/{YOUR_CLIENT_ID}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_MANAGEMENT_API_ACCESS_TOKEN}' \
--data '{
    "grant_types": [
        "authorization_code",
        "refresh_token",
        "urn:openid:params:grant-type:ciba"
    ]
}'

Vous pouvez aussi utiliser notre bibliothèque SDK Go pour la Management API. Pour en savoir plus, consultez SDKs :

myClient := &Client{
    Name:        auth0.Stringf("CIBA-enabled-client"),
    Description: auth0.String("This is a CIBA enabled client."),
    GrantTypes:  &[]string{"urn:openid:params:grant-type:ciba"},
  }

  err := api.Client.Create(context.Background(), myClient)

​

Activez les canaux de notification pour votre application

• Notifications push mobiles : si vous définissez requested_expiry à une valeur de 300 secondes ou moins, CIBA utilise le canal de notification push mobile s’il est activé.
• Notifications par courriel : si vous définissez requested_expiry à une valeur comprise entre 301 et 259200 secondes (72 heures), CIBA utilise le canal de notification par courriel s’il est activé.

• Auth0 Dashboard
• Management API

Pour configurer le canal de notification de votre application dans l’Auth0 Dashboard :

• Accédez à Applications > Applications.
• Dans les paramètres de votre application, accédez à la section Client Initiated Backchannel Authentication (CIBA) et sélectionnez le ou les canaux de notification à activer.

Effectuez une requête PATCH vers le point de terminaison /api/v2/clients de votre application cliente et définissez les canaux de notification pour le flux CIBA.L’exemple de code suivant active le canal de notification guardian-push pour le flux CIBA :

• Auth0 CLI
• cURL

auth0 api patch "clients/{YOUR_CLIENT_ID}" \
  --data '{
      "async_approval_notification_channels":["guardian-push"]
  }'

curl -L --request PATCH 'https://{YOUR_DOMAIN}/api/v2/clients/{YOUR_CLIENT_ID}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H "Authorization: Bearer {YOUR_MANAGEMENT_API_ACCESS_TOKEN}" \
-d '{
    "async_approval_notification_channels":["guardian-push"]
}'

​

Configurer le canal de notification

• Configurer les notifications push sur mobile
• Configurer les notifications par courriel

​

Configurer les notifications push mobiles

• l’application Auth0 Guardian
• une application personnalisée intégrée au SDK Auth0 Guardian

• Activer les notifications push d’Auth0 Guardian
• Inscrire l’utilisateur autorisant à l’AMF au moyen de notifications push

​

Activer les notifications push d’Auth0 Guardian

• Sélectionnez Sécurité > Multi-factor Auth.
• Activez Notification push avec Auth0 Guardian. Cela peut nécessiter certains paramètres de configuration pour la MFA. Pour en savoir plus, consultez Configurer les notifications push pour la MFA.

• Pour Application de notification push, sélectionnez l’application de votre choix.

• Cliquez sur Enregistrer.

​

Inscrire l’utilisateur autorisant à l’authentification multifacteur au moyen des notifications push

​

Configurer les notifications par courriel

• Configurer votre fournisseur de courriel
• Configurer votre modèle de courriel pour utiliser le modèle Asynchronous Approval
• Vous assurer que l’utilisateur autorisant a une adresse courriel vérifiée

​

Configurez votre fournisseur de courriel

​

Configurez votre modèle de courriel

auth0 api post "email-templates" \
  --data '{"template":"async_approval","body":"{{application.name}} says click on {{url}}, binding message: {{binding_message}}","subject":"Action Required","syntax":"liquid","enabled":true,"from":""}'

curl -L "https://{YOUR_DOMAIN}.auth0.com/api/v2/email-templates" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H "Authorization: Bearer {YOUR_MANAGEMENT_API_ACCESS_TOKEN}" \
-d '{"template":"async_approval","body":"{{application.name}} says click on {{url}}, binding message: {{binding_message}}","subject":"Action Required","syntax":"liquid","enabled":true,"from":""}'

​

S’assurer que l’utilisateur qui autorise dispose d’une adresse courriel vérifiée

1. Accédez à User Management > Users et cliquez sur l’utilisateur.
2. Sous Email, l’utilisateur devrait avoir une adresse courriel vérifiée affichée.