Schlüsselkomponenten und Informationen für die End-to-End-Integration externer MFA

MFA-Provider

Die Konfiguration, die die öffentliche Verify-Projektion einer externen MFA-Providerintegration darstellt. Zur Laufzeit fungiert diese Komponente als API-Client. Anfragen und Antworten werden über einen Echtzeit-Webhook gesendet.

Echtzeit-Webhook

Stellt die sichere authentifizierte Internetverbindung und den HTTPS-Client für einen externen MFA-Zielprovider bereit. Legen Sie den Webhook als API-Vertragsdurchsetzungspunkt fest. Der Webhook vermittelt die Anforderungen und Antworten, die zwischen der internen Komponente von Verify und dem externen MFA-Zielprovider gesendet werden.

Informationen zum MFA-Provider

Ein Verify-MFA-Provider stellt die Verify-Konzeption eines externen MFA-Providers dar. Sie definiert, welche MFA-Faktorfunktionen verfügbar gemacht werden und wie Verify-Benutzer im Ziel-MFA-Provider ermittelt und aufgelöst werden. Im folgenden Beispiel wird eine MFA-Providerkonfiguration gezeigt.

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

In der folgenden Tabelle sind die Schlüsselkonfigurationsattribute aufgeführt.

Webhook-Informationen

Eine Echtzeit-Webhook-Konfiguration muss mit einer MFA-Anbieter-Konfiguration verknüpft sein. Der Echtzeit-Webhook sorgt für die technische Laufzeitintegration zwischen dem ISV und dem MFA-Dienst des Zielanbieters. Im Idealfall ist der Webhook auch der Punkt, an dem der externe MFA-Vertrag durchgesetzt wird und somit als API und Protokollmediator zwischen ISV und dem Ziel-MFA-Provider fungiert. Die Schlüsselmechanismen, mit denen Webhooks die Möglichkeit zur Durchsetzung von API-Verträgen und -Mediation unterstützen, sind "Ressourcen" und "Umsetzungen". Für die externe MFA-Unterstützung und -Integration muss die Definition von "Ressourcen" mit dem ISV-Vertrag für die externe MFA-API übereinstimmen.

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