인증 서비스 생성 인증 서비스 생성 엔드포인트에 요청하고 FriendlyName을 제공하세요. 친근한 이름은 인증 서비스를 설명하기 위해 생성하는 설명 문자열이어야 합니다. 이것은 최종 사용자에게 전송되는 SMS에 사용되는 이름입니다. (예: 귀하의 [FriendlyName] 인증 코드는: XXXXXX입니다) 최대 32자까지 가능합니다. 이 값에는 PII가 포함되어서는 안 됩니다. 선택적으로 다음과 같은 추가 매개변수를 제공할 수도 있습니다:
CodeLength 생성할 인증 코드의 길이입니다. 4에서 10 사이의 정수 값이어야 합니다.
LookupEnabled: 각 인증이 시작될 때 조회를 수행하고 전화번호에 대한 정보를 반환할지 여부
SkipSMSToLandlines: 유선 전화로 SMS 인증 전송을 건너뛸지 여부입니다. lookup_enabled가 필요합니다.
Psd2Enabled: 인증을 시작할 때 PSD2 거래 매개변수를 전달할지 여부입니다.
DoNotShareWarningEnabled: SMS 인증 본문 끝에 보안 경고를 추가할지 여부입니다. 기본적으로 비활성화되어 있으며 SMS에만 적용됩니다. SMS 본문 예시: 귀하의 AppName 인증 코드는: 1234입니다. 이 코드를 누구와도 공유하지 마세요. 직원이 코드를 요청하지 않습니다
CustomCodeEnabled: 무작위로 생성된 코드 대신 사용자 지정 코드로 인증을 전송할 수 있는지 여부입니다.
Totp.Issuer: TOTP 요소에 대한 선택적 구성입니다. 이 서비스에 대한 TOTP 발급자를 설정합니다. 이를 통해 TOTP URI의 발급자를 구성할 수 있습니다. 제공되지 않은 경우 서비스 친근한 이름으로 기본 설정됩니다.
Totp.TimeStep: TOTP 요소에 대한 선택적 구성입니다. TOTP 코드가 생성되는 빈도를 초 단위로 정의합니다. 즉, time_step초마다 새 TOTP 코드가 생성됩니다. 20초에서 60초 사이여야 합니다. 기본값은 30초입니다
Totp.CodeLength: TOTP 요소에 대한 선택적 구성입니다. 생성된 TOTP 코드의 자릿수입니다. 3에서 8 사이여야 합니다. 기본값은 6입니다
Totp.Skew: TOTP 요소에 대한 선택적 구성입니다. TOTP 코드 검증에 유효한 과거 및 미래의 타임스텝 수입니다. 0에서 2 사이여야 합니다. 기본값은 1입니다. 참고: 기본적으로 최종 사용자에게 전송되는 메시지는 “귀하의 [friend name] 인증 코드는: XXXXXX입니다”라고 표시됩니다. 이 언어를 맞춤 설정하려면 지원팀에 문의하세요.
인증 코드 전송 인증 생성 엔드포인트에 요청하세요. 사용자의 전화번호와 사용하려는 채널(SMS)을 제공하세요. 이렇게 하면 사용자에게 인증 코드가 전송됩니다.
인증 코드 확인 인증 확인 엔드포인트에 요청하세요. 사용자의 전화번호와 확인하려는 사용자가 전송한 인증 코드를 제공하세요.
추가 고려사항
만료 시간: 기본값은 10분입니다(만료 시간을 맞춤 설정하려면 지원팀에 문의하세요)
재시도: 실패한 인증 시도 및 재시도에 대한 사용자 경험을 고려해야 합니다.
보안: 전화번호 및 인증 코드와 같은 민감한 정보를 처리하기 위한 모범 사례를 구현하세요.
