Contrat d'API de risque tiers

Modèle de demande de webhooks de stratégie d'accès

L'infrastructure de stratégie d'accès lit la valeur enabled pour le noeud de configuration. Si la valeur est false, elle ignore le traitement de la règle et n'appelle PAS l'intégration tierce. Sinon, la règle de stratégie d'accès est traitée et le noeud de configuration est traité.

En fonction du evaluationOutboundAttributes défini dans le noeud de configuration, le composant Verify interne envoie les données suivantes à la tierce partie via les webhooks. De cette façon, il peut obtenir le risque, ou les valeurs d'attribut prises en charge par le moteur de risque.

Exemple de modèle de données, que Verify envoie à la tierce partie (via l'API interne des webhooks) :

{
    "sessionContext": {
       ...
    },
    "attributeContext" :{
       ...
    },
    "policyContext" :{
       ...
    },
    "adaptiveContext" : {
        ...
    },
    "customAttributes" :  { 
        "customAttributeId1" : ["value"], 
        .. 
    },
    authnMethods : [...] 
}

Webhooks pour les modèles de réponse de stratégie d'accès

Lors de l'évaluation de l'objet de stratégie d'accès, après que le composant Verify interne a envoyé le contenu de données à la tierce partie via les webhooks, il reçoit la réponse de l'intégration tierce. La réponse inclut la version, les attributs pris en charge, les paires clé-valeur et le résultat.

Modèle de données de réponse, que Verify reçoit de l'intégration tierce :

{
    "version" :"some version",
    "result": { 
        "action" : "any one of the Verify access policy actions.",
        "message" : "Reason why this decision was returned.",
        "authnMethods" : ["List of Verify authentication factors which the third party requires the user to complete. It must be the same, or a subset of the authnMethods sent to the third party via webhooks in the request."],
        "redirectURI" : "Verify relative or absolute URL to redirect the browser when additional information is required." 
    },
    "attributes": {
        "attrName1" : "value",
        "attrNameN" : "value",
    },
}