auth/operation-not-allowed

확인

Firebase Admin Node.js Authentication API에서 반환된 오류 코드가 auth/operation-not-allowed와 일치하는지 확인합니다.

이 코드가 일치하면 제공된 로그인 제공업체가 Firebase 프로젝트에서 사용 중지된 상태입니다.

조치

Firebase Console의 로그인 방법 섹션에서 해당 로그인 제공업체를 사용 설정합니다.

재확인

변경 후 같은 로그인 제공업체로 요청을 다시 수행하여 auth/operation-not-allowed가 다시 반환되는지 확인합니다.

진단 기록

먼저 문제가 발생한 URL 또는 화면, 표시 시각, 사용한 플랫폼과 배포 버전을 기록합니다. 화면과 로그에서 오류 문자열이 일부만 보이면 앞뒤 문장을 포함해 원문을 보존하고, 민감한 값은 가립니다.

다음 순서로 관찰값을 대조합니다.

1. Firebase Admin Node.js Authentication API에서 반환된 오류 코드가 auth/operation-not-allowed와 일치하는지 확인합니다.
2. Firebase Console의 로그인 방법 섹션에서 해당 로그인 제공업체의 사용 설정 상태를 확인합니다.

각 항목은 확인한 값과 확인하지 못한 이유를 함께 기록해야 합니다. 이 문서의 조건과 실제 관찰값이 다르면 원인을 단정하지 말고, 문제 해결 시작 가이드에서 더 넓은 분기를 선택하십시오.

판정 기준

오류 문자열이 일치한다는 사실만으로 원인이 확정되지는 않습니다. 같은 문구가 여러 환경에서 나타날 수 있으므로 웹서버·런타임·운영체제·최근 변경 사항을 함께 비교합니다. 한 단계에서 기대한 값이 나오지 않으면 다음 단계로 넘어가지 말고 해당 환경의 공식 문서를 우선 확인합니다.

안전한 다음 단계

검사 전에 백업과 변경 이력을 확인하고, 비밀번호·세션 쿠키·인증 토큰·개인정보를 공개 로그나 문의 내용에 넣지 않습니다. 설정·권한·데이터를 변경해야 한다면 영향 범위와 되돌리는 방법을 먼저 기록한 뒤 운영 시간과 승인 절차에 맞춰 진행합니다.

원인 분포

[Observation] 관측된 사례 기준으로 다음 원인이 확인되었습니다.

원인	관측 사례
로그인 제공업체 비활성화	1건
SMS region policy의 대상 국가 차단	1건
이메일 열거 방지 설정	1건

[Observation] 이 집계는 제공된 사례의 관측 결과이며 실제 발생 빈도를 의미하지 않습니다.

오진 함정

• [Observation] 전화번호 제공업체가 활성화되어 있어도 SMS region policy가 대상 국가를 차단하면 auth/operation-not-allowed가 발생할 수 있습니다.
• [Observation] 이메일 변경 실패는 로그인 제공업체 비활성화만으로 설명되지 않으며, 이메일 열거 방지 설정이 활성화된 환경에서도 발생했습니다.
• [Hypothesis] 오류 코드만으로 단일 원인을 확정하지 말고 요청 기능과 프로젝트 인증 설정을 함께 확인해야 합니다.

환경 매트릭스

환경	요청 기능	확인된 설정	결과
Ionic 앱	Firebase 가입 API	익명·이메일 등 로그인 제공업체 비활성화	제공업체 활성화 후 해결
Angular 웹 앱	전화번호 로그인	SMS region policy가 대상 국가 차단	발송 허용 지역 추가 후 동작
React Native 앱, 새 Firebase 프로젝트	이메일 변경	이메일 열거 방지 설정 활성화	설정 검토·변경 후 정상 처리

진단 순서

1. [Observation] 실패한 인증 기능이 사용하는 로그인 제공업체를 확인합니다.
2. [Observation] Firebase Console Auth 설정에서 해당 제공업체의 활성화 상태를 확인합니다.
3. [Observation] 전화번호 로그인이라면 SMS region policy가 대상 국가를 차단하는지 확인합니다.
4. [Observation] 이메일 변경이라면 이메일 열거 방지 설정이 활성화되어 있는지 확인합니다.
5. [Observation] 설정을 변경한 뒤 동일한 인증 요청이 정상 처리되는지 확인합니다.