다음 도구와 리소스는 악용 방지 전략의 일부로 Play Integrity API를 최대한 활용하는 데 도움이 됩니다.
Play Integrity API 상태 모니터링
Play 상태 대시보드에는 Play Integrity API의 상태 정보가 표시됩니다. 장애 및 서비스 중단 등 서비스 상태에 관한 정보가 게시됩니다. 페이지에 나열되지 않은 문제가 발생하는 경우 Google Play 개발자 지원팀에 문의하세요.
앱 내에서 다양한 Play Integrity API 응답 테스트
Play Integrity API가 앱과 상호작용하는 방식을 평가하는 테스트를 만들 수 있습니다. 지정한 이메일 주소의 경우 Google Play 서버에서 앱에 어떤 무결성 확인 결과 또는 오류 코드를 받아야 하는지 선택할 수 있습니다. 이를 통해 앱이 가능한 모든 응답과 오류에 어떻게 반응하는지 테스트할 수 있습니다.
Play Console에서 테스트를 설정할 수 있습니다. 왼쪽 메뉴에서 Google Play로 보호됨 으로 이동합니다. Play Integrity API 옆에 있는 관리 를 클릭하고 테스트 를 찾아 시작합니다. 자세한 내용은 Play Console 고객 센터를 참고하세요.
테스트 응답의 경우 추가 testingDetails 필드가
반환된 페이로드에 표시됩니다.
"testingDetails": { "isTestingResponse": true }
앱에서 수신하는 Play Integrity API 응답 분석
Play Console에서 Play Integrity API의 보고서에 액세스하여 앱에서 수신하는 응답을 파악하고 잠재적 문제를 식별할 수 있습니다. 보고서를 보려면 Google Play로 보호됨 으로 이동하여 Play Integrity API 모니터링 섹션에서 오른쪽 화살표 아이콘을 클릭합니다.
보고서에는 다음이 표시됩니다.
- 앱에서 요청하는 표준 및 기존 요청의 양입니다.
- 기기, 앱, 계정 세부정보에 관한 각 확인 결과 응답의 분석입니다. 선택적 확인 결과는 아직 보고서에 표시되지 않습니다.
- 앱에서 발생하는 가장 일반적인 오류 코드입니다.
- 인식할 수 없는 앱 버전의 가장 일반적인 인증서입니다.
앱 버전, 국가, Android OS 버전별로 보고서를 필터링하여 무결성 확인 결과를 더 자세히 볼 수 있습니다. 요청량이 적은 경우 사용자 개인 정보 보호를 위해 데이터가 표시되지 않습니다.
모든 기기에서 기기 무결성 확인 결과 확인
특정 기기의 앱에 관해 Play Integrity API가 반환하는 무결성 확인 결과를 확인해야 하는 경우(예: 사용자가 신고한 문제를 디버깅하거나 해결하는 동안) Play 스토어 앱을 사용하여 해당 기기의 Play Integrity API 확인 결과를 생성할 수 있습니다.
먼저 기기에서 Play 스토어의 개발자 옵션을 사용 설정합니다. 프로필 아이콘을 탭한 후 설정을 탭합니다. 정보 메뉴를 열고 Play 스토어 버전 라벨이 지정된 행을 일곱 번 탭하여 개발자 모드를 잠금 해제합니다.
그런 다음 Android 기기에서 확인 결과를 생성하려면 Play 스토어 앱을 엽니다. 프로필 아이콘을 탭하고 설정을 탭합니다. 일반 메뉴를 열고 개발자 옵션을 탭합니다. Play Integrity 설정에서 무결성 확인을 탭하여 확인 결과를 생성합니다.
원격 기기에서 무결성 확인
기본 휴대전화에서 직접 연결된 Wear OS, Android Automotive OS 또는 Android TV 기기에서 무결성 확인을 시작할 수도 있습니다. 이를 통해 이러한 폼 팩터에서 기기 무결성 확인 결과를 가져올 수 있습니다.
원격 무결성 확인을 실행하려면 다음 단계를 따르세요.
- 기본 휴대전화와 대상 기기(예: 시계, 자동차, TV)가 모두 동일한 Google 계정에 로그인되어 있는지 확인합니다.
- 기본 휴대전화에서 Play 스토어 앱을 열고 설정 > 일반 > 개발자 옵션 으로 이동합니다.
- Play Integrity 섹션에서 무결성 확인 분할 버튼의 확장 화살표를 탭하여 연결된 기기를 확인합니다.
- 드롭다운 목록에서 대상 기기를 선택합니다.
휴대전화에서 원격 기기의 확인을 트리거하고 작업이 완료되면 결과 확인 결과를 표시합니다.
사용자가 무결성 문제를 해결하도록 지원
Play Integrity API는 앱 내에서 트리거하여 사용자가 특정 확인 결과 문제를 해결하도록 지원할 수 있는 다양한 Play remediation dialogs를 제공합니다.
사용자가 기기 무결성 문제를 해결하도록 안내하려면 Play 스토어 앱 내의 문제 해결 기능으로 안내하면 됩니다. 기기 무결성 문제를 해결하려면 사용자에게 다음 단계를 안내하세요.
- Google Play 스토어 앱을 엽니다.
- 오른쪽 상단에서 프로필 아이콘을 탭합니다.
- 설정 > 정보 > Play 프로텍트 인증 을 탭합니다.
- 기기 문제 해결 을 탭합니다. 이 버튼은 기기가 Play 기기 무결성 확인을 통과하지 못한 사용자에게만 표시됩니다. 그러면 사용자에게 문제 해결에 도움이 되는 일련의 메시지가 표시되고 가능한 경우 기기 문제를 해결할 수 있습니다.
엔드 투 엔드 엔터프라이즈 사기 솔루션 고려
완전한 사기 및 봇 관리 솔루션을 원하는 기업 고객은 모바일용 reCAPTCHA Enterprise를 구매할 수 있으며 여기에는 개발자에게 사기 위험 점수를 제공하는 Android용 SDK가 포함되어 있습니다. reCAPTCHA Enterprise는 Play Integrity API 신호를 자동으로 포함하고, 고객을 위해 reCAPTCHA 네트워크 및 애플리케이션 신호와 이를 결합하여 보이지 않는 원활한 사기 관리 솔루션을 즉시 제공합니다. 또한 Play Integrity API를 사용할 수 없는 Android 앱도 보호할 수 있습니다.
지원받기
예상치 못한 Play Integrity API 확인 결과를 신고하려면 요청된 모든 정보와 함께 문제를 제출하세요.
Play Integrity API에 관해 질문하거나 의견을 제공하려면 다음 중 하나를 실행하세요.
- Play Console에서 바로 Google Play 개발자 지원팀에 문의합니다.
- Play Console 고객센터에서 이 양식 을 작성합니다.
앱의 일일 요청 수를 늘리도록 요청하는 경우 최대 1주일이 걸릴 수 있습니다. 서비스가 중단되지 않도록 할당량 알림을 설정할 수도 있는 Google Play Console 또는 Google Cloud 콘솔에서 Play Integrity API 사용을 모니터링하는 것이 좋습니다.