인증 (Auth)
Appify SDK가 제공하는 소셜 로그인 통합 인증 모듈 개요입니다.
개요
Appify SDK는 카카오, 네이버, 구글, 애플 4개 플랫폼의 소셜 로그인을 단일 인터페이스로 제공합니다. 네이티브 SDK를 직접 연동하는 번거로움 없이 간단한 API 호출만으로 사용자 인증 및 프로필 정보를 가져올 수 있습니다. 모든 인증 모듈은 공통 AuthResult 타입을 반환하며, 애플 로그인은 이를 확장한 AppleAuthResult 타입을 반환합니다.
API
공통 메서드 구성
모든 인증 모듈은 아래 메서드를 공통으로 제공합니다 (애플 로그인 제외).
| 메서드 | 반환 타입 | 설명 |
|---|---|---|
login() | Promise<AuthResult> | 로그인 및 권한 획득 |
logout() | Promise<boolean> | 로그아웃 (세션 만료) |
unlink() | Promise<boolean> | 서비스 연결 해제 |
AuthResult
인증 성공 또는 실패 시 반환되는 공통 객체 구조입니다.
| 속성 | 타입 | 설명 |
|---|---|---|
success | boolean | 인증 성공 여부 |
accessToken | string? | 접근 토큰 |
refreshToken | string? | 갱신 토큰 |
idToken | string? | ID 토큰 (구글, 애플 등) |
user | User? | 사용자 프로필 정보 (id, email, name, profileImage) |
error | string? | 에러 메시지 (실패 시) |
AppleAuthResult
AuthResult를 확장한 애플 로그인 전용 반환 타입입니다.
| 속성 | 타입 | 설명 |
|---|---|---|
identityToken | string? | 사용자 신원을 증명하는 JWT 토큰 (최초 로그인 시에만 제공) |
authorizationCode | string? | 서버 측 검증에 사용되는 일회용 코드 (최초 로그인 시에만 제공) |
예제
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);
}
보안 주의사항
SDK에서 반환하는 accessToken 및 idToken은 클라이언트 측에서만 사용해야 합니다. 실제 서비스의 인증 처리를 위해서는 서버에서 해당 토큰의 유효성을 반드시 재검증해야 합니다.