Auth0 Supplemental Signals est actuellement en accès anticipé.En utilisant cette fonctionnalité, vous acceptez les modalités applicables de l’essai gratuit dans le Master Subscription Agreement d’Okta. Pour en savoir plus sur les phases de mise à disposition des produits Auth0, consultez Phases de mise à disposition des produits.

Avant de commencerPour configurer Akamai afin d’envoyer des signaux supplémentaires à votre tenant Auth0, vous devez d’abord configurer Akamai comme proxy inverse.

Si vous utilisez Akamai Bot Manager et/ou Akamai Account Protector, vous pouvez configurer votre proxy inverse dans Akamai pour envoyer les résultats à Auth0 et les utiliser dans des Actions. Auth0 prend actuellement en charge les flux de connexion suivants pour les signaux supplémentaires d’Akamai :

Universal Login : identifiant + mot de passe
- Universal Login : identifiant d’abord
- Resource Owner Password (ROP)

Étape 1 : Enregistrer une API dans Akamai

Afin qu’Akamai puisse déterminer si les tentatives de connexion réussissent ou échouent, vous devez enregistrer une API dans Akamai, puis définir un point de terminaison pour chaque flux de connexion Auth0 que vous souhaitez prendre en charge. Pour en savoir plus, consultez Register an API on Akamai TechDocs et Add API resources on Akamai TechDocs.

Utilisez les valeurs suivantes pour enregistrer votre API dans Akamai :

Propriété	Valeur
Chemin de base de l’API	`/u`
Emplacement de la clé d’API	`Header`

Après avoir créé votre API, vous devrez ajouter une ressource d’API pour chacun des points de terminaison Auth0 suivants :

/u/login/password
/u/signup
/u/signup/password

Le processus est le même pour tous les points de terminaison, mais les valeurs de configuration varient légèrement.

Ajouter une ressource d’API

Utilisez les valeurs suivantes pour configurer une ressource dans votre API Akamai :

/u/login/password
/u/signup
/u/signup/password

Propriété	Valeur
Paramètres d’API non définis	`Spécifique` (`Corps de la requête`)
Chemin	`/login/password`
Méthodes	`POST`

Propriété	Valeur
Paramètres d’API non définis	`Spécifique` (`Corps de la requête`)
Chemin	`/signup`
Méthodes	`POST`

Propriété	Valeur
Paramètres d’API non définis	`Spécifique` (`Corps de la requête`)
Chemin	`/signup/password`
Méthodes	`POST`

Ajouter des paramètres aux méthodes

Après avoir créé votre ressource API, vous devrez définir le paramètre Request body pour qu’Akamai puisse analyser correctement les requêtes de connexion.Utilisez les valeurs suivantes pour définir le paramètre Request body :

/u/login/password
/u/signup
/u/signup/password

Propriété	Valeur
Format	`JSON`
Obligatoire	`Oui`
Définir le format du corps	`Oui`
Détails du schéma	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "state"
          ],
          "properties": {
            "state": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "action": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}

Propriété	Valeur
Format	`JSON`
Obligatoire	`Oui`
Définir le format du corps	`Oui`
Détails du schéma	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email",
            "password"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}

Propriété	Valeur
Format	`JSON`
Obligatoire	`Oui`
Définir le format du corps	`Oui`
Détails du schéma	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256,
              "description": "email"
            }
          }
        }
      }
    },
    "required": true
  }
}

Utilisez les valeurs suivantes pour enregistrer votre API dans Akamai :

Propriété	Valeur
Chemin de base de l’API	`/u`
Emplacement de la clé d’API	`En-tête`

Après avoir créé votre API, vous devrez ajouter une ressource d’API pour chacun des points de terminaison Auth0 suivants :

/u/login
/u/signup
/u/signup/password

Le processus est le même pour tous les points de terminaison, mais les valeurs de configuration varient légèrement.

Ajouter une ressource d’API

Utilisez les valeurs suivantes pour configurer une ressource dans votre API Akamai :

/u/login
/u/signup
/u/signup/password

Propriété	Valeur
Paramètres d’API non définis	`Specific` (`Request body`)
Chemin	`/login`
Méthodes HTTP	`POST`

Propriété	Valeur
Paramètres d’API non définis	`Specific` (`Request body`)
Chemin	`/login/signup`
Méthodes HTTP	`POST`

Propriété	Valeur
Paramètres d’API non définis	`Specific` (`Request body`)
Chemin	`/signup/password`
Méthodes HTTP	`POST`

Ajouter des paramètres aux méthodes

/u/login
/u/signup
/u/signup/password

