이메일 및 SMS 서비스 제공업체 설정

이메일 도메인을 인증하려면 해당 Email Domain Authentication API를 사용하세요. API에 대한 자세한 내용은 ‘이메일 도메인 인증’을 참조하세요.

1. 이메일 도메인을 등록하세요. https://{tenanturl}/config/v1.0/email-domain-auth
   예제

   curl --request POST \
        --url https://tenant_url/config/v1.0/email-domain-auth \
        --header 'accept: application/json' \
        --header 'content-type: application/json'

2. 이메일 도메인의 DNS 레코드를 확인하세요. https://{tenanturl}/config/v1.0/email-domain-auth/{domain}
   예제

   curl --request GET \
        --url https://tenant_url/config/v1.0/email-domain-auth/domain \
        --header 'accept: application/json'

3. 이메일 도메인의 상태를 확인하세요. https://{tenanturl}/config/v1.0/email-domain-auth/{domain}/verify
   예제

   curl --request POST \
        --url https://tenant_url/config/v1.0/email-domain-auth/domain/verify \
        --header 'accept: application/json'

4. 사용자 지정 이메일 도메인을 변경하거나 업데이트하려면, 먼저 알림에서 기존 사용자 지정 이메일 도메인을 삭제한 다음 새 도메인을 등록해야 합니다.

   이메일 인증 도메인을 삭제하세요. https://{tenanturl}/config/v1.0/email-domain-auth/{domain}

   예제

   curl --request DELETE \
        --url https://tenant_url/config/v1.0/email-domain-auth/domain \
        --header 'accept: application/json'

• IBM Verify외부 SMS 제공업체는 에서 전송되는 OTP 알림 요청을 수신하기 위해 HTTP POST 웹훅 엔드포인트를 공개해야 합니다.
• 엔드포인트는 요청을 즉시 대기열에 넣고 ‘ HTTP ’ 응답을 반환해야 합니다.

{
  "destinationPhoneNumber": "18005551212",
  "content": "Your passcode is 6439-123456. It expires in 5 minutes.",
  "category": "OTP",
  "language": "en-US",
  "otp": "123456",
  "correlation": "6439",
  "expiry": 5
}

destinationPhoneNumber

수신자의 전화번호( E.164 형식).

content

사용자에게 표시되는 SMS 메시지 전문.

category

OTP

language

지역 또는 언어 코드(예: en-US).

otp

일회용 비밀번호 값.

correlation

OTP를 인증 흐름과 연결하는 식별자; 일반적으로 메시지에 표시됩니다.

expiry

유효 기간(분 단위).

202 승인됨

요청이 대기열에 정상적으로 등록되었습니다.

400 잘못된 요청

페이로드 형식이 올바르지 않습니다.

500 내부 서버 오류

서비스 제공자가 처리를 할 수 없습니다.

{
"status": "accepted",
"statusMessage": "Message accepted by provider"
}

{
"status": "failed",
"statusMessage": "The destination phone number is invalid."
}