본문으로 건너뛰기

카카오 로그인

카카오 계정을 통한 소셜 로그인, 로그아웃, 연결 해제 기능을 제공하는 모듈입니다.

개요​

appify.auth.kakao 모듈은 카카오 SDK를 기반으로 인증 기능을 제공합니다. 카카오톡 앱이 설치된 환경에서는 앱을 통해, 미설치 환경에서는 웹 브라우저를 통해 로그인을 진행합니다. 로그인 성공 시 accessToken, refreshToken, 사용자 프로필 정보를 포함한 AuthResult를 반환합니다.

API​

login(): Promise<AuthResult>​

카카오 로그인을 시도합니다. 카카오톡 앱이 설치되어 있으면 앱으로, 없으면 웹 브라우저를 통해 로그인을 진행합니다.

반환값: Promise<AuthResult> - 인증 결과 객체. success가 true이면 accessToken, refreshToken, user가 포함됩니다.

예제

import { appify } from '@nolraunsoft/appify-sdk';

const result = await appify.auth.kakao.login();

if (result.success) {
  console.log('로그인 성공:', result.user?.name);
  console.log('토큰:', result.accessToken);
} else {
  console.error('로그인 실패:', result.error);
}

logout(): Promise<boolean>​

카카오 계정 로그아웃을 처리합니다. 현재 세션을 만료시킵니다.

반환값: Promise<boolean> - 로그아웃 성공 시 true, 실패 시 false.

예제

import { appify } from '@nolraunsoft/appify-sdk';

const success = await appify.auth.kakao.logout();

if (success) {
  console.log('로그아웃 완료');
}

카카오 앱 연결을 해제합니다. 연결 해제 후에는 해당 사용자의 토큰이 모두 만료됩니다.

반환값: Promise<boolean> - 연결 해제 성공 시 true, 실패 시 false.

예제

import { appify } from '@nolraunsoft/appify-sdk';

const success = await appify.auth.kakao.unlink();

if (success) {
  console.log('카카오 연결 해제 완료');
}

관련 문서​