LogoLogo
  • 샵바이 스킨 알아보기
    • 샵바이 스킨 설명서
    • 오로라 리액트(통합형) 스킨 개발 가이드
    • 오로라 리액트(통합형) 릴리즈 노트
    • 오로라 바닐라(개별형) 릴리즈 노트
    • 1:1 문의하기
  • 오로라 개별형 스킨 개발 가이드
    • 개발 프로세스
      • 등록
      • 개발
        • 개발 환경 구성하기
        • 스킨 디렉토리 구조
      • 설치
    • 기본 API 이해하기
      • 샵바이 API 호출 가이드
        • OAuth 2.0 적용 가이드
      • 외부 스크립트 호출 가이드
    • 화면별 API 활용 가이드
      • 공통 영역
        • 공통 상단
        • 공통 하단
        • 디자인 팝업
        • 슬라이드 메뉴 (모바일 전용)
        • 최근 본 상품
      • 메인 화면
        • 배너 영역
        • 상품진열 영역
        • 인스타그램 연동
      • 회원가입
      • 로그인
      • 간편 로그인
      • 휴대폰 본인인증
      • 상품 리스트
      • 상품 상세
        • 상품 기본 정보
        • 상품 상세 배너 (모바일 전용)
        • 상품 상세정보 (탭)
        • 배송/반품/교환 안내 (탭)
        • 상품후기 (탭)
        • 상품문의 (탭)
        • 관련상품
      • 장바구니
      • 주문서
      • 마이페이지 > 쇼핑정보
        • 주문목록/배송조회
        • 취소/반품/교환 내역
        • 주문 상세
        • 좋아요
      • 마이페이지 > 혜택관리
        • 쿠폰
        • 적립금
      • 마이페이지 > 회원정보
        • 회원정보 수정
        • 회원탈퇴
        • 배송지 관리
      • 마이페이지 > 나의 게시글
        • 1:1 문의
        • 상품문의
        • 상품후기
      • 상품후기 게시판
      • 일반 게시판
      • 기획전
    • KCP 휴대폰 본인인증 연동 (iOS/AOS)
  • 앱 개발 가이드
    • [샵바이] 웹훅(webhook) 가이드
    • [고도몰] 웹훅(webhook) 가이드
  • 추천 콘텐츠
    • 추천 콘텐츠
      • [간편 로그인] SNS 연동 기능 개발 가이드
      • [공통] 마이페이 API 화면가이드
      • [엔터프라이즈] 선물하기 기능 (배송지 나중입력)
      • [엔터프라이즈] 카카오 싱크 신청 가이드
      • [엔터프라이즈] 카카오 싱크 회원가입 API 화면가이드
      • [엔터프라이즈] 이니렌탈(렌탈결제) API 화면가이드
      • [엔터프라이즈] 외부 회원 연동 가이드
      • [엔터프라이즈] 외부 적립금 전환 가이드
      • [엔터프라이즈] 외부 적립금 연동가이드
      • [엔터프라이즈] 사은품 API 화면가이드
      • [엔터프라이즈] PG신청 가이드 (2024/4/1 업데이트)
      • [엔터프라이즈] 카카오 픽셀 설치 가이드
      • [엔터프라이즈]정기결제(배송) API 화면가이드
      • [프로/엔터프라이즈] 쇼핑몰에 인스타그램 위젯을 적용해보세요!
      • [베이직/프로] 카카오싱크 신청 가이드
      • [웹훅 추가] 주문정보 웹훅(Webhook)이란?
      • [웹훅 추가] 회원정보 변경 및 회원탈퇴
      • [웹훅 추가] 앱 설치 및 삭제
      • shop by API, POSTMAN에 추가하기
      • [글로벌] 글로벌 기능 가이드
        • 사용 프로세스
          • 엑심베이 PG 계약
          • 개발 환경 세팅
          • shop by 어드민 세팅
          • 쇼핑몰 스킨 개발
            • 언어/통화 설정
            • 상품/전시 설정
            • 주문서 조회
            • 주문 예약하기
            • 회원 등록
        • 글로벌 주문/환불 프로세스
    • FAQ
      • 에러코드_ (1) 주문
      • 에러코드_ (2) 프로모션
      • 에러코드_ (3) 클레임
      • 쿠폰 코드 API 에러메시지 안내
      • 장바구니/주문결제 에러코드 안내
      • 배송타입 및 택배사코드 안내
      • 파트너어드민 매출내역 조회기준
      • shop api error response 안내
      • server API로 주문의 외부 유입경로 집계 방법
      • 은행코드 안내
      • 7/15 스킨 에디터 업데이트 주의사항
        • 모바일_업데이트 전 템플릿 코드
        • PC_업데이트 전 템플릿 코드
        • 업데이트 후/전 템플릿 코드 비교
      • [샵바이 엔터프라이즈] server API 호출방법
      • [샵바이 엔터프라이즈] 파트너 어드민에서 상품 노출은 미리 해두고, 판매 기간은 미래시점으로 설정할 수 있는 기능이 있을까요?
      • [샵바이 엔터프라이즈] 파트너사 담당MD 일괄변경 어떻게하나요?
