auth/invalid-claims
Firebase Admin Node.js Authentication API에서 setCustomUserClaims()에 제공한 custom claim 속성이 유효하지 않을 때 발생하는 오류 코드입니다.
빠른 답변
- 확인 범위
- auth/invalid-claims는 setCustomUserClaims()에 제공한 custom claim 속성이 유효하지 않음을 의미합니다.
- 먼저 확인할 항목
- 애플리케이션 화면 또는 로그의 오류 코드가 정확히 `auth/invalid-claims`인지 확인합니다.
- 적용 범위
- 화면 또는 로그에 같은 오류 메시지·상태명이 표시된 경우
- 출처
- Firebase
- 출처 확인일
- 2026-07-24
- 최종 검토
- 2026-07-24
- 정정 이력
- 2026-07-29 이후 기록 없음
- 관련 기술
이 문서의 범위
이 문서는 화면·로그의 오류 메시지 또는 상태명을 공식 자료와 대조하는 데 사용합니다. 이 문구만으로 실제 원인이나 변경 방법을 확정하지 않으며, 아래 관련 기술 문서에서 적용 환경을 추가로 확인해야 합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
애플리케이션 화면 또는 로그의 오류 코드가 정확히 `auth/invalid-claims`인지 확인합니다.
오류 코드가 일치하면 `setCustomUserClaims()`에 제공한 custom claim 속성이 유효하지 않다는 Firebase 공식 설명과 대조합니다.
오류 메시지·상태명 확인 범위
의미
auth/invalid-claims는 setCustomUserClaims()에 제공한 custom claim 속성이 유효하지 않을 때 Firebase Admin Node.js Authentication API가 발생시키는 오류 코드입니다.
확인
- 애플리케이션 화면 또는 로그에 표시된 오류 코드를 확인합니다.
- 오류 코드가 정확히
auth/invalid-claims인지 대조합니다. - 일치하면
setCustomUserClaims()에 제공한 custom claim 속성이 유효하지 않은 상태로 식별합니다.
출처
참고 자료
Admin Authentication API Errors | Firebase Authentication (새 창에서 열림)
Firebase · 공식 자료 · 확인 범위: Firebase Admin Node.js Authentication API는 auth/invalid-claims 오류 코드를 발생시킵니다., auth/invalid-claims는 setCustomUserClaims()에 제공한 custom claim 속성이 유효하지 않음을 의미합니다. · 확인일: 2026-07-24