범용 편집기에서 양식에 Google reCAPTCHA 추가

Google reCAPTCHA는 사람 사용자와 자동화된 봇을 구분하여 양식을 보호하는 데 도움이 됩니다. Edge Delivery Services Forms은 점수 기반 사이트 키가 있는 reCAPTCHA Enterprise만 지원합니다. 이 안내서에서는 범용 편집기에서 양식에 대해 이 보호를 구성하는 방법을 설명합니다.

목표:

  • 점수 기반 사이트 키로 reCAPTCHA Enterprise 구성
  • 양식에 reCAPTCHA를 추가합니다.
  • 구현의 유효성을 검사하고 테스트합니다.
  • 성능을 모니터링하고 최적화합니다.

사전 요구 사항

시작하기 전에 다음 사전 요구 사항이 충족되었는지 확인합니다.

액세스 요구 사항

  • AEM as a Cloud Service 작성 액세스
  • 양식 편집 권한이 있는 범용 편집기 액세스

기술 요구 사항

  • 활성화된 Google 계정
  • 청구가 활성화된 Google Cloud Platform 프로젝트
  • 양식에 대한 확인된 도메인 소유권

지식 요구 사항

  • AEM Forms 및 범용 편집기에 대한 기본 지식
  • 클라우드 서비스 구성에 대한 이해
  • 양식 보안 개념에 대한 이해

양식에 reCAPTCHA를 사용하는 이유

reCAPTCHA Enterprise는 사용자 상호 작용을 평가하여 스팸 및 자동 남용으로부터 양식을 보호하는 데 도움이 됩니다. Google은 다음 기능에 대해 설명합니다.

기능
Google이 제공하는 기능
위험 기반 평가
평가된 각 상호 작용에 대해 0.0에서 1.0까지의 점수. 점수가 높을수록 위험이 낮은 것을 나타내고 점수가 낮을수록 위험이 높은 것을 나타냅니다. 웹 사이트에 대한 평가 해석을 참조하십시오.
문제 없는 보호
점수 기반 키는 확인란이나 CAPTCHA 문제를 표시하지 않고 상호 작용을 평가합니다. reCAPTCHA 키를 참조하십시오.
분석 및 보고
대시보드, 글로벌 사기 보고서 및 플랫폼 로깅. Google의 엔터프라이즈 계층에서는 고급 분석, 고객별 부정 행위 보고서 및 공격 조사도 제공합니다. Google의 기능 비교를 참조하십시오.
도메인 제한 사항
웹 사이트 키는 지정된 도메인과 해당 하위 도메인으로 제한될 수 있습니다. 키는 여러 도메인을 포괄할 수 있습니다. 웹 사이트에 대한 reCAPTCHA 키 만들기를 참조하십시오.
추가적인 사기 방지
Google의 광범위한 서비스는 맞춤형 정책, 고급 위험 이유 코드, 계정 및 거래 보호 기능을 제공합니다. 가용성은 계층 및 기능별 구성에 따라 다릅니다. Google의 기능 비교를 참조하십시오.

가격, 할당량 및 지원: 비용은 Google 서비스 계층 및 평가 볼륨에 따라 다릅니다. 사용량은 무제한이 아닌 Google의 할당량을 따릅니다. 현재 가격, 구독 요구 사항 및 지원 옵션에 대해서는 Google의 계층 세부 정보를 참조하십시오. Google은 계층 전반에 걸친 고객 지원 및 엔터프라이즈 계층에 대한 전담 계정 관리 목록을 제공합니다.

reCAPTCHA Enterprise 설정하기

1단계: Google Cloud 환경 준비

요구 사항:

  1. 청구가 활성화된 Google Cloud 프로젝트
  2. 프로젝트 ID (GCP 대시보드에서)
  3. 양식에 대한 도메인 확인
  4. GCP 및 AEM에 대한 관리자 액세스

설정:

  1. Google Cloud 프로젝트를 만들거나 선택합니다.

    • Google Cloud Console로 이동합니다.
    • 새 프로젝트를 만들거나 기존 프로젝트를 선택합니다.
    • 프로젝트 ID를 기록합니다.
  2. reCAPTCHA Enterprise API를 활성화합니다.

    • API 및 서비스 > 라이브러리로 이동합니다.
    • “reCAPTCHA Enterprise API”를 검색합니다.
    • 활성화를 클릭합니다.
  3. API 자격 증명을 만듭니다.

    • API 및 서비스 > 자격 증명으로 이동합니다.
    • 자격 증명 만들기 > API 키를 클릭합니다.
    • API 키를 복사하여 저장합니다.
  4. 사이트 키를 만듭니다.

    • 보안 > Fraud Defense > 키로 이동합니다.
    • 만들기 키를 클릭하고 응용 프로그램 유형으로 웹 을 선택합니다.
    • 도메인을 추가합니다.
    • 다음 단계(선택 사항)를 클릭하여 추가 설정을 엽니다
    • 유지 문제를 해결하시겠습니까? 점수 기반 사이트 키 만들기를 해제했습니다.
    • Create key 를 클릭하고 사이트 키를 복사합니다.

유효성 검사 체크포인트: 다음을 보유하고 있는지 확인합니다.

  • 프로젝트 ID
  • API 키
  • 사이트 키
  • Google Cloud에서 확인된 도메인