Powered by GitBook
On this page
  • 🅐 간편 로그인 연동 프로세스
  • ⓐ 간편 회원 로그인 버튼
  • ⓑ 간편 로그인 연동 URI 획득
  • ⓒ 간편 로그인 제공사 (Provider) 화면 노출
  • ⓓ 쇼핑몰 redirectURI로 이동
  • ⓔ accessToken 획득
  • ⓕ 회원가입 여부 확인
  • 🅑 간편 로그인 회원가입
  • ⓐ 간편로그인 회원가입 팝업
  • ⓑ 약관 데이터 호출
  • ⓒ 회원가입
  • 🅒 카카오 싱크

Was this helpful?

  1. 오로라 개별형 스킨 개발 가이드
  2. 화면별 API 활용 가이드

간편 로그인

간편 로그인 기능 및 간편 로그인 회원가입에 대해 소개합니다.

Previous로그인Next휴대폰 본인인증

Last updated 6 months ago

Was this helpful?

  • 🅐 간편 로그인 연동 프로세스

  • 🅑 간편 로그인 회원가입

  • 🅒 카카오 싱크

간편 로그인 연동 로직에 대해 소개합니다. OAuth 프로토콜 중 간편회원 로그인 기능을 통해 accessToken을 획득하는 방식입니다.

기본 스킨에서 간편 로그인을 구현한 연동 시나리오는 위 다이어그램과 같습니다. 이를 아래 문서에서 각 프로세스 별 상세 설명합니다.


🅐 간편 로그인 연동 프로세스

ⓐ 간편 회원 로그인 버튼

회원가입 페이지, 로그인 페이지 등에서 노출되는 간편 로그인 기능입니다. 현재 제공하는 간편 로그인은 페이코, 네이버, 카카오, 페이스북 총 4개 입니다.

어드민에서 각 간편 로그인 제공사 개발자 센터에서 발급 받은 Client ID와 Client Secret 키를 입력합니다.

shop by basic/pro : 설정 > 기본정책 > 외부서비스 설정
shop by premium : 서비스관리 > 쇼핑몰 관리

어드민에서 연동 설정된 제공사에 한해, 회원가입 페이지 및 로그인 페이지에서 간편 로그인 기능이 제공됩니다.

어드민에 연동 설정이 되어 있는 간편 로그인 제공사 정보를 조회합니다. 연동되어 있지 않은 간편 로그인 제공사의 로그인 버튼은 노출되지 않습니다.

해당 API 응답 값 중 openIdJoinConfig 내 providers 값을 통해 확인 가능합니다.

ⓑ 간편 로그인 연동 URI 획득

간편 로그인 제공사(provider)이 각각 다르므로, provider 별 일부 화면을 노출하기 위해서는 먼저 아래 API를 호출하여 간편 로그인 연동 URI를 조회합니다.

► Openid 로그인 URI 조회하기 OpenID 로그 URI를 조회합니다.

해당 API 호출 시 3개의 파라미터가 필요하며 각 파라미터에 대한 설명은 아래와 같습니다.

  • provider

    • 간편 로그인 제공사

    • 각 제공사 id 앞에 'ncp_' 를 추가 (ex. ncp_payco, ncp_naver, ncp_kakao, ncp_facebook)

  • state

    • CSRF 공격 방지용 토큰

    • client 에서 생성한 숫자, 영문 대소문자로 이루어진 6자리의 random string

  • redirectUri

    • 인증 성공 후 이동할 쇼핑몰의 리다이렉트 URI (인코딩 필수)

    • 형식 : {location.origin}/callback/auth-callback.html

      • 참고) 모바일 도메인에 /m 을 추가해서 사용하는 경우 {location.origin}/m/callback/auth-callback.html

