Composants et informations clés pour l'intégration de bout en bout MFA externe

Fournisseur MFA

Configuration représentant la projection publique Verify d'une intégration de fournisseur MFA externe. Lors de l'exécution, ce composant agit en tant que client API. Les requêtes et les réponses sont transmises via un webhook en temps réel.

Webhook en temps réel

Fournit la connexion Internet authentifiée sécurisée et le client HTTPS à un fournisseur MFA externe cible. Désignez le webhook en tant que point d'application de contrat d'API. Le webhook sert de médiateur pour la demande et les réponses envoyées entre le composant interne de Verify et le fournisseur MFA externe cible.

Informations sur le fournisseur MFA

Un fournisseur MFA Verify représente la conceptualisation Verify d'un fournisseur MFA externe. Il définit les fonctions de facteur MFA qui sont exposées et la façon dont les utilisateurs Verify sont identifiés et résolus dans le fournisseur MFA cible. L'exemple suivant illustre une configuration de fournisseur MFA.

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

Le tableau suivant présente les attributs de configuration de clé.

Informations sur le webhook

Une configuration de webhook en temps réel doit être associée à une configuration de fournisseur d'authentification multifactorielle. Le webhook en temps réel assure l'intégration technique en exécution entre l'éditeur de logiciels indépendant (ISV) et le service du fournisseur d'authentification multifactorielle (MFA) cible. Idéalement, le webhook est aussi le point où le contrat MFA externe est appliqué et agit donc comme un médiateur d'API et de protocole entre ISV et le fournisseur MFA cible. Les mécanismes clés par lesquels les webhooks prennent en charge la capacité à appliquer le contrat d'API et la médiation sont les "ressources" et les "transformations". Pour la prise en charge et l'intégration MFA externe, la définition de "ressources" doit correspondre au contrat d'API MFA externe 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"]
}