auth/reserved-claims
빠른 답변
- 이 오류는 무엇인가요?
- Firebase Admin Node.js Authentication API에서 `setCustomUserClaims()`에 예약된 커스텀 클레임 키를 제공했을 때 발생하는 오류 코드입니다.
- 가장 흔한 원인은 무엇인가요?
- `auth/reserved-claims`는 `setCustomUserClaims()`에 제공한 커스텀 사용자 클레임 중 하나 이상이 예약되어 있음을 의미하며, `sub`, `iat`, `iss`, `exp`, `aud`, `auth_time` 등의 OIDC 특정 클레임은 커스텀 클레임 키로 사용하면 안 됩니다.
- 무엇을 먼저 확인해야 하나요?
- 화면 또는 로그의 오류 코드가 정확히 `auth/reserved-claims`인지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
화면 또는 로그의 오류 코드가 정확히 `auth/reserved-claims`인지 확인합니다.
해당 `setCustomUserClaims()` 호출에 제공한 커스텀 클레임 키를 확인합니다.
키에 `sub`, `iat`, `iss`, `exp`, `aud`, `auth_time` 등 예약된 OIDC 특정 클레임이 포함되는지 확인합니다.
환경별 원인과 조치
의미
auth/reserved-claims는 setCustomUserClaims()에 제공한 커스텀 사용자 클레임 중 하나 이상이 예약되어 있음을 나타냅니다.
Firebase는 sub, iat, iss, exp, aud, auth_time 등을 OIDC 특정 클레임의 예로 들며, 이들을 커스텀 클레임 키로 사용하면 안 된다고 설명합니다.
확인
- 애플리케이션 화면 또는 로그에 표시된 오류 코드가 정확히
auth/reserved-claims인지 확인합니다. - 이 코드가 표시된
setCustomUserClaims()호출에 제공한 커스텀 클레임의 키를 확인합니다. - 확인한 키에
sub,iat,iss,exp,aud,auth_time등 예약된 OIDC 특정 클레임이 포함되어 있으면 원문 설명과 일치합니다.
출처
참고 자료
Admin Authentication API Errors | Firebase Authentication (새 창에서 열림)
Firebase · 공식 자료 · 확인 범위: Firebase Admin Node.js Authentication API는 `auth/reserved-claims` 오류 코드를 정의합니다., 이 오류는 `setCustomUserClaims()`에 제공한 커스텀 사용자 클레임 중 하나 이상이 예약된 경우 발생합니다., `sub`, `iat`, `iss`, `exp`, `aud`, `auth_time` 등 OIDC 특정 클레임은 커스텀 클레임 키로 사용하면 안 됩니다. · 확인일: 2026-07-24