Propriété	Valeur
Format	`JSON`
Obligatoire	`Oui`
Définir le format du corps	`Oui`
Détails du schéma	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "state"
          ],
          "properties": {
            "state": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "action": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

Propriété	Valeur
Format	`JSON`
Obligatoire	`Oui`
Définir le format du corps	`Oui`
Détails du schéma	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email",
            "password"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

Propriété	Valeur
Format	`JSON`
Obligatoire	`Oui`
Définir le format du corps	`Oui`
Détails du schéma	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256,
              "description": "email"
            }
          }
        }
      }
    },
    "required": true
  }
}

ROP

Utilisez les valeurs suivantes pour enregistrer votre API dans Akamai :

Propriété	Valeur
Chemin de base de l’API	Aucune.
Emplacement de la clé d’API	`Header`

Après avoir créé votre API, vous devez ajouter une ressource d’API pour chacun des points de terminaison Auth0 suivants :

/oauth/token

Le processus est le même pour tous les points de terminaison, mais les valeurs de configuration diffèrent légèrement.

Ajouter une ressource d’API

Utilisez les valeurs suivantes pour configurer une ressource sur votre API Akamai :

/oauth/token

Propriété	Valeur
API undefined parameters	`Specific` (`Request body`)
Chemin	`/oauth/token`
Méthodes	`POST`

Ajouter des paramètres aux méthodes

Après avoir créé votre ressource d’API, vous devez définir le paramètre Request body afin qu’Akamai puisse analyser correctement les requêtes de connexion.Utilisez les valeurs suivantes pour définir le paramètre Request body :

/oauth/token

Propriété	Valeur
Format	`JSON`
Required	`Yes`
Define body format	`Yes`
Schema details	Voir ci-dessous.

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

Étape 2 : Transférer les résultats de bot d’Akamai vers Auth0

Pour configurer Akamai afin de transférer les résultats de bot vers Auth0, consultez la page Forward Bot Results to Origin on Akamai TechDocs.

L’en-tête akamai-user-risk peut ne pas être présent pour chaque requête de connexion, car Akamai n’envoie cet en-tête que lorsqu’il crée un score de risque utilisateur.

Étape 3 : Activer le traitement des en-têtes Akamai dans Auth0

Vous pouvez configurer Auth0 pour accepter les signaux supplémentaires envoyés par Akamai dans Auth0 Dashboard ou avec la Management API d’Auth0.

Dashboard
Management API

Pour activer les signaux supplémentaires dans le Dashboard :

Accédez à Dashboard > Security > Attack Protection.
Sélectionnez Supplemental Signals.
Activez le commutateur Enable Akamai headers.

Pour activer les signaux supplémentaires avec la Management API :

Obtenez un jeton d’accès pour la Management API avec la portée update:attack_protection.
Appelez le point de terminaison de la Management API Update the supplemental signals configuration for a tenant avec le corps de requête suivant :

{
  "akamai_enabled": true
}

Étape 4 : Tester et vérifier la configuration

Testez votre configuration en appelant chaque point de terminaison (endpoint) pour le ou les flux de connexion que vous avez configurés. Si vous avez tout configuré correctement :

Les en-têtes akamai-user-risk et akamai-bot seront présents dans les journaux de votre tenant pour les événements concernés.
Vous pouvez utiliser les propriétés suivantes dans l’objet event de l’Action post-login :
- authentication.riskAssessment.supplemental.akamai.akamaiBot
- authentication.riskAssessment.supplemental.akamai.akamaiUserRisk

Protégez votre Application

Appeler des API au nom de l’utilisateur

Protéger votre tenant

Conformité

Configurer Akamai pour envoyer des signaux supplémentaires

Étape 1 : Enregistrer une API dans Akamai

Ajouter une ressource d’API

Ajouter des paramètres aux méthodes

Étape 2 : Transférer les résultats de bot d’Akamai vers Auth0

Étape 3 : Activer le traitement des en-têtes Akamai dans Auth0

Étape 4 : Tester et vérifier la configuration

​Flux de connexion pris en charge

​Étape 1 : Enregistrer une API dans Akamai

​Ajouter une ressource d’API

​Ajouter des paramètres aux méthodes

​Ajouter une ressource d’API

​Ajouter des paramètres aux méthodes

​Ajouter une ressource d’API

​Ajouter des paramètres aux méthodes

​Étape 2 : Transférer les résultats de bot d’Akamai vers Auth0

​Étape 3 : Activer le traitement des en-têtes Akamai dans Auth0

​Étape 4 : Tester et vérifier la configuration

Flux de connexion pris en charge

Étape 1 : Enregistrer une API dans Akamai

Ajouter une ressource d’API

Ajouter des paramètres aux méthodes

Ajouter une ressource d’API

Ajouter des paramètres aux méthodes

Ajouter une ressource d’API

Ajouter des paramètres aux méthodes

Étape 2 : Transférer les résultats de bot d’Akamai vers Auth0

Étape 3 : Activer le traitement des en-têtes Akamai dans Auth0

Étape 4 : Tester et vérifier la configuration