image
Akan.js
한국어
문서컨벤션레퍼런스Cheatsheet
image
Akan.js
문서컨벤션레퍼런스Cheatsheet
MIT 라이선스 하에 배포되었습니다.
Akan.js 공식 컨설팅 서비스Akansoft
Copyright © 2026 Akan.js 모든 권리 보유.
시스템 관리자bassman
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
이전
파일 관리
다음
DataList & Enum

소셜 로그인

SSO는 GitHub, Google, Kakao, Naver 같은 서비스로 로그인하게 해줍니다. Akan에서는 보통 callback을 작게 작성하고, 로그인할지 가입을 이어갈지는 service에 맡깁니다.
  1. 사용자가 소셜 로그인 버튼을 누릅니다.
  2. provider가 사용자를 확인합니다.
  3. Akan callback이 profile을 받습니다.
  4. service가 로그인하거나 가입 화면으로 보냅니다.

Provider 등록

먼저 앱이 지원할 provider를 등록합니다. 각 provider는 해당 서비스의 개발자 콘솔에서 받은 credential이 필요합니다.
설정 예시

Callback 작성

callback은 작게 유지하세요. provider profile에서 account id만 뽑고 user service로 넘기면 됩니다.
`SSO.Google`은 guard입니다. 로그인 시작 route나 callback이 실행되기 전에 Google SSO 설정이 있는지 확인합니다. 시작 route는 Google로 redirect하고, callback은 Google의 `code`를 profile로 바꿉니다.
작은 callback

Account Id

provider마다 사용자 식별값 이름이 다릅니다. service를 호출하기 전에 하나의 `accountId`로 맞춰주세요.
  • GitHub는 보통 `username`을 사용합니다.
  • Google은 보통 첫 번째 email 주소를 사용합니다.
  • Kakao와 Naver는 주로 `email`을 사용합니다.
Provider profile 맞추기

Redirect

callback 이후 service는 보통 세 곳 중 하나로 이동시킵니다.
  • 기존 사용자: 로그인된 화면으로 이동합니다.
  • 신규 사용자: 가입 이어가기 화면으로 이동합니다.
  • 오류: 이해하기 쉬운 메시지와 함께 오류 화면으로 이동합니다.

꿀팁

  • provider별 차이는 callback 안에 두고, 로그인 규칙은 service 안에 두세요.
  • 모든 provider가 `accountId`를 맞춘 뒤에는 같은 service method를 사용하세요.
  • SSO를 시작하기 전에 성공, 가입, 오류 redirect를 준비해두세요.
소셜 로그인
Provider 등록
Callback 작성
Account Id
Redirect
꿀팁