ⓒ 간편 로그인 제공사 (Provider) 화면 노출

획득한 간편 로그인 연동 URI를 통해 각 간편 로그인 제공사 화면을 노출합니다.

ⓓ 쇼핑몰 redirectURI로 이동

간편 로그인 제공사 화면에서 인증에 성공 후, code 값과 함께 쇼핑몰 redirecURI로 이동합니다. 이를 통해 프론트 화면에도 각 간편 로그인 제공사에서의 인증 성공 여부를 전달합니다.

✓ 예시 코드

https://{쇼핑몰 도메인}/callback/auth-callback?code=XXXXXXXXXX

ⓔ accessToken 획득

쇼핑몰 redirectURI에서 아래 API를 호출하여 accessToken과 refrehshToken을 획득합니다.

► OpenId AccessToken/RefreshToken 발급하기 OpenId 회원의 액세스 토큰 (accessToken) / 리프레시 토큰 (refreshToken)을 발급합니다.

액세스 기반의 로그인 방식을 사용하는 경우 아래 API를 호출하여 accessToken을 획득합니다.

► OpenId AccessToken 발급하기 OpenId 엑세스 토큰(accessToken)을 발급합니다.

ⓕ 회원가입 여부 확인

해당 간편 로그인 계정이 현재 쇼핑몰에 가입한 상태인지 아닌지 여부를 확인합니다.

► 회원정보 조회하기 회원정보를 조회합니다.

응답 값 중 memberStatus 값이 WAITING 인 경우 쇼핑몰 미가입 상태로 판단합니다.

  • 간편 로그인 회원인 경우 해당 간편 로그인 계정으로 로그인합니다.

  • 간편 로그인 회원이 아닌 경우 (미가입 상태) 아래 문서에서 소개 드릴, 간편 로그인 회원가입 로직을 진행합니다.


🅑 간편 로그인 회원가입

간편 로그인 회원가입에 대해 소개합니다. 간편 로그인을 통해 신규 가입을 하는 회원의 경우, 아래 화면을 통해 회원가입을 진행합니다.

ⓐ 간편로그인 회원가입 팝업

이전 단계에서 이미 호출한 GET /profile 응답 값을 활용하여 memberName, email, id, 휴대폰번호, 성별, 생일 등을 화면에 노출합니다.

ⓑ 약관 데이터 호출

약관 내용은 아래 어드민 경로에서 설정할 수 있습니다.

shop by basic/pro : 설정 > 기본정책 > 약관/개인정보처리방침
shop by premium : 서비스관리 > 약관/개인정보처리방침

► 적용 중인 몰 약관 조회하기 해당 쇼핑몰에 적용 중인 약관을 조회합니다.

► 적용 중인 몰 약관 조회하기 해당 쇼핑몰에 적용 중인 약관을 조회합니다.

아래 약관 데이터를 불러와서 약관 사용 여부가 true 인 항목들에 한하여 화면에 노출합니다.

  • [필수] 이용약관 USE

  • [필수] 개인정보 수집 및 이용동의 PI_COLLECTION_AND_USE_REQUIRED

  • [필수] 만 14세 이상 가입 동의 PI_14_AGE

  • [선택] 개인정보 수집 및 이용동의 PI_COLLECTION_AND_USE_OPTIONAL

  • [선택] 개인정보 처리/위탁에 대한 동의 PI_PROCESS_CONSIGNMENT

  • [선택] 개인정보 제 3자 제공에 대한 동의 PI_THIRD_PARTY_PROVISION

ⓒ 회원가입

해당 버튼 클릭 시 아래 API를 호출하여 간편 로그인 회원가입을 완료합니다.

► 오픈 아이디 회원가입 처리하기 OpenID 회원 프로필이 등록됩니다.


🅒 카카오 싱크

◼︎ 카카오 싱크 세팅 방법

► 몰 정보 조회하기 쇼핑몰 전반에 대한 기본 정보와 설정 데이터를 조회할 수 있습니다.

약관/개인정보처리방침에서 추가 동의 항목을 추가할 수 있습니다. 추가된 동의항목은 API를 통해 확인할 수 있습니다.

GET /malls
GET /oauth/login-url
POST /oauth2/openid
POST /oauth/openid
GET /profile
GET /terms
POST /terms/custom
POST /terms/custom 추가 약관 조회하기
POST /profile/openid
shop by basic/pro 카카오 싱크 신청 가이드
shop by premium 카카오 싱크 신청 가이드