인증 챌린지 생성 Lambda 트리거

인증 문제 생성

인증 문제 정의 트리거의 일부로 사용자 지정 문제를 지정한 경우 Amazon Cognito가 인증 문제 정의 이후에 이 트리거를 호출합니다. 사용자 지정 인증 흐름을 생성합니다.

사용자에게 표시할 문제를 만들기 위해 이 Lambda 트리거가 호출됩니다. 이 Lambda 트리거에 대한 요청에는 challengeName 및 session이 포함됩니다. challengeName은 문자열이며 사용자에게 표시할 다음 챌린지의 이름입니다. 인증 문제 정의 Lambda 트리거에서 이 속성의 값이 설정됩니다.

모든 챌린지에 응답할 때까지 챌린지 루프가 반복됩니다.

인증 챌린지 생성 Lambda 트리거 파라미터

Amazon Cognito가 이 Lambda 함수에 전달하는 요청은 아래 파라미터와 Amazon Cognito가 모든 요청에 추가하는 공통 파라미터의 조합입니다.

JSON

{
    "request": {
        "userAttributes": {
            "string": "string",
            . . .
        },
        "challengeName": "string",
        "session": [
            ChallengeResult,
            . . .
        ],
        "clientMetadata": {
            "string": "string",
            . . .
        },
        "userNotFound": boolean
    },
    "response": {
        "publicChallengeParameters": {
            "string": "string",
            . . .
        },
        "privateChallengeParameters": {
            "string": "string",
            . . .
        },
        "challengeMetadata": "string"
    }
}

인증 챌린지 생성 요청 파라미터

userAttributes

사용자 속성을 나타내는 하나 이상의 이름-값 페어입니다.

userNotFound

이 부울은 PreventUserExistenceErrors가 사용자 풀 클라이언트에 대해 ENABLED로 설정된 경우에 채워집니다.

challengeName

새로운 챌린지의 이름입니다.

세션

세션 요소는 각각 다음 요소를 포함하는 ChallengeResult 요소의 어레이입니다.

challengeName

챌린지 유형입니다. "CUSTOM_CHALLENGE", "PASSWORD_VERIFIER", "SMS_MFA", "DEVICE_SRP_AUTH", "DEVICE_PASSWORD_VERIFIER" 또는 "ADMIN_NO_SRP_AUTH" 중 하나입니다.

challengeResult

사용자가 챌린지를 성공적으로 완료하면 true로 설정하고 그렇지 않으면 false로 설정합니다.

challengeMetadata

사용자 지정 챌린지의 이름입니다. challengeName이 "CUSTOM_CHALLENGE"인 경우에만 사용됩니다.

clientMetadata

인증 문제 생성 트리거에 지정하는 Lambda 함수에 사용자 지정 입력으로 제공할 수 있는 하나 이상의 키-값 페어입니다. AdminRespondToAuthChallenge 및 RespondToAuthChallenge API 작업에서 ClientMetadata 파라미터를 사용하여 이 데이터를 Lambda 함수에 전달할 수 있습니다. 인증 문제 생성 함수를 호출하는 요청에는 AdminInitiateAuth 및 InitiateAuth API 작업의 ClientMetadata 파라미터에 전달된 데이터가 포함되지 않습니다.

인증 챌린지 생성 응답 파라미터

publicChallengeParameters

클라이언트 앱이 사용자에게 표시할 챌린지에 사용하기 위한 하나 이상의 키-값 페어입니다. 사용자에게 문제를 정확히 표시하는 데 필요한 모든 정보를 이 파라미터에 포함해야 합니다.

privateChallengeParameters

이 파라미터는 인증 문제 응답 확인 Lambda 트리거에만 사용됩니다. 챌린지에 대한 사용자의 응답을 확인하는 데 필요한 모든 정보를 이 파라미터에 포함해야 합니다. 즉, publicChallengeParameters 파라미터는 사용자에게 표시할 질문을 포함하고 privateChallengeParameters는 질문의 유효한 대답을 포함합니다.

challengeMetadata

이 항목이 사용자 지정 챌린지일 경우 사용자 지정 챌린지의 이름입니다.

인증 챌린지 생성 예제

CAPTCHA가 사용자에 대한 챌린지로 생성됩니다. CAPTCHA 이미지 URL이 퍼블릭 챌린지 파라미터에 "captchaUrl"로 추가되고 예상되는 답이 프라이빗 챌린지 파라미터에 추가됩니다.

Node.js

const handler = async (event) => {
  if (event.request.challengeName !== "CUSTOM_CHALLENGE") {
    return event;
  }

  if (event.request.session.length === 2) {
    event.response.publicChallengeParameters = {};
    event.response.privateChallengeParameters = {};
    event.response.publicChallengeParameters.captchaUrl = "url/123.jpg";
    event.response.privateChallengeParameters.answer = "5";
  }

  if (event.request.session.length === 3) {
    event.response.publicChallengeParameters = {};
    event.response.privateChallengeParameters = {};
    event.response.publicChallengeParameters.securityQuestion =
      "Who is your favorite team mascot?";
    event.response.privateChallengeParameters.answer = "Peccy";
  }

  return event;
};

export { handler }