일부 안드로이드 및 iOS 사용자들은 앱 스토어나 플레이 스토어에서 정상적으로 다운로드한 특정 앱을 실행하거나 로그인하려는 순간 오류: disallowed_useragent 메시지가 표시된다고 보고하고 있습니다. 이 오류는 주로 사용자가 구글 계정 인증을 통해 로그인을 시도할 때 나타납니다.
왜 '오류: disallowed_useragent'가 발생할까요?
이 오류는 애플리케이션이 구글에 유효한 로그인 요청을 보내지 못할 때 발생합니다.
대부분의 경우 오류: disallowed_useragent는 안드로이드 또는 iOS 앱이 구글에서 거부하는 방식으로 로그인 요청을 보내기 때문에 나타납니다. 가장 흔한 거부 사유는 승인되지 않은 브라우저 에이전트(user agent)입니다. 즉, 앱이 더 이상 구글이 허용하지 않는 폐기(deprecated)된 브라우저 에이전트를 사용하고 있는 것입니다.
'disallowed_useragent' 오류 해결 방법
안타깝게도 이 문제는 사용자가 직접 통제할 수 있는 범위를 벗어난 경우가 많으며, 대부분 앱 개발자가 수정해야 하는 부분입니다.
그럼에도 불구하고 이 오류를 겪고 있다면 시도해볼 만한 완화 조치가 몇 가지 있습니다.
- 앱을 최신 버전으로 업데이트 – 개발자가 이미 구글의 요구 사항에 맞게 앱을 업데이트했을 수 있습니다. 이 경우 최신 버전으로 업데이트하면 구글이 더 이상 폐기된 브라우저 에이전트를 이유로 연결을 거부하지 않으므로 오류가 해결될 수 있습니다.
- 앱 개발자에게 문제 보고 – 해당 앱이 이미 최신 버전이라면 남은 선택지는 앱 개발자에게 연락해 문제를 알리는 것뿐입니다.
이제 각 해결 방법을 하나씩 자세히 살펴보겠습니다.
1. 앱을 최신 버전으로 업데이트하기
포기하고 문제가 내 손 밖이라고 결론 내리기 전에, 먼저 개발자가 이미 최신 구글 가이드라인에 맞게 앱을 수정했다고 가정해 보세요.
개발자에게 연락하기 전에 오류: disallowed_useragent를 일으키는 앱이 최신 버전으로 업데이트되어 있는지 우선 확인하는 것이 좋습니다.
물론 운영체제에 따라 업데이트 방법이 다르지만, 안드로이드와 iOS 두 가지 모두 안내해 드리겠습니다. 사용 중인 모바일 운영체제에 맞는 하단 가이드로 바로 이동하세요.
1.1. 안드로이드에서 문제의 앱 업데이트하기
안드로이드는 앱을 자동으로 업데이트하지만, 실제 업데이트가 적용되는 시점은 모바일 데이터 또는 Wi-Fi 사용 여부, 배터리 절약 모드를 자주 켜두는 습관이 있는지에 따라 달라질 수 있습니다.
disallowed_useragent 오류가 표시되는 앱에 보류 중인 업데이트가 있다면, 앱 및 기기 관리 메뉴에서 수동으로 업데이트를 설치할 수 있습니다.
참고: 아래 설명은 스마트폰이든 태블릿이든 안드로이드 기기라면 동일하게 적용됩니다.
- 안드로이드 홈 화면에서 구글 플레이 스토어 앱을 엽니다.
- 플레이 스토어 앱에 들어가면 화면 오른쪽 상단의 프로필 아이콘을 탭합니다.
- 나타나는 메뉴에서 앱 및 기기 관리(Manage Apps & Device)를 탭합니다.
- 앱 및 기기 관리 메뉴에서 관리(Manage) 탭을 누른 다음, 업데이트 가능 필터를 선택하고 문제가 되는 앱을 찾습니다.
- 문제의 앱에 설치 대기 중인 업데이트가 있다면 업데이트 버튼을 누르고 완료될 때까지 기다립니다.
- 업데이트 설치가 완료되면 앱을 다시 열어 문제가 해결되었는지 확인합니다.
1.2. iOS에서 문제의 앱 업데이트하기
애플은 안드로이드보다 앱 업데이트를 유도하는 데 훨씬 엄격하지만, 자동 업데이트를 켤지 여부는 결국 사용자의 선택에 달려 있습니다.
iOS 기기에서 앱 자동 업데이트가 꺼져 있고, disallowed_useragent 오류를 일으키는 앱에 보류 중인 업데이트가 있다면 아래 지침에 따라 설치하세요.
참고: 아래 설명은 iPhone, iPad, iPod에서 동일하게 작동합니다.
- iOS 기기의 홈 화면에서 앱 스토어(App Store) 아이콘을 탭합니다.
- 화면 상단의 Apple 프로필 아이콘을 탭하여 앱 스토어 설정 메뉴를 엽니다.
- 열린 메뉴에서 아래로 스크롤하여 사용 가능한 업데이트(Available Updates) 섹션으로 이동합니다.
- 오류를 일으키는 앱 옆의 업데이트 버튼을 클릭합니다.
- 업데이트가 성공적으로 설치되면 앱을 다시 열어 문제가 해결되었는지 확인합니다.
2. 앱 개발자에게 문의하기
앱을 업데이트해도 문제가 해결되지 않았다면, 구글로 전송되는 OAuth 인증 요청이 현재 폐기된 임베디드 사용자 에이전트(embedded user-agent)로 분류되어 오류: disallowed_useragent 메시지가 계속 표시될 가능성이 높습니다.
사용 중인 앱이 구글에서 더 이상 허용하지 않는 방식으로 로그인 요청을 보내고 있다는 것이 명확하므로 해결책도 분명합니다. 앱이 구글의 요구 사항에 맞게 업데이트되거나, GTMAppAuth와 같은 대체 인증 방식으로 전환되어야 합니다.
그러나 일반 사용자 입장에서는 이러한 해결책을 직접 적용할 수 없습니다. 할 수 있는 것은 공식 채널을 통해 앱 개발자에게 문제를 알리는 것뿐입니다.
소규모 인디 팀이 개발한 앱에서 이 오류가 발생한다면, 스토어 등록 정보에 있는 공식 개발자 이메일로 연락하는 것이 유일한 방법일 수 있습니다.
2.1. 안드로이드에서 개발자에게 문의하기
안드로이드 생태계(스마트폰, 태블릿 또는 스마트 TV)에서 오류: disallowed_useragent 문제를 겪고 있다면, 스토어 등록 정보에서 앱 개발자의 연락처 정보를 쉽게 찾을 수 있습니다. 다만 일부 개발자는 사용자 문의에 응답이 매우 느릴 수 있으니 너무 조급해하지 마세요.
참고: 스마트폰, 태블릿, 안드로이드 TV 어디서든 아래 지침을 따를 수 있으며 절차는 거의 동일합니다. 차이점은 각 단계의 참고 문단에 안내되어 있습니다.
- 홈 화면 바로가기를 통해 해당 안드로이드 기기의 구글 플레이 스토어를 엽니다.
- 플레이 스토어 내 검색 기능을 사용해 문제가 되는 앱을 찾습니다.
- 적절한 스토어 페이지를 찾으면 탭하여 들어갑니다.
- 스토어 페이지에서 아래로 스크롤하여 개발자 연락처(Developer contact) 섹션을 찾아 드롭다운 메뉴를 펼칩니다.
참고: 안드로이드 TV에서 진행하는 경우 개발자 연락처 정보는 전체 설명(Full Description) 아래에 있습니다.
- 개발자 연락처 메뉴에서 개발자에게 연락할 수 있는 모든 옵션을 확인할 수 있습니다.
- 마지막으로 문제를 최대한 자세히 설명하여 개발자가 문제를 인지하고 수정할 수 있도록 합니다.
2.2. iOS에서 개발자에게 문의하기
iOS 또는 watchOS를 실행하는 Apple 기기에서 문제가 발생했다면, 앱 제품 페이지 내 앱 지원(App Support) 버튼을 통해 개발자에게 연락할 수 있습니다.
다행히 iOS 개발자는 Apple의 엄격한 가이드라인을 준수해야 하므로 비교적 빠른 답변을 기대할 수 있습니다.
참고: 아래 지침은 iPhone, iPad, iPod touch에서 따를 수 있습니다. watchOS에서는 개발자 연락처 정보를 확인할 수 없으므로, Apple Watch에서 문제가 발생했다면 페어링된 iPhone에서 아래 절차를 진행해야 합니다.
- iPhone, iPad 또는 iPod touch에서 앱 스토어를 엽니다. 홈 화면에서 여는 것이 가장 간편합니다.
- 앱 스토어에 들어가면 상단의 검색 기능으로 문제가 되는 앱을 찾아 결과 목록에서 탭합니다.
참고: 어떤 이유로든 목록을 찾을 수 없다면, 화면 상단의 계정 버튼이나 프로필 사진을 탭한 후 구매 항목(Purchased)을 누르고 해당 앱을 선택하세요. - 앱의 제품 페이지가 나타나면 아래로 스크롤하여 평가 및 리뷰(Ratings & Reviews) 섹션으로 이동한 후 앱 지원(App Support)을 탭합니다.
참고: 앱 지원 섹션이 보이지 않는다면 올바른 Apple ID로 로그인하지 않았기 때문일 수 있습니다.
- 앱 지원 섹션에서 이용 가능한 모든 연락 옵션 목록을 확인할 수 있습니다.
- 연락 방식을 하나 선택하고, 문제를 최대한 자세히 설명하여 개발자가 어떤 상황에서 문제가 발생하는지, 어떻게 수정해야 하는지 파악할 수 있도록 합니다.