설정하기

이 문서는 비즈니스 인증 API 사용 시 필요한 설정에 대해 안내합니다.

동의항목

앱 관리 페이지의 [비즈니스 인증] > [동의항목]에서 비즈니스 동의항목을 사용하도록 설정할 수 있습니다.

앱에 설정한 비즈니스 동의항목은 비즈니스 인증 동의 화면에 반영됩니다. 비즈니스 동의항목에 대한 자세한 내용과 전체 목록은 비즈니스 동의항목에서 확인할 수 있습니다.

자세한 설정 방법은 아래 항목별 설명을 확인합니다.

추가 기능 신청

비즈니스 동의항목은 추가 기능 사용 권한이 있어야 설정할 수 있습니다. 권한 신청 방법은 추가 기능 신청을 확인합니다.

비즈니스 동의항목을 설정하기 위해 필요한 조건은 사용 방법에서 확인할 수 있습니다.

동의항목 설정

서비스의 정보 조회 또는 기능 사용을 위한 비즈니스 동의항목을 설정할 수 있습니다. 설정한 동의항목은 비즈니스 동의화면에 반영됩니다.

아래 단계별 안내를 참고합니다.

1. 동의항목 확인

🅐 개인정보 동의항목과 🅑 접근권한 동의항목을 참고해 서비스에서 사용자에게 동의가 필요한 항목이 무엇인지 확인합니다.

원하는 동의항목의 [설정]을 누릅니다. 일부 동의항목은 설정하기 위해 먼저 추가 기능 신청을 완료해야 합니다.

2. 동의항목 설정

🅐[동의 단계]를 선택하고 🅑 동의 목적에 사용 목적을 작성한 뒤 [저장]을 선택합니다.

리다이렉트 URI

앱 관리 페이지의 [비즈니스 인증] > [리다이렉트 URI]에서 비즈니스 인증용 리다이렉트 URI를 등록할 수 있습니다. 비즈니스 인증은 비즈니스 인증 과정에서 등록한 리다이렉트 URI로 인가 코드를 발급합니다.

올바르지 않거나, 등록하지 않은 리다이렉트 URI로 비즈니스 인가 코드를 요청하면 에러가 발생합니다.

리다이렉트 URI는 아래 규칙에 맞게 등록해야 합니다.

• 최대 10개까지 등록할 수 있습니다.
• HTTP 및 HTTPS 프로토콜만 지원합니다.
• HTTP, HTTPS 프로토콜을 구분하므로 각각 등록해야 합니다.

참고: 리다이렉트 URI 활용 안내

• 여러 개의 리다이렉트 URI를 등록해 사용자를 비즈니스 인증 후 상황에 맞는 서비스 페이지(랜딩 페이지, 추가 정보 입력 페이지 등)로 이동시킬 수 있습니다.
• 비즈니스 리다이렉트 URI는 경로(path)에 임의의 파라미터를 포함할 수 없습니다. 비즈니스 인증 과정 중 특정 정보를 유지하거나 전달하려면 state 파라미터를 활용합니다. state 파라미터에 대한 정보는 비즈니스 인가 코드 요청에서 확인할 수 있습니다.
• 비즈니스 리다이렉트 URI의 도메인에 와일드카드 문자를 포함할 수 있습니다. 자세한 안내는 와일드카드 서브 도메인을 참고합니다.
• 10개를 초과하는 비즈니스 리다이렉트 URI 등록이 필요한 경우, 데브톡으로 문의합니다.

개인정보 국외이전

앱 관리 페이지의 [비즈니스 인증] > [개인정보 국외이전]에서 개인정보 국외이전 정보를 등록할 수 있습니다.

🅐 이전되는 국가: 개인정보가 이전되는 국가명 입력 🅑 법인명(업체): 개인정보를 이전받는 법인명 입력 🅒 연락처: 정보관리책임자의 이메일, 전화번호, 고객센터 URL 등 개인정보 관련 문의를 위한 🅑의 연락처 입력

입력한 정보로 비즈니스 인증 동의 화면에 [개인정보 국외 이전 동의] 필수 동의항목이 추가되며, 사용자는 해당 동의항목의 [보기]를 선택해 자세한 내용을 확인하고 동의할 수 있습니다.

Client Secret

보안을 강화하기 위해 비즈니스 인증용 클라이언트 시크릿(Client Secret) 코드를 발급받을 수 있습니다.

앱 관리 페이지의 [비즈니스 인증] > [Client Secret]에서 [클라이언트 시크릿 발급]을 선택합니다.

🅐 삭제: 발급 받은 클라이언트 시크릿 삭제 🅑 재발급: 새로운 클라이언트 시크릿 발급, 클라이언트 시크릿을 갱신하거나 유출이 의심되는 상황에서 사용 🅒 설정: 클라이언트 상태 변경, [사용함]인 상태여야 해당 클라이언트 시크릿 사용 가능

참고: 운영 중 클라이언트 시크릿 코드 변경 방법

1. 🅒 [설정]을 선택해 [상태]를 [사용 안 함]으로 변경
2. 🅑 [재발급]을 선택해 새로운 클라이언트 시크릿 코드 발급
3. 서비스에 새로운 클라이언트 시크릿 코드 적용
4. 🅒 [설정]을 선택해 [상태]를 [사용함]으로 선택