サード・パーティー・リスク API 規約

アクセス・ポリシー Webhook 要求モデル

アクセスポリシーフレームワークは、configノードの値 enabled を読み取ります。 false値がの場合、そのルールの処理はスキップされ、サードパーティ製連携は呼び出されません。 それ以外の場合は、アクセスポリシールールが処理され、configノードが処理されます。

内部 Verify コンポーネントは、構成ノードで定義された evaluationOutboundAttributes に基づいて、Webhook を介してサード・パーティーに以下のデータを送信します。 これによりリスクを取得するか、リスク・エンジンからサポートされる属性値を取得できます。

Verify が (Webhook 内部 API を使用して) サード・パーティーに送信するデータ・モデルのサンプル:

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

アクセス・ポリシー応答モデルの Webhook

アクセス・ポリシー・オブジェクトの評価中に、Verify 内部コンポーネントは Webhook を介してサード・パーティーにデータ・ペイロードを送信した後、サード・パーティー統合から応答を受信します。 応答には、バージョン、サポートされる属性、キーと値のペア、および結果が含まれます。

Verify がサード・パーティー統合から受け取る応答データ・モデル:

{
    "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",
    },
}