이 문서에서는 reCAPTCHA 키 버전(v2 또는 v3)을 식별하고, 기존 reCAPTCHA 관리 콘솔 용어를Google Cloud 콘솔에 매핑하고, 콘텐츠 관리 시스템(CMS) 플랫폼 및 서드 파티 플러그인(예: WordPress 또는 Shopify 통합)에 필요한 사이트 키와 보안 비밀 키를 검색하는 방법을 설명합니다.
기존 용어를 Google Cloud 콘솔에 매핑
reCAPTCHA 관리 콘솔에서만 키를 관리하는 경우 reCAPTCHA 클래식을 사용 중인 것입니다. Google Cloud 콘솔의 Google Cloud Fraud Defense 페이지에서 키를 관리하는 경우 Fraud Defense를 사용하는 것입니다. 두 콘솔 모두 v2 및 v3 웹사이트 키를 지원합니다.
많은 CMS 플랫폼과 플러그인은 v2 Checkbox, v2 Invisible, v3와 같은 기존 버전 번호를 사용하여 reCAPTCHA 키를 참조합니다.Google Cloud 콘솔은 버전 번호 대신 플랫폼 기반 설명자를 사용합니다.
다음 표에서는 기존 CMS 및 관리 콘솔 용어를Google Cloud 콘솔 용어에 매핑합니다.
| CMS 또는 관리 콘솔 용어 | Google Cloud 콘솔 (플랫폼 세부정보) | 키 수정 (유형 필드) | 인증 메커니즘 및 CMS 호환성 |
|---|---|---|---|
| 점수 기준 (v3) | Website • score |
Website • Score |
원활한 점수 기반 인증 reCAPTCHA v3가 필요한 CMS 플러그인에 사용합니다. |
| 테스트 (v2) | Website • checkbox |
Website • Checkbox challenge |
사용자가 '로봇이 아닙니다' 체크박스를 선택해야 합니다. reCAPTCHA v2 체크박스가 필요한 CMS 플러그인에 사용합니다. |
| 보이지 않음 (v2) | Website • invisible |
Website • Invisible integration |
백그라운드에서 위험을 분석하고 테스트를 표시할 수 있습니다. reCAPTCHA v2 Invisible이 필요한 CMS 플러그인에 사용합니다. |
| 해당 사항 없음 | Website • policy-based challenge |
Website • Policy-based challenge |
구성된 점수 기준점에 따라 테스트를 트리거합니다. 커스텀 CreateAssessment 통합이 필요합니다. |
| 해당 사항 없음 | iOS |
iOS app |
iOS 모바일 키(챌린지 없음) |
| 해당 사항 없음 | Android |
Android app |
챌린지가 없는 Android 모바일 키 |
Google Cloud 콘솔에서 키 버전 보기
Google Cloud 콘솔에서 키 버전을 보려면 다음을 수행합니다.
Google Cloud 콘솔에서 Fraud Defense 페이지로 이동합니다.
키 탭을 선택합니다.
키가 카드 보기에 있는 경우 표 보기로 전환합니다.
키의 플랫폼 세부정보 열을 확인합니다. 예를 들어
Website • score은v3에 해당하고Website • checkbox는v2 Checkbox에 해당합니다.(선택사항) 카드 뷰에서 키 카드의 주요 세부정보를 클릭한 후 키 수정을 선택합니다. 유형 필드에는
v3의 경우Website • Score또는v2 Checkbox의 경우Website • Checkbox challenge와 같은 키 구성이 표시됩니다.
사이트 키 및 보안 비밀 키 찾기
서드 파티 플러그인 및 CMS 플랫폼에는 reCAPTCHA 통합을 위한 사이트 키와 보안 비밀 키가 필요한 경우가 많습니다.
- 사이트 키: Google Cloud 콘솔에서 키 ID는 사이트 키에 해당합니다.
- 보안 비밀 키: Google Cloud 인증은 일반적으로 API 키 또는 Identity and Access Management 역할을 사용하므로 Google Cloud 콘솔에는 기본적으로 보안 비밀 키가 표시되지 않습니다. 하지만 필요한 플러그인의 기존 보안 비밀 키를 검색할 수 있습니다. 일부 서드 파티 라이브러리 또는 문서에서는 기존 보안 비밀 키를 비공개 키라고 부를 수 있습니다.
Google Cloud 콘솔에서 보안 비밀 키 가져오기
사이트 키와 보안 비밀 키를 가져오려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Fraud Defense 페이지로 이동합니다.
키 탭을 선택합니다.
reCAPTCHA 키 섹션에서 보안 비밀 키가 필요한 키로 이동합니다.
- 카드 보기에 있는 경우 키 카드에서 키 세부정보를 클릭합니다. 키 ID가 페이지 상단에 표시됩니다.
- 테이블 뷰에 있는 경우 테이블에 키 ID가 표시됩니다. 키를 클릭하여 세부정보 페이지로 이동합니다.
페이지 상단에 표시된 키 ID를 복사합니다. 이 값은 사이트 키입니다.
통합 탭으로 이동합니다.
키 상태에 따라 다음 중 하나를 수행합니다.
- 키가 기존 사용을 위해 구성된 경우 기존 키 사용을 클릭합니다.
- 키가 기존 서비스와 통합되지 않은 경우 서드 파티 서비스 또는 플러그인과 통합을 클릭합니다.
보안 비밀 키가 포함된 대화상자가 표시됩니다. 이 값을 안전하게 복사합니다. 이 보안 비밀을 민감한 정보로 취급합니다.
또는 키 세부정보 페이지에서 키 수정을 클릭한 후 보안 비밀 키 필드 옆에 있는 표시를 클릭합니다.
WordPress, Shopify 또는 기타 CMS 플랫폼과 통합
웹사이트 작성 도구, 전자상거래 플랫폼 또는 CMS 플러그인을 사용하는 경우 플랫폼 또는 플러그인이 reCAPTCHA 스크립트를 로드하고 사용자 토큰을 자동으로 확인합니다. reCAPTCHA 클라이언트 라이브러리를 설치하거나 커스텀 백엔드 코드를 작성할 필요가 없습니다.
CMS 또는 서드 파티 플러그인에서 reCAPTCHA를 구성하려면 다음을 수행합니다.
- CMS 또는 플러그인에 필요한 reCAPTCHA 버전 확인: CMS 또는 플러그인에서 reCAPTCHA 통합 설정을 열고 지원하는 키 유형 (일반적으로 reCAPTCHA v3 또는 reCAPTCHA v2 체크박스)을 확인합니다.
일치하는 키를 선택하거나 만듭니다.
- 이미 키가 있는 경우 키 버전을 확인하여 플러그인에서 선택한 버전 (
v3의 경우Website • score,v2 Checkbox의 경우Website • checkbox)과 일치하는지 확인합니다. - 새 키가 필요한 경우 필요한 버전과 일치하는 웹사이트용 키를 만들고 키의 도메인 목록에 웹사이트 도메인 (예:
example.com)을 추가합니다.
- 이미 키가 있는 경우 키 버전을 확인하여 플러그인에서 선택한 버전 (
사이트 키 및 기존 보안 비밀 키 복사: Google Cloud 콘솔에서 보안 비밀 키 검색의 단계에 따라 키 ID (사이트 키) 및 보안 비밀 키를 가져옵니다.
CMS 또는 플러그인 설정에 키를 입력합니다.
- 키 ID를 사이트 키 필드에 붙여넣습니다.
- 비밀번호 (또는 비공개 키) 필드에 비밀번호를 붙여넣은 다음 설정을 저장합니다.
평가를 사용하여 커스텀 웹사이트 통합
CreateAssessment 메서드는 상세한 위험 분석 및 이유 코드를 제공하고 고급 Fraud Defense 기능에 액세스할 수 있게 해줍니다. reCAPTCHA 클라이언트 라이브러리 또는 REST API를 사용하여 CreateAssessment 메서드를 호출할 수 있습니다.
자세한 내용은 웹사이트 평가 만들기를 참조하세요.
기존 SiteVerify 메서드
신규 및 맞춤 통합에는 CreateAssessment 메서드를 사용하는 것이 좋지만 일부 기존 시스템이나 서드 파티 플러그인은 여전히 기존 SiteVerify 메서드를 사용합니다. 이 메서드에는 reCAPTCHA 키와 연결된 보안 비밀 키가 필요합니다.
기존 SiteVerify API가 필요한 시스템과 통합해야 하는 경우 기존 SiteVerify로 사용자 응답 토큰 확인을 참고하세요.