Principais componentes e informações para integração de autenticação de diversos fatores externa de ponta a ponta

Provedor de autenticação de diversos fatores

A configuração que representa a projeção pública do Verify de uma integração de provedor de autenticação de diversos fatores externa. No tempo de execução, este componente age como um cliente da API. As solicitações e respostas são enviadas por meio de um webhook em tempo real.

Webhook em tempo real

Fornece a conexão de Internet autenticada segura e o cliente HTTPS para um provedor de autenticação de diversos externa fatores de destino. Designar o webhook como o ponto de cumprimento do contrato da API. O webhook media a solicitação e as respostas que são enviadas entre o componente interno do Verify e o provedor de Autenticação de diversos fatores externa de destino.

Informações do Provedor de autenticação de diversos fatores

Um provedor de Autenticação de diversos fatores do Verify representa a conceitualização do Verify de um provedor de Autenticação de diversos fatores externa. Ele define quais os recursos do fator Autenticação de diversos fatores estão expostos e como usuários do Verify são identificados e resolvidos no provedor de Autenticação de diversos fatores de destino. Uma configuração de provedor de Autenticação de diversos fatores é mostrada no exemplo a seguir.

{
    "name": "The Provider Name",
    "description": "ISV - External Provider Integration",
    "enabled": true,
    "credentialPrefix": "emfa",
    "webhookId": "{{webhook.id}}",
    "uniqueNameAttribute": "{{unique.name.attribute}}",
    "capabilities": [
        "mobile_otp",
        "mobile_bio",
        "custom_totp"
    ]
}

A tabela a seguir mostra os principais atributos de configuração.

Informações do Webhook

A configuração de um webhook em tempo real deve estar associada à configuração de um provedor de MFA. O webhook em tempo real proporciona a integração técnica em tempo de execução entre o ISV e o serviço do provedor de MFA de destino. Idealmente, o webhook também é o ponto em que o contrato de autenticação externa de diversos fatores é aplicado e, portanto, atua como um mediador de API e protocolo entre o ISV e o provedor de Autenticação de diversos fatores de destino. Os principais mecanismos pelos quais os webhooks suportam a capacidade de impor o contrato e a mediação da API são "recursos" e "conversões". Para suporte e integração de Autenticação de diversos fatores externa, a definição de "recursos" deve corresponder ao contrato de API de Autenticação de diversos fatores externa de ISV.

{
    "name": "Some MFA Provider",
    "type": "realtime",
    "urls": ["https://some.address.com"],
    "authentication": {
        "type": "oauth",
        "oauth": {
            "client_id": "some_client_id",
            "client_secret": "some_client_secret",
            "token_endpoint": "https://some.address.com/token",
            "token_endpoint_auth_method": "client_secret_basic"
        }
    },
    "resources": {
        "enrollments": {
            "suffix": "/v1/enrollments",
            "method": "GET",
            "transform": {
                "outgoing": (CEL TRANSFORM),
                "incoming": (CEL TRANSFORM)
            }
        },
        "initiate": {
            "suffix": "/v1/mfa",
            "method": "POST",
            "expectedStatus": [201]
            "transform": {
                "outgoing": (CEL TRANSFORM),
                "incoming": (CEL TRANSFORM)
            }
        },
        "validate": {
            "suffix": "/v1/mfa",
            "method": "POST",
            "transform": {
                "outgoing": (CEL TRANSFORM),
                "incoming": (CEL TRANSFORM)
            }
        },
        "custom_totp_1": {
            "suffix": "/v1/mfa",
            "method": "POST",
            "transform": {
                "outgoing": (CEL TRANSFORM),
                "incoming": (CEL TRANSFORM)
            }
        },
        "result": {
            "suffix": "/v1/mfa/transactions",
            "method": "GET",
            "transform": {
                "outgoing": (CEL TRANSFORM),
                "incoming": (CEL TRANSFORM)
            }
        }
    },
    "purpose": ["external_mfa"]
}