클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

PinMe 인증 API 연동 가이드

PinMe Worker(TypeScript)에서 Identity Platform 인증 프록시 API로 회원가입·토큰 검증·사용자 조회를 구현하도록 돕는 스킬입니다.

웹·API 연동중급★ 3,746⑂ 277AI 점수 8/10마지막 업데이트: 2026. 9. 12.

무엇을 해주나

  • PinMe 플랫폼의 인증 프록시 API 4종(create_user, verify_token, user, list_users) 호출 방법을 정확한 엔드포인트·파라미터·에러코드와 함께 알려줍니다.
  • X-API-Key 헤더 + project_name 쿼리라는 공통 인증 규칙, ApiEnvelope<T>·UserInfo 같은 TypeScript 타입, 그리고 바로 복사해 쓸 수 있는 fetch 래퍼 함수를 제공합니다.
  • Firebase Auth SDK 기반 프런트엔드 초기화(tenant_id 설정 필수), 이메일/Google 로그인으로 id_token 획득 후 Worker에서 검증하는 표준 흐름을 정리합니다.
  • 403(이메일 미인증) vs 401(토큰 만료) 구분, 페이지네이션 누락, resp.ok만 보고 성공 판정하는 실수 등 자주 겪는 함정을 표로 경고합니다.

이런 분께 추천

  • PinMe로 배포하는 Worker 백엔드에 로그인/회원 기능을 붙이려는 개발자
  • Firebase Identity Platform 멀티테넌시를 처음 다뤄서 tenant_id·키 노출 범위가 헷갈리는 분
  • 인증 관련 에러 응답 처리를 일관되게 정리하고 싶은 팀

활용 예시

  1. "이메일/비밀번호 회원가입 API를 Worker에 만들어줘" → create_user 호출 코드와 검증 메일 안내 로직을 작성.
  2. "프런트에서 받은 id_token을 검증하는 미들웨어 작성" → verify_token 호출 후 403은 '메일 인증 필요', 401은 '재로그인' 으로 분기.
  3. "관리자 화면용 전체 사용자 목록 뽑기" → list_users를 next_page_token으로 끝까지 순회하는 제너레이터 코드 생성.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/glitternetwork/pinme/HEAD/skills/pinme-auth/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 glitternetwork/pinme 의 skills/pinme-auth 폴더를 내 ~/.claude/skills/pinme-auth/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/glitternetwork/pinme.git /tmp/pinme && mkdir -p ~/.claude/skills && cp -r /tmp/pinme/skills/pinme-auth ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 저장소를 클론합니다: git clone https://github.com/glitternetwork/pinme.git
  2. 스킬 폴더가 없으면 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r pinme/skills/pinme-auth ~/.claude/skills/
  4. ~/.claude/skills/pinme-auth/SKILL.md 파일이 있는지 확인합니다.
  5. Claude Code를 재시작하고, PinMe 프로젝트 폴더에서 "PinMe 인증 API로 로그인 검증 붙여줘"처럼 요청하면 스킬이 사용됩니다.
  6. Worker의 API_KEY, PROJECT_NAME 환경변수를 미리 설정해 두세요(프런트엔드에는 절대 노출 금지).
GitHub에서 원본 보기 ↗라이선스: MIT