Utiliser les signaux supplémentaires Akamai dans les Actions

Auth0 Supplemental Signals est actuellement en accès anticipé.En utilisant cette fonctionnalité, vous acceptez les conditions applicables de la période d’essai gratuite prévues dans la Convention principale d’abonnement d’Okta. Pour en savoir plus sur les phases de diffusion des produits Auth0, consultez la page Phases de diffusion des produits.

Avant de commencerPour utiliser les signaux supplémentaires Akamai dans les Actions, vous devez :

Si vous avez configuré Akamai comme serveur proxy inverse et l’avez paramétré pour envoyer des signaux supplémentaires à Auth0, vous pouvez utiliser les données fournies dans ces signaux dans les Actions Auth0.

Signaux supplémentaires pris en charge par déclencheur d’Action

Déclencheur	Objets de signaux supplémentaires	Objet d’événement
Connexion	`akamaiBot` `akamaiUserRisk`	`authentication.riskAssessment.supplemental.akamai`
Préinscription de l’utilisateur	Aucun	S.O.
Post-inscription de l’utilisateur	Aucun	S.O.
Envoyer un message téléphonique	Aucun	S.O.
Post-challenge	Aucun	S.O.
Post-changement de mot de passe	Aucun	S.O.
Échange d’identifiants	Aucun	S.O.

Schémas d’objets de signaux supplémentaires

Les objets akamaiBot et akamaiUserRisk contiennent plusieurs propriétés que vous pouvez utiliser pour personnaliser votre flux d’authentification.

object

Afficher attributs enfants

string

L’action dans les résultats du gestionnaire de robots Akamai.Exemple : Monitor

string[]

La catégorie du robot dans les résultats du gestionnaire de robots Akamai.Exemple : ["Web Search Engine Bots"]

number

Le score du robot dans les résultats du gestionnaire de robots Akamai.Exemple : 90

string

Le segment de réponse du score du robot dans les résultats du gestionnaire de robots Akamai.Exemple : aggressive

string

L’ID de botnet dans les résultats du gestionnaire de robots Akamai.Exemple : googlebot

string

Le type dans les résultats du gestionnaire de robots Akamai.Exemple : Akamai-Categorized Bot

object

Afficher attributs enfants

string

L’action de l’évaluation du risque utilisateur Akamai.Exemple : monitor

number

L’état d’autorisation de l’évaluation du risque utilisateur Akamai.Exemple : 0

string

Le domaine de courriel de l’utilisateur.Exemple : example.com

object

Le risque général de l’évaluation du risque utilisateur Akamai.Exemple : { aci: “0”, db: “Chrome 85”, di: “0fc91b5ec42f5a471c16a85e3e388ca57697c1a9”, do: “Mac OX X 10” }

string

L’OUID de l’utilisateur.Exemple : m534264

string

L’ID de requête de l’utilisateur.Exemple : 19e22e

object

Le risque de l’évaluation du risque utilisateur Akamai.Exemple : { ugp: “ie/M”, unp: “432/H” }

number

Le score de l’évaluation du risque utilisateur Akamai.Exemple : 0

number

L’état de l’évaluation du risque utilisateur Akamai.Exemple : 4

object

Le niveau de confiance de l’évaluation du risque utilisateur Akamai.Exemple :

{ udbp: "Chrome85", udfp: "25ba44ec3b391ba4ce5fbbd2979635e254775werwe", udop: "Mac OS X 10", ugp: "FR", unp: "12322", utp: "weekday_3" }

string

Le nom d’utilisateur de l’utilisateur.Exemple : testuser@example.com

string

L’UUID de l’évaluation du risque utilisateur Akamai.Exemple : 86b37525-8047-4a3c-8d7a-23e99666da05

Cas d’utilisation

Révoquer une session en fonction des résultats d’Akamai Account Protector

Voici un exemple de la façon dont vous pouvez révoquer une session en fonction de la propriété akamaiUserRisk.score :

exports.onExecutePostLogin = async (event, api) => {
  const userRiskHeader = event.authentication?.riskAssessment?.supplemental?.akamai?.akamaiUserRisk;
  if (userRiskHeader?.score && userRiskHeader?.score >= 90) {
        console.log('User is deemed high risk.');
        // This will revoke session cookies to deny login.
        api.session.revoke('Session revoked, User risk score is greater than 90.');
    }
};

Veuillez noter l’utilisation de la méthode api.session.revoke (par opposition à la méthode api.access.deny). L’utilisation de la méthode revoke garantit que si l’utilisateur rafraîchit l’application, les signaux supplémentaires d’Akamai sont envoyés avec la requête d’authentification et que le flux d’Action post-connexion est déclenché.

Demander l’authentification multifacteur (AMF) en fonction des résultats d’Akamai Bot Manager

Voici un exemple de la façon dont vous pouvez imposer l’AMF en fonction de la propriété akamaiBot.score.

Imposer l’AMF

Cette Action effectue deux tâches :

Mettre à jour les métadonnées d’application : Si la propriété score dépasse une valeur donnée, consignez que l’AMF est requise pour la session.
Exiger l’AMF : Si la propriété score dépasse une valeur donnée ou s’il existe un enregistrement dans les métadonnées d’application indiquant que l’AMF est requise pour la session, imposez l’AMF.

exports.onExecutePostLogin = async (event, api) => {
  const userRiskHeader = event.authentication?.riskAssessment?.supplemental?.akamai?.akamaiUserRisk;

  if (userRiskHeader?.score && userRiskHeader?.score >= 90) {
    console.log(`Setting app metadata for session id: ${event.session?.id}`);
    api.user.setAppMetadata(`mfa_required_${event.session?.id}`, true);
  }

  if (userRiskHeader?.score && userRiskHeader?.score >= 90 ||
      event.user.app_metadata[`mfa_required_${event.session?.id}`]) {
        console.log(`Requiring MFA FOR Session id: ${event.session?.id}`);
        api.multifactor.enable('any', {allowRememberBrowser: false});
  }
};

Nettoyer les métadonnées d’application

Cette Action supprime, des métadonnées d’application, les informations liées à l’AMF propres à une session après que l’utilisateur a réussi l’AMF.

exports.onExecutePostLogin = async (event, api) => {
  const mfaMethod = event.authentication?.methods.find((method) => {
    return method.name === 'mfa';
  });

  if (mfaMethod) {
    console.log(`Removing MFA requirement for session id: ${event.session?.id}`);
    api.user.setAppMetadata(`mfa_required_${event.session?.id}`, undefined);
  }
};

Protégez votre Application

Appeler des API au nom de l’utilisateur

Protéger votre tenant

Conformité

Utiliser les signaux supplémentaires Akamai dans les Actions

Signaux supplémentaires pris en charge par déclencheur d’Action

Schémas d’objets de signaux supplémentaires

Cas d’utilisation

Imposer l’AMF

Nettoyer les métadonnées d’application

​Signaux supplémentaires pris en charge par déclencheur d’Action

​Schémas d’objets de signaux supplémentaires

​Cas d’utilisation

​Imposer l’AMF

​Nettoyer les métadonnées d’application

Signaux supplémentaires pris en charge par déclencheur d’Action

Schémas d’objets de signaux supplémentaires

Cas d’utilisation

Imposer l’AMF

Nettoyer les métadonnées d’application