이 문서에서는 마이그레이션 이유, 자동화된 프로세스, 기존 reCAPTCHA 구현에 미치는 영향을 비롯하여reCAPTCHA 클래식에서 reCAPTCHA Enterprise로의 마이그레이션을 설명합니다. Google Cloud
reCAPTCHA로 마이그레이션하는 이유
reCAPTCHA on Google Cloud 는 계정 방어, SMS 방어, 다중 인증(MFA), 사기 방지와 같은 엔터프라이즈급 기능을 제공합니다. 이 플랫폼은 대시보드에 Google Cloud 를 사용하고 Cloud Monitoring 및 Looker와 통합하여 모니터링, 보고, 알림을 개선합니다.
키를 직접 마이그레이션하든 자동 마이그레이션을 기다리든 키는 코드 변경 없이 계속 작동합니다.
기존 키 및 데이터에 미치는 영향
기존 v2 또는 v3 사이트 키는 마이그레이션 후에도 계속 작동합니다. 웹사이트에서 코드를 변경할 필요가 없습니다. 프로젝트 소유권 초대를 즉시 수락하지 않아도 키는 계속 작동합니다.
Google Cloud-기반 배포 이점
-기반 배포로 전환하면 다음과 같은 혜택이 있습니다. Google Cloud
- 간소화된 기술: 모든 reCAPTCHA 개발은 이 고유한 제품에 전념합니다.
- 더 강력한 규정 준수: 이 플랫폼은 데이터 컨트롤러에서 데이터 프로세서로 전환하여 데이터 보호 규정 준수를 개선합니다.
- 고급 기능 노출: 계정 방어 및 비밀번호 방어와 같은 고급 기능과 생성형 AI 통찰력 및 향상된 대시보드를 포함한 개선된Google Cloud 환경에 액세스할 수 있습니다.
- 서비스 약관 문제 해결: 이 플랫폼은 사용자의 전이적 엔터프라이즈 사용 서비스 약관이 데이터 사용을 제한하는 문제를 해결합니다.
자동 마이그레이션 프로세스 개요
키를 직접 마이그레이션하지 않으면 reCAPTCHA가 자동으로 마이그레이션합니다. 자동 마이그레이션은 Google Cloud 프로젝트를 프로비저닝하고 reCAPTCHA 키를 해당 프로젝트와 연결합니다. 자동 마이그레이션에는 다음 단계가 포함됩니다.
Google Cloud 기존 키를 보관할프로젝트가 생성됩니다.
프로젝트 키가 Google Cloud 프로젝트와 연결됩니다.
프로젝트 소유권을 수락하라는 이메일 초대가 전송됩니다. 키에 소유자가 여러 명인 경우 모든 소유자가 동일한 새 프로젝트에 초대됩니다.
프로젝트 소유권 초대는 만료되지 않습니다. 키는 마이그레이션 후에도 계속 작동합니다. 하지만 키를 관리하려면(예: 키를 만들거나 삭제하거나 수정) 프로젝트를 수락해야 합니다.
Google Workspace 사용자: 작업공간 조직에서 에 대한 액세스를 제한했을 수 있습니다 Google Cloud. 이 문제를 해결하려면 관리자에게 Google 관리 콘솔에서 Google Cloud 서비스 를 사용 설정해 달라고 요청하세요. 자세한 내용은 사용자에게 사용 설정 또는 사용 중지를 Google Cloud 참고하세요.
기존 Google Cloud 조직이 있는 경우 migrate할 수 있습니다. 자동 마이그레이션 프로세스에서 만든 프로젝트를 기존 Google Cloud 조직으로 기존 프로젝트에서 reCAPTCHA 통합을 관리하려면 해당 프로젝트에서 새 reCAPTCHA 키를 만드세요.
마이그레이션 타임라인
모든 reCAPTCHA 클래식 고객은 직접 마이그레이션하거나 자동으로 마이그레이션됩니다 Google Cloud. 이 프로세스에는 다음 단계가 포함됩니다.
- 2024년 3분기: 새 클래식 키는 더 이상 허용되지 않습니다.
- 2025년 1분기: 고객에게 직접 마이그레이션 도구를 사용하여 마이그레이션하도록 알리는 첫 번째 알림이 전송됩니다.
- 2025년 3분기: 아직 클래식에서 마이그레이션하지 않은 고객에게 후속 알림이 전송되며, 이 알림은 콘솔의 마이그레이션 도구로 직접 연결됩니다. Google Cloud
- 2025년 4분기: 클래식 키의 자동 마이그레이션을 시작합니다.
- 2026년 1분기: 자동 마이그레이션을 완료합니다. 프로젝트가 없는 키의 API 액세스가 잠깁니다. Google Cloud
편한 시간에 클래식 계정을 마이그레이션할 수 있습니다. 마이그레이션을 계획할 때 회사의 코드 동결 일정을 고려하세요. 계정을 마이그레이션하지 않으면 Google팀에서 10월에 클래식 계정을 자동으로 마이그레이션합니다. 즉각적인 코드 변경은 필요하지 않습니다. SiteVerify 요청은 마이그레이션 전과 마찬가지로 계속 작동합니다. 계정이 로 마이그레이션된 후 마이그레이션하고 평가를 만들어 고급 기능을 사용하세요. Google Cloud
reCAPTCHA 관리 콘솔 액세스
reCAPTCHA 관리 콘솔 은 계속 사용할 수 있습니다. 계정을 Google Cloud로 마이그레이션한 후에도 reCAPTCHA 관리 콘솔에서 이전 데이터와 클래식 계정과 관련된 모든 구성을 계속 액세스할 수 있습니다. 하지만 키 구성 변경은 콘솔을 통해 이루어져야 합니다. Google Cloud
결제 및 시정 조치
reCAPTCHA Enterprise에는 월간 평가 10,000회의 무료 등급이 있습니다. 월 10,000회 이상의 평가를 사용하려면 프로젝트에 결제를 사용 설정해야 합니다. Google Cloud
자동 마이그레이션 후 월간 무료 평가 10,000회를 초과하고 결제를 사용 설정하지 않으면 reCAPTCHA가 새 요청에 대해 오류를 반환합니다.
SiteVerify요청: 마이그레이션 후 할당량을 초과하는SiteVerify요청은fail open됩니다. 즉, 점수가0.9인success:true를 반환하고 API 응답에는 할당량을 초과했음을 나타내는 오류 메시지가 포함됩니다. 이 동작은 이전 클래식 reCAPTCHA 정책과 마찬가지로 유효한 사용자가 차단되지 않도록 설계되었습니다. 이는 Enterprise 키의 API 동작 변경사항입니다.CreateAssessment요청: 할당량을 초과하는CreateAssessment요청은fail closed됩니다. 즉, 요청이Resource Exhausted (429)HTTP 오류를 반환하고Assessment가 생성되지 않습니다. 이를 방지하기 위해 할당량 초과 알림 및 이메일에서 결제 계정이 누락되었음을 알려줍니다.
키 관리 및 모니터링
마이그레이션 후 키 관리를 위해 Google Cloud 콘솔에 온보딩합니다. 콘솔을 사용하여 사이트의 트래픽을 모니터링하고 마이그레이션 후에 발생하는 요청의 위험을 분석합니다. Google Cloud