엔드투엔드 외부 MFA 통합을 위한 주요 구성요소 및 정보

다음 샘플 코드는 앞 섹션의 예시 MFA 제공자를 지원할 수 있는 실시간 웹훅의 예시입니다.

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

다음 표는 자원과 연관된 구성 가능한 속성을 설명합니다.

속성	설명
suffix	선택사항. 아웃바운드 요청에 사용되는 기본 URL에 추가할 접미부입니다. 웹훅 자원의 아웃바운드 요청은 base URL + suffix로 전달됩니다. 구성에 정의된 것 이상의 슬래시는 추가되지 않습니다. 송신 변환을 사용하여 발신 요청 URL을 수정할 수 있습니다. 예를 들어, 이전 enrollments 샘플에서 ISV 웹훅 구성요소는 대상 MFA 제공자의 API 엔드포인트 https://some.address.com/v1/enrollments를 시작합니다.
method	선택사항. 송신 HTTP 메소드를 POST에서 지정된 메소드로 수정하는 메소드입니다. API 엔드포인트를 시작하는 데 사용되는 HTTP 메소드입니다. 유효한 값은 POST, PUT, GET, DELETE, PATCH입니다. 송신 변환을 사용하여 메소드를 수정할 수 있습니다.
transform.outgoing	선택사항. 전송되기 전에 아웃바운드 요청에 적용되는 데이터 변환을 정의합니다. 변환은 ISV 내부 MFA 프레임워크에서 전송된 요청 요소 body, headers, http method, path, host에 액세스할 수 있습니다.
transform.incoming	선택사항. ISV MFA 프레임워크로 돌아가기 전에 수신 응답에 적용되는 데이터 변환을 정의합니다. 변환은 ISV 내부 MFA 프레임워크에서 전송된 요청 요소 body, headers, status_code, request(현재 응답을 생성하는 원래 요청)에 액세스할 수 있습니다.
exepctedStatus	선택사항. ExpectedStatus 이 웹훅에 의해 실행되는 API에서 반환될 것으로 예상되는 ` HTTP ` 상태입니다. 속성이 없는 경우 200 - 299 범위의 상태 코드가 예상됩니다. 수신 변환이 실행되기 전에 예상 상태가 확인됩니다. HTTP 상태를 참조하십시오.

웹훅 구성 API 참조를 참조하십시오.

외부 MFA 제공자는 외부 요청에 대한 처리 결과를 바탕으로 다음과 같은 응답을 반환할 수 있습니다.

응답	정의
보류 중	인증 절차가 아직 완료되지 않았습니다.
성공	인증에 성공했습니다.
FAILED	인증에 실패했습니다.
CANCELED	인증 시도가 중지된 엔티티로 인해 인증이 완료되지 않았습니다.
TIMEOUT	시간 초과로 인해 인증이 완료되지 않았습니다.