reCAPTCHA 키 만들기

이 페이지에서는 웹페이지 또는 모바일 애플리케이션에서 사용자 상호작용을 확인하기 위해 reCAPTCHA 키(사이트 키라고도 함)를 만드는 방법을 설명합니다.

reCAPTCHA 사이트 키는 사이트 또는 앱에 reCAPTCHA Enterprise가 구성된 방식을 나타냅니다. 구성에는 보안문자 챌린지를 표시할지 여부와 같은 중요한 옵션이 포함됩니다. reCAPTCHA 사이트 키는 API 키와 다릅니다.

시작하기 전에

  1. 환경에서 reCAPTCHA Enterprise를 설정하는 가장 좋은 방법을 선택하고 설정을 완료합니다.

  2. 적절한 키 유형을 선택합니다.

  3. 모바일 애플리케이션(모바일 키)용 reCAPTCHA 사이트 키는 보안 검토 후 액세스할 수 있습니다. 이 기능에 사이트를 온보딩하려면 Google 영업팀에 문의하세요.

사이트 키 만들기

프로젝트에 만들 수 있는 reCAPTCHA 키 수에는 제한이 없습니다. 웹사이트 또는 모바일 애플리케이션당 하나의 reCAPTCHA 키를 만드는 것이 가장 좋습니다.

스테이징 및 프로덕션 환경을 위한 별도의 사이트 키를 만듭니다. 그렇지 않으면 테스트 환경의 데이터로 reCAPTCHA 위험 분석을 오염시킬 위험이 있습니다.

사이트 키를 만드는 가장 간단한 방법은 Cloud Console을 사용하는 것입니다. reCAPTCHA Enterprise API 또는 gcloud 명령줄 도구를 사용할 수도 있습니다.

콘솔

  1. Cloud Console에서 reCAPTCHA Enterprise 페이지로 이동합니다.

    reCAPTCHA Enterprise로 이동

  2. 페이지 상단의 리소스 선택기에 프로젝트 이름이 표시되는지 확인합니다.

    프로젝트 이름이 표시되지 않으면 리소스 선택기를 클릭한 다음 프로젝트를 선택합니다.

  3. 키 만들기를 클릭합니다.

  4. 표시 이름 필드에 키의 표시 이름을 입력합니다.
  5. 웹사이트 또는 모바일 플랫폼의 사이트 키를 만듭니다. 안내를 보려면 플랫폼에 해당하는 섹션을 펼칩니다.

    웹사이트의 사이트 키 만들기

    웹사이트용 체크박스 및 점수 기반 사이트 키를 만들 수 있습니다.

    1. 플랫폼 유형 선택 드롭다운 메뉴에서 웹사이트를 선택합니다.

      도메인 목록 섹션이 표시됩니다.

    2. 웹사이트의 도메인 이름 입력:

      1. 도메인 목록 섹션에서 도메인 추가를 클릭합니다.

      2. 도메인 필드에 도메인 이름을 입력합니다.
      3. 선택사항: 도메인을 더 추가하려면 도메인 추가를 클릭하고 도메인 필드에 다른 도메인의 이름을 입력합니다. 도메인을 최대 250개까지 추가할 수 있습니다.

        웹사이트의 경우 reCAPTCHA 사이트 키는 사용자가 지정하는 도메인과 최상위 하위 도메인에 대해 고유합니다. 여러 최상위 도메인에서 웹사이트를 제공하는 경우 2개 이상의 도메인을 지정할 수 있습니다. 예를 들어 examplepetstore.com은 도메인이고 subdomain.examplepetstore.comanother-subdomain.examplepetstore.com은 하위 도메인입니다.

    3. 도메인과 하위 도메인의 reCAPTCHA 사이트 키를 보호하려면 도메인 확인이 선택되어 있는지 확인합니다.

      이 옵션을 선택하지 않으면 사이트에 대한 제한이 없으므로 누구나 reCAPTCHA 키에 액세스하여 사용할 수 있기 때문에 보안상 위험합니다.

    4. 통합 유형 드롭다운 메뉴에서 적절한 키 유형을 선택합니다.

    5. 선택한 통합 유형에 따라 적절한 작업을 수행합니다.
      • 챌린지를 사용자에게 알리지 않고 점수 산출(권장) 옵션을 선택한 경우 이 키가 Accelerated Mobile Pages(AMP)와 함께 작동하도록 허용할 수 있습니다.
      • 점수 산출이 포함된 체크박스('로봇이 아닙니다") 옵션을 선택한 경우 챌린지 보안 옵션을 선택합니다.

        챌린지 보안 옵션은 식별된 카테고리에 따라 사용자에게 이미지를 선택하라는 메시지가 표시되는 보조 챌린지(예: 오토바이 또는 계단이 있는 사진을 선택하세요)가 나타날 가능성을 제어합니다.

        사기를 효과적으로 방지하려면 더 어려운 난이도(봇에 대비한 보안)를 선택합니다.

        가장 낮은 챌린지 난이도를 선택하면 사용자에게 시각적 챌린지가 표시될 가능성이 낮아집니다.

    6. 키 만들기를 클릭합니다.

    reCAPTCHA 키 페이지에 새로 생성된 키가 나열됩니다.

    모바일 애플리케이션용 사이트 키 만들기

    모바일 애플리케이션용 점수 기반 사이트 키만 만들 수 있습니다.

    1. 플랫폼 유형 선택 드롭다운 메뉴에서 Android 앱 또는iOS 앱을 선택하세요.
    2. 선택한 플랫폼에 따라 Android 패키지 또는 iOS 번들 ID를 입력합니다.

      Android 앱을 선택한 경우 다음 단계를 따르세요.

      1. Android 패키지 목록 섹션에서 Android 패키지 추가를 클릭합니다.
      2. Android 패키지 필드에 Android 패키지의 이름을 입력합니다.

      3. 선택사항: 패키지를 추가하려면 Android 패키지 추가를 클릭하고 Android 패키지 필드에 다른 Android 패키지의 이름을 입력합니다.

      iOS 앱을 선택한 경우 다음 단계를 따르세요.

      1. iOS 번들 ID 목록 섹션에서 iOS 번들 ID 추가를 클릭합니다.
      2. 번들 ID 필드에 iOS 번들 ID의 이름을 입력합니다.

      3. 선택사항: 번들 ID를 더 추가하려면 iOS 번들 ID 추가를 클릭하고 번들 ID 필드에 iOS 번들 ID의 이름을 입력합니다.

      모바일 애플리케이션의 경우 reCAPTCHA 사이트 키는 지정된 패키지 이름에 고유합니다(예: com.google.recaptcha.test).

    3. 키 만들기를 클릭합니다.

    reCAPTCHA 키 페이지에 새로 생성된 키가 나열됩니다.

REST 및 명령줄

키 유형 및 통합 유형에 대한 API 참조 정보는 통합 유형을 참조하세요.

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트 ID
  • DISPLAY_NAME: 키의 표시 이름입니다.
  • DOMAINS(웹사이트만 해당): 키를 사용할 수 있는 웹사이트의 도메인 또는 하위 도메인입니다. 여러 도메인을 쉼표로 구분된 목록으로 지정합니다.
  • TYPE_OF_INTEGRATION(웹사이트만 해당): SCORE 또는 CHECKBOX
  • PACKAGE_NAMES(Android 앱만 해당): 키를 사용할 수 있는 앱의 Android 패키지 이름입니다. 여러 패키지 이름을 쉼표로 구분된 목록으로 지정합니다.
  • BUNDLE_IDs(iOS 앱만 해당): 키를 사용할 수 있는 앱의 iOS 번들 ID입니다. 여러 번들 ID를 쉼표로 구분된 목록으로 지정합니다.

HTTP 메서드 및 URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

JSON 요청 본문:


To create keys for websites:

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
  }
}

