카카오 로그인 연결하기

손님이 카카오 계정으로 가입하게 하려면, 카카오에 내 서비스를 등록하고 값 두 개를 받아 와야 합니다. REST API 키와 클라이언트 시크릿입니다.

이 페이지는 그 값 두 개를 받는 순서를 안내합니다. 받은 값을 WEEGLOO에 넣는 방법은 받은 값을 WEEGLOO에 넣기에 있습니다.

먼저 복사해 둘 주소

손님이 카카오에서 로그인을 마치면, 카카오는 그 결과를 정해진 주소로 돌려보냅니다. 이 주소를 카카오에 등록해야 하므로 먼저 복사해 두세요. 5단계에서 붙여 넣습니다.

아래에서 내 Space를 고르면 식별자가 채워진 주소가 됩니다.

Space
https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/kakao

직접 채우고 싶다면 {spaceId} 자리에 내 Space의 식별자를 넣으세요. 콘텐츠 스튜디오에서 그 Space를 열고 브라우저 주소창을 보면, /spaces/ 다음에 오는 값이 식별자입니다.

이 주소는 내 사이트 주소가 아니라 WEEGLOO가 로그인 결과를 받는 자리입니다. 그래서 내 사이트를 아직 만들지 않았어도 지금 확정됩니다. 콘텐츠 스튜디오에서 카카오를 켰다면 Step 1에 같은 주소가 보이므로, 거기서 복사해도 됩니다.

카카오에서 값 두 개 받기

카카오에 로그인한 뒤, 아래 다섯 단계를 차례로 진행하세요.

1

