Contrato de API de risco de terceiros

Modelo de solicitação de webhooks de política de acesso

A estrutura da política de acesso lê o enabled valor do nó de configuração. Se o valor for false, o processamento da regra é ignorado e a integração de terceiros NÃO é acionada. Caso contrário, a regra da política de acesso é processada e o nó de configuração é processado.

Com base no evaluationOutboundAttributes definido no nó de configuração, o componente Verify interno envia os seguintes dados para o terceiro por meio dos webhooks. Dessa forma, ele pode obter o risco ou seus valores de atributo suportados de seu mecanismo de risco.

Uma amostra do modelo de dados, que o Verify envia para o terceiro (por meio da API interna dos webhooks):

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

Webhooks para modelos de resposta de política de acesso

Durante a avaliação do objeto de política de acesso, após o componente interno Verify enviar a carga útil de dados para o terceiro por meio dos webhooks, ele recebe a resposta da integração de terceiros. A resposta inclui versão, atributos suportados, pares de valores-chave e o resultado.

O modelo de dados de resposta que o Verify recebe da integração de terceiros:

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