보안 · 오류 메시지·상태명 확인

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`인지 확인합니다.

적용 범위: 화면 또는 로그에 같은 오류 메시지·상태명이 표시된 경우
출처: Firebase
출처 확인일: 2026-07-24
최종 검토: 2026-07-24
정정 이력: 2026-07-29 이후 기록 없음
관련 기술: 인증 오류 코드

오류·수정 제보

이 문서의 범위

이 문서는 화면·로그의 오류 메시지 또는 상태명을 공식 자료와 대조하는 데 사용합니다. 이 문구만으로 실제 원인이나 변경 방법을 확정하지 않으며, 아래 관련 기술 문서에서 적용 환경을 추가로 확인해야 합니다.

현재 증상

애플리케이션 오류 메시지

먼저 확인할 항목

화면 또는 로그의 오류 코드가 정확히 `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 특정 클레임이 포함되어 있으면 원문 설명과 일치합니다.

출처

Firebase Admin Authentication API Errors (새 창에서 열림)

참고 자료

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