Firebase 콘솔에 앱을 등록하여 reCAPTCHA Enterprise 프로바이더를 사용하는 과정에서 앱의 reCAPTCHA 키를 제공해야 합니다. App Check는 사용자에게 표시되지 않는 점수 기반 reCAPTCHA 키를 사용합니다. 즉, reCAPTCHA Enterprise 제공자는 사용자에게 보안 확인을 요구하지 않습니다.
이 페이지에서는 다음 플랫폼에서 사용할 점수 기반 키를 만드는 방법을 설명합니다. 웹, Android, Apple. 웹 앱 및 모바일 앱의 문서에서 자세한 안내를 확인할 수도 있습니다.reCAPTCHA Enterprise
Flutter의 경우 프로젝트가 타겟팅하는 플랫폼의 안내를 따르세요.
시작하기 전에
다음 플랫폼의 앱에 점수 기반 reCAPTCHA 키를 만들기 전에 이러한 요구사항과 권장사항을 검토하세요. 웹, Android, Apple
필수 IAM 권한
reCAPTCHA Enterprise 관리자 (roles/recaptchaenterprise.admin)라는 IAM 역할이 있는지 확인합니다.
일반 권장사항
Firebase 프로젝트에 만들 수 있는 reCAPTCHA 키 수에는 제한이 없습니다. 다음은 Firebase 프로젝트의 일반적인 설정을 위한 reCAPTCHA 키를 만드는 일반적인 권장사항입니다.
등록된 각 Firebase 앱에 키를 하나씩 만듭니다. 예를 들면 다음과 같습니다.
동일한 Firebase 프로젝트를 공유하는 iOS, Android, 웹 앱이 있는 경우 프로젝트에 키가 3개 있어야 합니다.
동일한 Firebase 프로젝트를 공유하는 동일한 플랫폼의 앱이 여러 개 있는 경우 프로젝트에 각 앱의 키가 있어야 합니다.
개발, 스테이징, 프로덕션 앱에 별도의 키를 만듭니다. 이러한 각 변형은 이미 별도의 Firebase 프로젝트를 사용하고 있어야 합니다. 그렇지 않으면 reCAPTCHA Enterprise 위험 분석을 비프로덕션 환경의 데이터로 오염시킬 위험이 있습니다.
웹
점수 기반 키를 만들려면 Google Cloud 콘솔, gcloud CLI, 또는 REST API를 사용하면 됩니다.
웹사이트의 경우 reCAPTCHA 키는 지정한 도메인과
하위 도메인에 고유합니다. 여러 도메인에서 웹사이트를 제공할 경우 도메인을 2개 이상 지정할 수 있습니다. 도메인을 지정할 때 (예:
examplepetstore.com)는 하위 도메인 (예:
subdomain.examplepetstore.com)을 지정할 필요가 없습니다.
Google Cloud 콘솔
Google Cloud 콘솔에서 Fraud Defense 페이지 (reCAPTCHA 키를 설정하는 곳)로 이동합니다.
올바른 프로젝트에 있는지 확인합니다 (화면 상단의 프로젝트 선택 도구 참고).
키 만들기 를 클릭합니다.
표시 이름 필드에 키의 표시 이름을 입력합니다.
애플리케이션 유형에서 웹을 선택합니다.
도메인과 하위 도메인의 키를 보호하려면 도메인 확인 사용 중지 전환 버튼이 사용 중지되어 있는지 확인합니다.
도메인 목록 섹션에서 다음을 수행합니다.
도메인 추가 를 클릭합니다.
도메인 필드에 도메인 이름을 입력합니다.
(선택사항) 도메인을 더 추가하려면 도메인 추가 를 클릭하고 다른 도메인 이름을 입력합니다.
App Check는 250개가 넘는 도메인에서 제공되는 웹 앱을 지원하지 않습니다.
프로덕션에 사용되는 (또는 사용될) reCAPTCHA 키에
localhost를 도메인으로 추가하지 마세요.
(선택사항) 비프로덕션 앱의 테스트 키를 만들고 평가가 생성될 때 키가 반환되도록 하는 점수를 지정하려면 다음을 수행합니다.
다음 단계 (선택사항) 를 클릭하여 추가 설정 단계로 이동합니다.
reCAPTCHA 테스트를 사용하시겠어요? 전환 버튼을 사용 설정하지 마세요.
이 키를 테스트 목적으로만 만드시나요? 전환 버튼을 사용 설정한 다음 점수 설정 슬라이더를 사용하여 0~1.0 사이의 점수를 지정합니다.
키 만들기 를 클릭합니다.
새로 만든 키가 reCAPTCHA 키 Google Cloud 콘솔의 페이지에 표시됩니다.
gcloud CLI
gcloud CLI를 사용하여 점수 기반 키를 만들려면 reCAPTCHA Enterprise 문서의 안내를 따르세요.
REST
REST API를 사용하여 점수 기반 키를 만들려면 다음 안내를 따르세요. reCAPTCHA Enterprise 문서
Android
점수 기반 키를 만들려면 Google Cloud 콘솔, gcloud CLI, 또는 REST API를 사용하면 됩니다.
Google Cloud 콘솔
Google Cloud 콘솔에서 Fraud Defense 페이지 (reCAPTCHA 키를 설정하는 곳)로 이동합니다.
올바른 프로젝트에 있는지 확인합니다 (화면 상단의 프로젝트 선택 도구 참고).
키 만들기 를 클릭합니다.
표시 이름 필드에 키의 표시 이름을 입력합니다.
애플리케이션 유형 에서 Android 를 선택합니다.
Android 앱의 키를 보호하려면 패키지 이름 확인 사용 중지 전환 버튼이 사용 중지되어 있는지 확인합니다.
Android 패키지 목록 섹션에서 다음을 수행합니다.
Android 패키지 추가 를 클릭합니다.
Android 패키지 필드에 Android 앱의 패키지 이름 (예:
com.example.my_app)을 입력합니다.Firebase 프로젝트에서 Firebase Android 앱을 만들 때 제공한 것과 동일한 패키지 이름을 입력해야 합니다. 패키지 이름 값은 대소문자를 구분합니다.
App Check의 경우 각 패키지 이름은 단일 reCAPTCHA 키에만 해당할 수 있습니다.
Google Play Store 외에 다른 앱 스토어에서 사용할 수 있는 앱의 키를 만들려면 Google Play 스토어 외부에 배포된 애플리케이션 지원 전환 버튼을 사용 설정합니다.
(선택사항) 비프로덕션 앱의 테스트 키를 만들고 평가가 생성될 때 키가 반환되도록 하는 점수를 지정하려면 다음을 수행합니다.
다음 단계 (선택사항) 를 클릭하여 추가 설정 단계로 이동합니다.
reCAPTCHA 테스트를 사용하시겠어요? 전환 버튼을 사용 설정하지 마세요.
이 키를 테스트 목적으로만 만드시나요? 전환 버튼을 사용 설정한 다음 점수 설정 슬라이더를 사용하여 0~1.0 사이의 점수를 지정합니다.
키 만들기 를 클릭합니다.
새로 만든 키가 reCAPTCHA 키 Google Cloud 콘솔의 페이지에 표시됩니다.
gcloud CLI
gcloud CLI를 사용하여 점수 기반 키를 만들려면 reCAPTCHA Enterprise 문서의 안내를 따르세요.
REST
REST API를 사용하여 점수 기반 키를 만들려면 다음 안내를 따르세요. reCAPTCHA Enterprise 문서
Apple 플랫폼
점수 기반 키를 만들려면 Google Cloud 콘솔, gcloud CLI, 또는 REST API를 사용하면 됩니다.
Google Cloud 콘솔
Google Cloud 콘솔에서 Fraud Defense 페이지 (reCAPTCHA 키를 설정하는 곳)로 이동합니다.
올바른 프로젝트에 있는지 확인합니다 (화면 상단의 프로젝트 선택 도구 참고).
키 만들기 를 클릭합니다.
표시 이름 필드에 키의 표시 이름을 입력합니다.
**애플리케이션 유형** 에서 **iOS** 를 선택합니다.
Apple 플랫폼 앱의 키를 보호하려면 번들 ID 확인 사용 중지 전환 버튼이 사용 중지되어 있는지 확인합니다.
iOS 번들 ID 목록 목록 섹션에서 다음을 수행합니다.
iOS 번들 ID 추가 를 클릭합니다.
번들 ID 필드에 앱의 번들 ID(예:
com.example.my_app)를 입력합니다.Firebase 프로젝트에서 Firebase Apple 앱을 만들 때 제공한 것과 동일한 번들 ID를 입력해야 합니다. 번들 ID 값은 대소문자를 구분합니다.
App Check의 경우 각 번들 ID는 단일 reCAPTCHA 키에만 해당할 수 있습니다.
(선택사항) 번들 ID를 더 추가하려면 iOS 번들 ID 추가 를 클릭하고 다른 번들 ID를 입력합니다.
Apple 개발자 설정 을 제공합니다.
reCAPTCHA Enterprise가 트래픽에 대해 보다 정확한 위험 점수를 제공할 수 있으므로 이 데이터를 제공하는 것이 좋습니다.reCAPTCHA Enterprise
다음 정보를 입력합니다.
비공개 키 (.p8): Apple Developer Center의 인증서, 식별자, 프로필 아래에 생성됩니다.
키 식별자: Apple 개발자 키 식별자 (10자 문자열)입니다.
팀 ID: 애플리케이션을 빌드하는 데 사용되는 프로비저닝 프로필을 소유하는 Apple팀 ID (10자 문자열)입니다.
(선택사항) 비프로덕션 앱의 테스트 키를 만들고 평가가 생성될 때 키가 반환되도록 하는 점수를 지정하려면 다음을 수행합니다.
다음 단계 (선택사항) 를 클릭하여 추가 설정 단계로 이동합니다.
reCAPTCHA 테스트를 사용하시겠어요? 전환 버튼을 사용 설정하지 마세요.
이 키를 테스트 목적으로만 만드시나요? 전환 버튼을 사용 설정한 다음 점수 설정 슬라이더를 사용하여 0~1.0 사이의 점수를 지정합니다.
키 만들기 를 클릭합니다.
새로 만든 키가 reCAPTCHA 키 Google Cloud 콘솔의 페이지에 표시됩니다.
gcloud CLI
gcloud CLI를 사용하여 점수 기반 키를 만들려면 reCAPTCHA Enterprise 문서의 안내를 따르세요.
REST
REST API를 사용하여 점수 기반 키를 만들려면 다음 안내를 따르세요. reCAPTCHA Enterprise 문서