To create keys for Android apps:

{
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
  "allowedPackageNames":"PACKAGE_NAMES"
  }
}

To create keys for iOS apps:

{
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
   "allowedBundleIds":"BUNDLE_IDs"

  }
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}

gcloud

다음 예시와 같이 gcloud alpha recaptcha keys create 명령어를 사용합니다.

  • 웹사이트 키를 만들려면 다음 명령어를 사용합니다.

    gcloud alpha recaptcha keys create \
      --web \
      --display-name=DISPLAY_NAME  \
      --integration-type=INTEGRATION_TYPE \
      --domains=DOMAINS
    

    다음 값을 제공합니다.

    • DISPLAY_NAME: 키의 이름입니다. 일반적으로 사이트 이름입니다.
    • INTEGRATION_TYPE: 통합 유형(SCORE 또는 CHECKBOX)
    • DOMAINS: 키를 사용할 수 있는 웹 사이트의 도메인 또는 하위 도메인 여러 도메인을 쉼표로 구분된 목록으로 지정합니다.

  • Android 앱용 키를 만들려면 다음 명령어를 사용합니다.

    gcloud alpha recaptcha keys create \
      --android --package-names=PACKAGE_NAMES \
      --display-name=DISPLAY_NAME
    

    다음 값을 제공합니다.

    • DISPLAY_NAME: 키의 이름입니다. 일반적으로 앱 이름입니다.
    • PACKAGE_NAMES: 키를 사용할 수 있는 앱의 Android 패키지 이름입니다. 여러 패키지 이름을 쉼표로 구분된 목록으로 지정합니다.
  • iOS 앱용 키를 만들려면 다음 명령어를 사용합니다.

    gcloud alpha recaptcha keys create \
      --ios --bundle-ids=BUNDLE_IDS \
      --display-name=DISPLAY_NAME
    

    다음 값을 제공합니다.

    • DISPLAY_NAME: 키의 이름입니다. 일반적으로 앱 이름입니다.
    • BUNDLE_IDS: 키를 사용할 수 있는 앱의 iOS 번들 ID입니다. 여러 번들 ID를 쉼표로 구분된 목록으로 지정합니다.

다음 예시에서는 gcloud alpha recaptcha keys create 명령어를 사용하여 키를 만드는 샘플 출력을 보여줍니다.

  Created [6Ld3howaAAAAAFYDMsLz2nWFXhsnmBjdrBra5_Bq].

다음 단계