클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

PinMe 인증 API 연동

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

웹·API 연동중급★ 3,732⑂ 272AI 점수 7/10마지막 업데이트: 2026. 7. 25.

무엇을 해주나

PinMe 플랫폼의 인증 프록시 API를 Cloudflare Worker 기반 TypeScript 코드에 붙이는 방법을 Claude가 정확하게 알려줍니다.

  • 4개 API 레퍼런스: 사용자 생성(create_user), id_token 검증(verify_token), 단일 사용자 조회(user), 사용자 목록 페이지네이션(list_users)
  • 공통 인증 규칙: 모든 요청에 X-API-Key 헤더 + project_name 쿼리를 함께 보내야 한다는 규칙과 매칭 검증 흐름
  • 타입 정의: ApiEnvelope<T>, UserInfo, VerifyTokenData 등 응답 래퍼 타입
  • 오류 표: 401/400/403/404/502 각각의 data.error 문자열까지 명시
  • 프론트엔드 연동: Firebase Auth SDK 초기화, tenantId 설정, 이메일/구글 로그인으로 id_token 얻기
  • 키 분리 원칙: 서버 전용 api_key와 브라우저 노출 가능한 auth_api_key 구분

이런 분께 추천

  • PinMe로 프로젝트를 만들고 로그인 기능을 붙여야 하는 개발자
  • Worker + D1 조합으로 백엔드를 작성하며 인증을 서버에서 검증하고 싶은 분
  • Firebase Auth 멀티테넌트(tenant_id) 설정 때문에 토큰 귀속 오류를 겪은 분

활용 예시

  1. 회원가입 API 만들기 — "내 Worker에 /signup 라우트를 추가해서 이메일·비밀번호로 사용자를 만들고 검증 메일을 보내줘"라고 하면 스킬의 createAuthUser 패턴으로 코드를 생성합니다.
  2. 인증 미들웨어 작성 — "프론트에서 온 id_token을 검증하는 미들웨어를 만들어줘. 403은 이메일 미인증 안내로 처리해" → 401과 403을 구분한 처리 코드를 만들어 줍니다.
  3. 관리자 사용자 목록 — "전체 사용자를 CSV로 내보내는 스크립트" 요청 시 next_page_token 루프를 사용한 전체 페이지 순회 코드를 작성합니다.

· · · 설치 가이드 · · ·

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. 터미널을 엽니다.
  2. 스킬 저장소를 임시 폴더에 내려받습니다. 
    git clone https://github.com/glitternetwork/pinme.git /tmp/pinme
  3. Claude 스킬 폴더를 준비합니다. 
    mkdir -p ~/.claude/skills
  4. pinme-auth 스킬만 복사합니다. 
    cp -r /tmp/pinme/skills/pinme-auth ~/.claude/skills/
  5. Claude Code를 다시 실행한 뒤 /skills 로 pinme-auth가 보이는지 확인합니다.
  6. Worker 프로젝트에서 API_KEY, PROJECT_NAME 환경 변수를 설정합니다(wrangler secret put API_KEY). 키는 코드에 하드코딩하지 마세요.
  7. "pinme-auth 스킬로 로그인 검증 라우트를 만들어줘"처럼 요청하면 스킬이 자동으로 활성화됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT