본문으로 건너뛰기

구글 로그인

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

개요​

appify.auth.google 모듈은 구글 SDK를 기반으로 인증 기능을 제공합니다. 로그인 성공 시 accessToken, idToken, 사용자 프로필 정보를 포함한 AuthResult를 반환합니다. idToken은 구글이 발급하는 JWT 형식의 신원 토큰으로, 서버 측 사용자 검증에 활용할 수 있습니다.

API​

login(): Promise<AuthResult>​

구글 로그인을 시도합니다.

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

예제

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

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

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

logout(): Promise<boolean>​

구글 로그아웃을 처리합니다. 현재 세션을 만료시킵니다.

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

예제

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

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

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

구글 서비스 연결을 해제합니다. 연결 해제 후에는 해당 사용자의 토큰이 모두 만료됩니다.

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

예제

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

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

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

관련 문서​