본문으로 건너뛰기

애플 로그인

Apple로 로그인(Sign in with Apple) 기능을 제공하는 모듈입니다.

개요​

appify.auth.apple 모듈은 Apple의 Sign in with Apple을 기반으로 인증 기능을 제공합니다. iOS 환경에서는 네이티브 Apple 인증 UI를 사용하며, Android 환경에서는 웹 기반으로 동작합니다. 로그아웃과 연결 해제는 별도 API로 제공되지 않으며, 사용자가 기기의 OS 설정에서 직접 관리해야 합니다.

API​

login(): Promise<AppleAuthResult>​

애플 로그인을 시도합니다. 성공 시 identityToken과 authorizationCode가 포함된 결과를 반환합니다. 두 값은 최초 로그인 시에만 제공되며 이후 재로그인 시에는 포함되지 않을 수 있습니다.

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

속성타입설명
identityTokenstring?사용자 신원을 증명하는 JWT 토큰. 최초 로그인 시에만 제공됩니다.
authorizationCodestring?서버 측 검증에 사용되는 일회용 코드. 최초 로그인 시에만 제공됩니다.
userUser?사용자 프로필 정보. 최초 로그인 시에만 제공됩니다.

예제

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

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

if (result.success) {
  // identityToken을 서버로 전달하여 검증합니다.
  console.log('Identity Token:', result.identityToken);
  console.log('Authorization Code:', result.authorizationCode);
} else {
  console.error('로그인 실패:', result.error);
}

로그아웃 및 연결 해제​

애플 로그인은 보안 정책상 SDK를 통한 logout 및 unlink 메서드를 제공하지 않습니다. 로그아웃 및 연결 해제는 사용자가 직접 OS 설정에서 처리해야 합니다.

  • iOS: 설정 > Apple ID > 암호 및 보안 > Apple로 로그인한 앱
  • Android: 기기 설정 > Google > Apple ID 연결 앱 관리

관련 문서​