초보자용 · 읽기 약 5분
인증, 두 가지만 알면 됩니다
Linkmap의 "앱 로그인"과 "서비스 연동"은 목적이 다릅니다.
같은 GitHub이라도 역할이 다를 수 있어요.
Layer 1 — 앱 로그인
사용자
Linkmap
"내가 Linkmap에 들어가는 것" — Supabase Auth 담당
Layer 2 — 서비스 연동
프로젝트
GitHub
Vercel
"프로젝트가 외부 서비스와 연결되는 것" — OAuth / API Key
Layer 1
앱 로그인
Linkmap 서비스 자체에 들어오기 위한 인증입니다. 이메일, Google, GitHub 중 하나로 로그인할 수 있습니다.
이메일 · 비밀번호
가장 기본적인 방법. 이메일과 비밀번호로 가입 후 로그인합니다.
Google 로그인
구글 계정을 클릭 한 번으로 사용. 별도 비밀번호 불필요.
GitHub 로그인
개발자라면 이미 있는 GitHub 계정으로 바로 시작.
소셜 로그인(OAuth) 플로우
로그인 클릭Google / GitHub
Provider 인증외부 로그인 화면
콜백 처리/auth/callback
대시보드로그인 완료
로그인 클릭Google / GitHub
Provider 인증외부 로그인 화면
콜백 처리/auth/callback
대시보드로그인 완료
설정 요약
| 담당 | Supabase Auth |
| 콜백 URL | https://도메인/auth/callback |
| 설정 위치 | Supabase 대시보드 → Authentication → Providers |
| 환경 변수 | NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY |
Layer 2
서비스 연동
프로젝트에서 외부 서비스(GitHub, Vercel 등)와 연결하는 인증입니다. 연동 방식은 OAuth와 API Key 두 가지가 있습니다.
OAuth 연동
버튼 클릭 → 외부 로그인 → 토큰 자동 저장
서비스 맵"연결하기" 클릭
외부 인증GitHub 로그인
토큰 저장암호화 보관
서비스 맵"연결하기" 클릭
외부 인증GitHub 로그인
토큰 저장암호화 보관
API Key 입력
키를 복사해 붙여넣기 → 암호화 저장
설정 페이지API Key 입력
키 입력복사 · 붙여넣기
암호화 저장AES-256-GCM
설정 페이지API Key 입력
키 입력복사 · 붙여넣기
암호화 저장AES-256-GCM
서비스별 연동 방식
| 서비스 | 방식 |
|---|---|
| GitHub (레포 연동) | OAuth |
| Vercel | API Key |
| Stripe | API Key |
| OpenAI | API Key |
| Anthropic | API Key |
| Supabase (프로젝트) | API Key |
한눈에 비교
앱 로그인과 서비스 연동, 헷갈리지 않도록 나란히 비교해 보세요.
앱 로그인 | 서비스 연동 | |
|---|---|---|
| 목적 | 내가 Linkmap에 들어가기 | 프로젝트가 외부 서비스와 연결 |
| 언제 | 로그인/회원가입 화면 | 프로젝트 서비스 맵/설정 |
| 방식 | 이메일 · Google · GitHub | OAuth 또는 API Key |
| 담당 | Supabase Auth | Linkmap 자체 API + DB |
| 환경 변수 | SUPABASE_URL, ANON_KEY | 서비스별 상이 (GITHUB_CLIENT_ID 등) |
| 결과 | 세션 발급 → 보호된 페이지 접근 | 토큰/키 저장 → 외부 API 호출 가능 |
앱 로그인
- 목적
- 내가 Linkmap에 들어가기
- 언제
- 로그인/회원가입 화면
- 방식
- 이메일 · Google · GitHub
- 담당
- Supabase Auth
- 환경 변수
- SUPABASE_URL, ANON_KEY
- 결과
- 세션 발급 → 보호된 페이지 접근
서비스 연동
- 목적
- 프로젝트가 외부 서비스와 연결
- 언제
- 프로젝트 서비스 맵/설정
- 방식
- OAuth 또는 API Key
- 담당
- Linkmap 자체 API + DB
- 환경 변수
- 서비스별 상이 (GITHUB_CLIENT_ID 등)
- 결과
- 토큰/키 저장 → 외부 API 호출 가능
자주 묻는 질문
인증 관련해서 가장 많이 궁금해하시는 부분을 정리했습니다.
인증 설정이 이해되셨다면, 지금 바로 시작해 보세요!