앱 만들기

  1. 내 애플리케이션 화면(https://developers.kakao.com/console/app)을 여세요.

  2. 앱 생성을 누르세요.

  3. 앱 아이콘에 이미지를 올리세요.

  4. 앱 이름에 손님에게 보일 이름을 입력하세요(예: 포근한 옷장).

  5. 회사명에 내 가게나 회사 이름을 입력하세요. 앱 이름과 같아도 됩니다.

  6. 카테고리에서 내 서비스에 맞는 것을 고르세요(예: 라이프스타일).

  7. 앱 대표 도메인에 내 사이트 주소를 입력하세요(예: https://pogeun-otjang.com).

  8. 맨 아래의 운영정책 동의 체크박스를 켜세요.

  9. 저장을 누르세요.

    앱 생성 모달. 앱 아이콘에 이미지가 올라가 있고 앱 이름과 회사명에 "포근한 옷장", 앱 대표 도메인에 사이트 주소가 채워져 있습니다

2

비즈 앱으로 전환하기

비즈 앱으로 전환하지 않으면 이메일을 필수 동의항목으로 설정할 수 없습니다.

  1. 방금 만든 앱을 열고 앱 설정 → 앱 → 일반으로 이동하세요.

  2. 비즈니스 정보 절을 찾으세요.

    비즈니스 정보 절. 사업자 정보 등록 버튼과 "이 앱은 비즈 앱이 아닙니다" 안내가 있고, 아래에 개인 개발자 비즈 앱 전환 버튼이 있습니다

다음은 사업자등록번호가 있는지에 따라 갈립니다. 내 상황에 맞는 쪽만 하세요.

  1. 사업자 정보 등록을 누르세요.
  2. 사업자 구분에서 국내 사업자를 고르세요. 국내 사업자가 아니라면 해외 사업자를 고르세요.
  3. 사업자 등록번호를 입력하세요.
  4. 확인을 누르세요.

비즈니스 정보 모달. 사업자 구분에 국내 사업자가 선택되어 있고 그 아래 사업자 등록번호 칸 세 개가 있습니다

  1. 본인인증을 마치세요.
  2. 개인 개발자 비즈 앱 전환을 누르세요.
  3. 비즈 앱 전환 목적에서 이메일 필수 동의를 고르세요.
  4. 저장을 누르세요.

개인 개발자 비즈 앱 전환 모달. 비즈 앱 전환 목적에 이메일 필수 동의가 선택되어 있습니다

카카오비즈니스 통합 서비스 약관에 동의한 적이 없다면 저장을 누른 뒤 약관 동의 화면이 열립니다. 동의하면 전환이 이어집니다.

어느 쪽이든 전환이 끝나면 앱 이름 위의 배지가 비즈 앱으로 바뀝니다.

3

카카오 로그인 켜기

  1. 제품 설정 → 카카오 로그인 → 일반으로 이동하세요.

  2. 사용 설정의 상태 토글을 켜세요.

  3. 확인 다이얼로그에서 활성화를 누르세요.

    제품 설정 → 카카오 로그인 → 일반 화면. 사용 설정의 상태 토글이 켜져 있고 그 아래에 OpenID Connect 토글이 있습니다

토글을 켜면 아래에 OpenID Connect 토글이 나타납니다. 이 토글은 그대로 두세요.

4

동의항목 설정하기

아래 세 항목을 모두 필수 동의로 바꿔야 합니다.

이름동의 목적
카카오계정(이메일)회원 식별
닉네임회원 이름 표시
프로필 사진회원 프로필 표시

  1. 제품 설정 → 카카오 로그인 → 동의항목으로 이동하세요.

  2. 개인정보 표에서 카카오계정(이메일) 줄의 설정을 누르세요.

  3. 필수 동의를 고르세요.

  4. 동의 목적에 회원 식별을 입력하세요.

  5. 저장을 누르세요.

    동의항목 설정 모달. 카카오계정(이메일)에 필수 동의가 선택되고 동의 목적에 "회원 식별"이 입력되어 있습니다

  6. 닉네임도 2번부터 같은 방식으로 바꾸세요. 동의 목적은 회원 이름 표시입니다.

  7. 프로필 사진도 2번부터 같은 방식으로 바꾸세요. 동의 목적은 회원 프로필 표시입니다.

  8. 세 항목의 상태가 모두 필수 동의인지 확인하세요.

    동의항목 화면의 개인정보 표. 닉네임, 프로필 사진, 카카오계정(이메일)의 상태가 모두 필수 동의이고 나머지 항목은 권한 없음입니다

세 항목을 모두 바꿔야 합니다

하나라도 남겨 두면 손님은 로그인을 시작하기도 전에 카카오 오류 화면에서 막힙니다.

5

REST API 키와 클라이언트 시크릿 복사하기

  1. 앱 설정 → 앱 → 플랫폼 키로 이동하세요.

    앱 설정 → 앱 → 플랫폼 키 화면. REST API 키, JavaScript 키, 네이티브 앱 키 세 카드가 나란히 있습니다

  2. REST API 키 카드를 누르세요.

    REST API 키 수정 화면. 맨 위에 REST API 키 값이 있고, 아래로 카카오 로그인 리다이렉트 URI 칸이 비어 있는 상태로 보이며, 그 아래 클라이언트 시크릿의 카카오 로그인 줄과 비즈니스 인증 줄이 있습니다

  3. REST API 키 값을 복사해 두세요.

  4. 카카오 로그인 리다이렉트 URI 칸에 먼저 복사해 둘 주소에서 복사한 주소를 붙여 넣으세요.

  5. 클라이언트 시크릿의 카카오 로그인 줄에 있는 코드를 복사해 두세요.

  6. 저장을 누르세요.

키는 REST API 키, JavaScript 키, 네이티브 앱 키 세 종류로 나오는데 쓸 것은 REST API 키입니다. 클라이언트 시크릿도 코드가 카카오 로그인과 비즈니스 인증 두 줄로 나오는데 쓸 것은 카카오 로그인 줄입니다.

주소는 칸 하나로 끝입니다. 옆의 + 버튼은 주소를 더 등록할 때 쓰는 것이니 누르지 마세요. 시크릿은 비밀 값이니 남에게 알려 주거나 공개된 곳에 적어 두지 마세요.

받은 값을 WEEGLOO에 넣기

이제 손에 값 두 개가 있습니다. 두 값이 콘텐츠 스튜디오의 어느 칸에 들어가는지는 이렇습니다.

카카오 화면콘텐츠 스튜디오
REST API 키REST API key
클라이언트 시크릿의 카카오 로그인 코드Client Secret - Kakao Login Code

여기서부터는 지금까지 어떻게 작업해 왔는지에 따라 갈립니다.

콘텐츠 스튜디오에서 직접 설정하고 있었다면 이렇게 진행하세요.

  1. 서비스 회원 로그인의 소셜 로그인 켜기로 돌아가세요.
  2. 카카오를 켜세요.
  3. Step 2의 REST API key 칸에 REST API 키를 넣으세요.
  4. Client Secret - Kakao Login Code 칸에 클라이언트 시크릿의 카카오 로그인 코드를 넣으세요.
  5. 저장을 누르세요.

AI 에이전트에게 연동을 맡겨 두고 값을 받아 오라는 안내를 받았다면, 받아 온 값 두 개를 대화창에 그대로 붙여 넣고 하던 작업을 이어 가세요. 남은 설정은 에이전트가 이어서 처리합니다.

다음으로 할 일

  • 서비스 회원 로그인: 받아 온 값을 콘텐츠 스튜디오에 넣고, 회원 로그인의 나머지 설정을 마칩니다.
  • 회원 역할과 권한: 가입한 회원이 무엇을 보고 쓸 수 있는지 정하는 ServiceUserRole을 만듭니다.
  • Auth API: 로그인을 내 사이트 코드에 붙일 때 필요한 요청 형식 같은 기술 명세를 다룹니다.