인증 오류 코드
사용자·토큰·권한을 확인하는 인증 시스템이 실패 상태를 구분해 반환하는 코드와 메시지입니다.
정상 동작 조건
요약
확인 절차
인증 오류 코드는 로그인, 토큰 검증, 사용자 조회, 권한 확인 과정에서 인증 시스템이 반환하는 실패 식별자입니다.
오류 코드를 확인한 뒤에는 토큰의 유효성, 요청한 사용자 식별자, 호출 권한, 인증 서비스 설정처럼 해당 제품 문서가 요구하는 입력값을 확인합니다. 오류 코드만으로 비밀번호나 인증서의 문제라고 단정하지 않습니다.
SSL/TLS는 전송 구간의 보안을 담당하며, 인증 오류 코드가 가리키는 사용자·토큰 검증과는 다른 계층입니다.
관련 오류
auth/internal-error
Firebase Admin Node.js Authentication API에서 `auth/internal-error`가 표시될 때 오류 메시지의 서버 응답 추가 정보를 확인합니다.
auth/invalid-continue-uri
Firebase 공식 원문에 표시된 auth/invalid-continue-uri 항목의 문구를 확인하는 문서입니다.
auth/invalid-creation-time
Firebase 공식 원문에 표시된 auth/invalid-creation-time 항목의 문구를 확인하는 문서입니다.
auth/invalid-credential
Firebase 공식 원문에 표시된 auth/invalid-credential 항목의 문구를 확인하는 문서입니다.
auth/invalid-display-name
Firebase 공식 원문에 표시된 auth/invalid-display-name 항목의 문구를 확인하는 문서입니다.
auth/invalid-email
Firebase 공식 원문에 표시된 auth/invalid-email 항목의 문구를 확인하는 문서입니다.
auth/invalid-hash-block-size
Firebase 공식 원문에 표시된 auth/invalid-hash-block-size 항목의 문구를 확인하는 문서입니다.
auth/invalid-hash-derived-key-length
Firebase Admin Node.js Authentication API에서 해시 파생 키 길이가 유효한 숫자가 아닐 때 표시되는 오류 코드입니다.
auth/invalid-hash-memory-cost
Firebase 공식 원문에 표시된 auth/invalid-hash-memory-cost 항목의 문구를 확인하는 문서입니다.
auth/invalid-id-token
Firebase Admin Node.js Authentication API에서 `auth/invalid-id-token` 오류 코드가 표시될 때 의미를 확인합니다.
auth/invalid-oauth-responsetype
Firebase Admin Node.js Authentication API에서 OAuth responseType 설정이 정확히 하나만 true가 아닐 때 확인하는 오류 코드입니다.
auth/invalid-page-token
Firebase Admin Node.js Authentication API에서 `listUsers()`의 다음 페이지 토큰이 유효하지 않을 때 발생하는 오류 코드입니다.
auth/invalid-password-hash
Firebase 공식 원문에 표시된 auth/invalid-password-hash 항목의 문구를 확인하는 문서입니다.
auth/invalid-phone-number
Firebase Admin Node.js Authentication API에서 phoneNumber 값이 비어 있거나 E.164 표준 식별자 문자열이 아닐 때 발생하는 오류 코드입니다.
auth/invalid-provider-data
Firebase 공식 원문에 표시된 auth/invalid-provider-data 항목의 문구를 확인하는 문서입니다.
auth/invalid-uid
Firebase Admin Node.js Authentication API에서 UID가 비어 있거나 문자열이 아니거나 128자를 초과할 때 식별하는 오류 코드입니다.
auth/invalid-user-import
Firebase Admin Node.js Authentication API에서 사용자 가져오기 레코드가 유효하지 않을 때 발생하는 auth/invalid-user-import 오류 코드입니다.
auth/missing-oauth-client-secret
Firebase Admin Node.js Authentication API에서 OIDC 코드 흐름을 활성화하는 데 OAuth 구성 클라이언트 시크릿이 필요함을 나타내는 오류 코드입니다.
auth/email-already-exists
Firebase Admin Node.js Authentication API에서 이메일이 기존 사용자에게 이미 사용 중일 때 발생하는 오류 코드입니다.
auth/id-token-expired
Firebase Admin Node.js Authentication API에서 제공된 Firebase ID 토큰이 만료되었을 때 표시되는 오류 코드입니다.
auth/invalid-argument
Firebase Admin Authentication 메서드에 유효하지 않은 인수가 제공되었을 때의 오류 코드입니다.
auth/invalid-claims
Firebase Admin Node.js Authentication API에서 setCustomUserClaims()에 제공한 custom claim 속성이 유효하지 않을 때 발생하는 오류 코드입니다.
auth/invalid-disabled-field
Firebase Admin Node.js Authentication API에서 disabled 사용자 속성 값이 boolean이 아닐 때 발생하는 오류 코드입니다.
auth/invalid-dynamic-link-domain
Firebase Admin Node.js Authentication API에서 동적 링크 도메인이 현재 프로젝트에 구성되었거나 승인되지 않았을 때 표시되는 오류 코드입니다.
auth/invalid-email-verified
Firebase Admin Node.js Authentication API에서 emailVerified 사용자 속성 값이 boolean이 아닐 때 발생하는 오류 코드입니다.
auth/invalid-hash-algorithm
Firebase Admin Node.js Authentication API에서 해시 알고리즘이 지원되는 알고리즘 목록의 문자열과 일치하지 않을 때 발생하는 오류 코드입니다.
auth/invalid-hash-key
Firebase Admin Node.js Authentication API의 `auth/invalid-hash-key` 오류 코드를 식별합니다.
auth/invalid-hash-parallelization
Firebase Admin Node.js Authentication API에서 해시 병렬화 값이 유효한 숫자가 아닐 때 발생하는 오류 코드입니다.
auth/invalid-hash-rounds
Firebase Admin Node.js Authentication API에서 해시 반복 횟수가 유효한 숫자가 아닐 때 표시되는 오류 코드입니다.
auth/invalid-hash-salt-separator
Firebase Admin Node.js Authentication API에서 해싱 알고리즘의 salt separator 필드가 유효한 byte buffer가 아닐 때 식별되는 오류 코드입니다.
auth/invalid-last-sign-in-time
Firebase Admin Node.js Authentication API에서 마지막 로그인 시간이 유효한 UTC 날짜 문자열이 아닐 때 발생하는 오류 코드입니다.
auth/invalid-password
Firebase Admin Node.js Authentication API에서 비밀번호 user property 값이 유효하지 않을 때 발생하는 오류 코드입니다.
auth/invalid-password-salt
Firebase Admin Node.js Authentication API에서 비밀번호 솔트가 유효한 byte buffer가 아닐 때 식별하는 오류 코드입니다.
auth/invalid-photo-url
Firebase Admin Node.js Authentication API에서 photoURL 사용자 속성 값이 유효하지 않을 때 발생하는 오류 코드입니다.
auth/maximum-user-count-exceeded
Firebase Admin Node.js Authentication API에서 사용자 가져오기 허용 최대 수를 초과했음을 나타내는 오류 코드입니다.
auth/missing-continue-uri
Firebase Admin Node.js Authentication API에서 `auth/missing-continue-uri`가 표시되면 요청에 유효한 continue URL이 제공되지 않았음을 뜻합니다.
auth/missing-hash-algorithm
Firebase Admin Node.js Authentication API에서 비밀번호 해시가 있는 사용자를 가져올 때 해시 알고리즘과 매개변수가 제공되지 않았음을 나타내는 오류 코드입니다.
The request is missing a Bundle ID.
Firebase Admin Node.js Authentication API에서 요청에 Bundle ID가 없을 때 표시되는 오류를 식별합니다.
auth/missing-uid
Firebase Admin Node.js Authentication API에서 현재 작업에 uid 식별자가 필요할 때 발생하는 오류 코드입니다.
auth/phone-number-already-exists
Firebase Admin Node.js Authentication API에서 이미 기존 사용자에게 사용 중인 전화번호를 제공했을 때 표시되는 오류 코드입니다.
auth/project-not-found
Firebase Admin SDK 초기화에 사용한 인증 정보에서 Firebase 프로젝트를 찾지 못했음을 나타내는 오류 코드입니다.
auth/reserved-claims
Firebase Admin Node.js Authentication API에서 `setCustomUserClaims()`에 예약된 커스텀 클레임 키를 제공했을 때 발생하는 오류 코드입니다.
참고 자료
확인 범위: authentication-error-codes, error-code-identification · 확인일: 2026-07-24