인증 개요

서비스명 등록 API 최초 1회 호출
2FA 인증 메시지에 서비스명을 노출하려면 운영 전에 서비스명 등록 API를 최초 1회 호출해야 합니다. 등록된 서비스명은 이후 인증번호 발송 요청에서 사용할 수 있습니다.
API: POST /api/verify/v1/2fa/service/regist
상세 스펙: API 레퍼런스 — Verify 2FA 서비스명 등록

서비스명 등록 인증문자 예시

인증번호는 [123456]입니다.
[비즈고]에서 인포뱅크를 통해 발송된 메시지입니다.

서비스명 미등록 인증문자 예시

인증번호는 [123456]입니다.
인포뱅크를 통해 발송된 메시지입니다.

간편소셜로그인 가이드

카카오싱크, 네이버 로그인 연동 방법과 앱 정보 등록 절차를 상세히 확인합니다.

간편소셜로그인 가이드 보기 →

간편소셜로그인

카카오, 네이버, 구글, 애플 소셜 플랫폼을 단일 API로 통합해 간편 가입·로그인을 제공하는 상품입니다.
여러 소셜 플랫폼을 provider 파라미터 하나로 전환해 사용할 수 있습니다.

2단계 : 통합 KEY 발급

콘솔에서 팀스페이스로 이동합니다.
좌측 메뉴에서 연동관리를 선택합니다.
KEY 발급 버튼을 클릭해 통합 KEY를 발급합니다.
통합 KEY에 소셜 로그인 인증 상품을 연결하고, 호출 서버의 IP ACL을 등록합니다.

최초 가입 시 자동 발급
최초 신규 가입 시 비즈니스 인증 완료 후 통합 KEY 1개가 자동 발급됩니다. 선택한 요금제에 따라 소셜 로그인 상품이 연결된 상태로 확인할 수 있습니다.

연동관리

통합 KEY 발급, IP ACL 설정, 상품 연결, 인증 헤더 구성 방법을 확인합니다.

통합 KEY 발급 보기 →

3단계 : 카카오/네이버 디벨로퍼스 사전설정

사전설정 방법에 따라 제공사 디벨로퍼스에서 앱을 생성하고 설정합니다.

제공사 디벨로퍼스에 앱 생성 시 Redirect URI 등록
카카오와 네이버는 제공사 콘솔에 비즈고 콜백 URL을 정확히 등록해야 인증 완료 후 정상적으로 돌아올 수 있습니다.
카카오 : https://mars-verify-cb.ibapi.kr/api/callback/kakao
네이버 : https://mars-verify-cb.ibapi.kr/api/callback/naver

카카오싱크 설정

카카오 디벨로퍼스에서 카카오싱크 간편가입에 필요한 항목을 순서대로 확인합니다.

설정 항목	확인할 내용	설정 경로 및 참고
기본 정보	카카오싱크 간편가입 동의 화면에 노출할 서비스 정보를 설정합니다. 앱 이름, 아이콘, 회사명이 실제 서비스와 일치해야 합니다.	내 애플리케이션 > 일반 애플리케이션
테스트 환경	기존 서비스에 영향이 없도록 테스트 앱과 개발자용 채널을 사용할 수 있습니다. 카카오 로그인을 아직 사용하지 않는 서비스도 필요하면 테스트 앱을 생성해 연동 개발을 진행합니다.	내 애플리케이션 > 카카오 로그인 테스트 앱, 개발자용 채널
카카오 로그인	카카오싱크 간편가입을 사용하려면 카카오 로그인을 활성화해야 합니다. 웹 서비스는 Redirect URI를 등록해야 합니다.	내 애플리케이션 > 카카오 로그인 카카오 로그인 활성화 설정, Redirect URI 등록
간편가입	카카오싱크 간편가입 사용 여부와 서비스 약관을 설정합니다. 간편가입을 사용하면 동의 화면에 서비스 약관 동의항목이 노출됩니다.	내 애플리케이션 > 카카오 로그인 > 간편가입 간편가입, 간편가입 사용 설정
동의항목	카카오로부터 제공받을 사용자 정보와 기능 권한을 설정합니다. 일부 동의항목은 별도 검수가 필요할 수 있습니다.	내 애플리케이션 > 카카오 로그인 동의항목
대표 채널	카카오싱크 간편가입 동의 화면에 노출할 대표 채널을 설정합니다.	내 애플리케이션 > 카카오 로그인 > 카카오톡 채널 대표 채널 설정

카카오 Redirect URI
카카오 로그인 설정에서 Redirect URI에 https://mars-verify-cb.ibapi.kr/api/callback/kakao를 등록합니다.

네이버 로그인 설정

네이버 디벨로퍼스에서 네이버 로그인에 필요한 항목을 순서대로 확인합니다.

설정 항목	확인할 내용	설정 경로 및 참고
애플리케이션 등록	약관동의, 계정정보 등록, 애플리케이션 등록을 진행합니다. 애플리케이션 등록 시 사용 API를 네이버 로그인으로 설정합니다.	애플리케이션 등록
클라이언트 아이디와 클라이언트 시크릿 확인	애플리케이션 등록 완료 후 클라이언트 아이디와 클라이언트 시크릿을 확인합니다. 확인한 값은 비즈고 API 요청 또는 운영 설정에 사용합니다.	클라이언트 아이디/시크릿 확인

네이버 Callback URL
네이버 로그인 설정에서 Callback URL에 https://mars-verify-cb.ibapi.kr/api/callback/naver를 등록합니다.

4단계 : 앱 정보 등록 API 최초 1회 호출

사전설정 후 제공사에서 발급받은 appId, Client ID, Client Secret과 콜백 URL을 등록합니다.

중요 앱 정보등록
앱 정보를 최초 1회 필수로 등록해야 간편소셜로그인을 이용할 수 있습니다.
사전 설정을 통해 발급받은 appId, Client ID, Client Secret, 콜백 URL을 반드시 등록해 주세요.
API: POST /api/verify/v1/social/app-config/regist
상세 스펙: API 레퍼런스 — 소셜로그인 앱 정보 등록

함께 보는 문서

환경 설정하기 — API 키 발급, IP ACL, 인증 헤더 구성
운영 준비 — 회원가입, 비즈니스 인증, 발신정보 등록
보안 정책 — API 키 보안 및 HTTPS 정책