2단계: AEM 클라우드 구성 컨테이너 구성

단계별 클라우드 구성 설정
그림: 양식 컨테이너에 대한 클라우드 구성 사용

설정:

  1. 구성 브라우저 액세스

    • AEM 작성자 인스턴스에 로그인합니다.
    • 도구 > 일반 > 구성 브라우저로 이동합니다.
  2. 클라우드 구성 활성화

    • 양식의 구성 컨테이너를 찾습니다.
    • 속성을 선택합니다.
    • 클라우드 구성을 확인합니다.
    • 저장 및 닫기를 클릭합니다.
  3. 구성 확인

    • 컨테이너 속성에 “클라우드 구성”이 표시되는지 확인합니다.

유효성 검사 체크포인트:

  • 컨테이너에 대해 클라우드 구성이 활성화되었습니다.
  • 컨테이너가 구성 브라우저에 표시됩니다.
  • 속성에 “클라우드 구성”이 활성화된 것으로 표시됩니다.
3단계: AEM에서 reCAPTCHA 엔터프라이즈 서비스 구성

reCAPTCHA Enterprise 구성 화면
그림: AEM의 reCAPTCHA 엔터프라이즈 구성 인터페이스

구성:

  1. reCAPTCHA 구성 액세스

    • 도구 > 클라우드 서비스 > reCAPTCHA로 이동합니다.
    • 양식의 구성 컨테이너를 선택합니다.
    • 만들기를 클릭합니다.
  2. Enterprise 설정 구성

    • 제목: 설명적인 이름 (예: “프로덕션 reCAPTCHA”)
    • 이름: 시스템 이름 (자동 생성 또는 사용자 정의)
    • 버전: ReCAPTCHA Enterprise를 선택합니다.
    • 프로젝트 ID: Google Cloud Project ID를 입력합니다.
    • 사이트 키: Google Cloud의 사이트 키를 입력합니다.
    • API 키: Google Cloud API 키를 입력합니다.
    • 키 유형: 점수 기반 사이트 키를 선택합니다.
  3. 보안 임계값 설정

    • 임계값 점수: 0.0에서 1.0 사이로 설정합니다.

    • 권장 값:

      • 0.7-0.9: 높은 보안 수준 (일부 적합한 사용자를 차단할 수 있음)
      • 0.5-0.7: 균형 잡힌 보안 (권장)
      • 0.1-0.5: 낮은 보안 (더 많은 사용자 허용)
  4. 저장 및 게시

    • 만들기를 클릭하여 구성을 저장합니다.
    • 게시를 클릭하여 사용 가능하게 만듭니다.

유효성 검사 체크포인트:

  • 구성이 성공적으로 저장되었습니다.
  • 모든 필수 필드가 완료되었습니다.
  • 구성이 게시되고 표시됩니다.
  • 오류 메시지가 없습니다.

양식에 reCAPTCHA 추가

reCAPTCHA 서비스를 구성한 후 다음과 같이 양식에 보호 기능을 추가합니다.

양식에 reCAPTCHA 구성 요소 추가
그림: 폼에 보이지 않는 Captcha 구성 요소 추가

​1. 유니버설 편집기에서 양식 열기

AEM Sites의 양식으로 이동하고 편집을 클릭하여 범용 편집기에서 엽니다. 편집기가 로드될 때까지 기다립니다.

  • AEM Sites의 양식으로 이동합니다.
  • 편집을 클릭하여 범용 편집기에서 엽니다.
  • 편집기가 로드될 때까지 기다립니다.
​2. 양식 구조 찾기

콘텐츠 트리(왼쪽 패널)에서 적응형 양식 섹션을 찾아 양식 구조를 확장하여 삽입 지점을 확인합니다.

  • 콘텐츠 트리(왼쪽 패널)에서 적응형 양식 섹션을 찾습니다.
  • 양식 구조를 확장하여 삽입 지점을 확인합니다.
​3. reCAPTCHA 구성 요소 추가

양식에 Captcha(보이지 않음) 구성 요소를 추가합니다.

  • 양식 섹션에서 추가(+) 아이콘을 클릭합니다.
  • 구성 요소 목록에서 Captcha(보이지 않음)를 선택합니다.
  • 또는 구성 요소 패널에서 구성 요소를 드래그 앤 드롭합니다.
​4. 구성 요소 구성(선택 사항)

새로 추가한 Captcha 구성 요소를 선택하고 reCAPTCHA 구성을 사용하는지 확인합니다.

  • 새로 추가된 Captcha 구성 요소를 선택합니다.
  • 속성 패널에서 reCAPTCHA 구성을 사용하는지 확인합니다.
  • 기본 설정에는 추가 구성이 필요하지 않습니다.
​5. 변경 사항 게시

변경 사항을 게시하고 오류가 없는지 확인합니다.

  • 범용 편집기에서 게시를 클릭합니다.
  • 확인을 기다립니다.
  • 오류가 표시되지 않는지 확인합니다.

구현을 확인합니다.

보호된 양식은 이제 다음에서 사용할 수 있습니다.

https://<branch>--<repo>--<owner>.aem.live/content/forms/af/
<form-name>

예제 URL:

https://main--my-forms--company.aem.live/content/forms/af/
contact-us-form
recommendation-more-help
experience-manager-cloud-service-help-main-toc