NAME
    gcloud recaptcha keys create - create a Key

SYNOPSIS
    gcloud recaptcha keys create --display-name=DISPLAY_NAME
        (--android (--allow-all-package-names
          | --package-names=[PACKAGE_NAMES,...])
          | --ios (--allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...])
          | [--web (--allow-all-domains | --domains=[DOMAINS,...])
          : --allow-amp-traffic --integration-type=INTEGRATION_TYPE
          --security-preference=SECURITY_PREFERENCE
          --testing-challenge=TESTING_CHALLENGE]) [--labels=[KEY=VALUE,...]]
        [--testing-score=TESTING_SCORE]
        [--waf-feature=WAF_FEATURE --waf-service=WAF_SERVICE]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Create a reCAPTCHA Key.

EXAMPLES
    To create a new reCAPTCHA key for websites showing no CAPTCHA challenge,
    run:

        $ gcloud recaptcha keys create --display-name=test-key-name --web \
            --allow-all-domains --integration-type=score

REQUIRED FLAGS
     --display-name=DISPLAY_NAME
        A human-readable name for the key. Typically a site or app name.

     Exactly one of these must be specified:

       Options for the creation of a site key for Android.

         --android
            Creates a Key configured for Android devices.

            This flag argument must be specified if any of the other arguments
            in this group are specified.

         Exactly one of these must be specified:

           --allow-all-package-names
              If set, package name enforcement will NOT be enabled on this key.

           --package-names=[PACKAGE_NAMES,...]
              Android package names of apps allowed to use the key.

              Example of a valid package name: 'com.companyname.appname'

       Options for the creation of a site key for iOS.

         --ios
            Creates a Key configured for iOS devices.

            This flag argument must be specified if any of the other arguments
            in this group are specified.

         Exactly one of these must be specified:

           --allow-all-bundle-ids
              If set, bundle id enforcement will NOT be enabled on this key.

           --bundle-ids=[BUNDLE_IDS,...]
              iOS bundle ids of apps allowed to use the key.

              Example of a valid bundle id:
              'com.companyname.productname.appname'

       Options for the creation of a site key for web.

         --web
            Creates a Key configured for websites.

            This flag argument must be specified if any of the other arguments
            in this group are specified.

         --allow-amp-traffic
            Whether this key can be used on AMP (Accelerated Mobile Pages)
            websites.

         --integration-type=INTEGRATION_TYPE
            Configures how reCAPTCHA will operate on your site. This only
            applies to 'web' platform. INTEGRATION_TYPE must be one of:

             checkbox
                Renders the classic "I'm not a robot" checkbox, and a captcha
                challenge for low scoring events

             invisible
                Does not display the "I'm not a robot" checkbox, but may show
                CAPTCHA challenges after risk analysis

             score
                Shows no CAPTCHA challenge on the page

         --security-preference=SECURITY_PREFERENCE
            Represents the possible challenge frequency and difficulty
            configurations for a web key. usability: show fewer and easier
            challenges. balance: show balanced (in amount and difficulty)
            challenges. security: show more and harder challenges.

            SECURITY_PREFERENCE must be one of: balance,
            challenge-security-preference-unspecified, security, usability.

         --testing-challenge=TESTING_CHALLENGE
            For CHECKBOX and INVISIBLE Keys only, this option configures
            whether challenges will be issued for execute requests.
            TESTING_CHALLENGE must be one of:

             challenge
                Execute requests for this key will always return an unsolvable
                challenge consisting of a message about this testing key.

             nocaptcha
                Execute requests for this key will always return nocaptcha.

         Exactly one of these must be specified:

           --allow-all-domains
              If set, domain name enforcement will NOT be enabled on this key.

           --domains=[DOMAINS,...]
              Domains or subdomains of websites allowed to use the key. All
              subdomains of an allowed domain are automatically allowed. A
              valid domain requires a host and must not include any path, port,
              query or fragment.

              Examples of valid domains: 'example.com' 'subdomain.example.com'

OPTIONAL FLAGS
     --labels=[KEY=VALUE,...]
        List of label KEY=VALUE pairs to add.

        Keys must start with a lowercase character and contain only hyphens
        (-), underscores (_), lowercase characters, and numbers. Values must
        contain only hyphens (-), underscores (_), lowercase characters, and
        numbers.

     --testing-score=TESTING_SCORE
        If set, all assessments for this key will return this score. Must be
        between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.

     Options for the creation of a WAF-enabled key. For more information,
     please refer to
     https://cloud.google.com/recaptcha-enterprise/docs/integration-overview.

       --waf-feature=WAF_FEATURE
          The WAF feature to use. For more information, see
          https://cloud.google.com/recaptcha-enterprise/docs/usecase#comparison_of_features.
          WAF_FEATURE must be one of:

           action-token
              Use reCAPTCHA action-tokens to protect user actions.

           challenge-page
              Redirects suspicious traffic to reCAPTCHA challenge page.

           session-token
              Use reCAPTCHA session-tokens to protect the whole user session on
              the site's domain.

          This flag argument must be specified if any of the other arguments in
          this group are specified.

       --waf-service=WAF_SERVICE
          The WAF service provider to use. WAF_SERVICE must be one of:

           ca
              Cloud Armor

           fastly
              Fastly

          This flag argument must be specified if any of the other arguments in
          this group are specified.

GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
    --help, --impersonate-service-account, --log-http, --project, --quiet,
    --trace-token, --user-output-enabled, --verbosity.

    Run $ gcloud help for details.

API REFERENCE
    This command uses the recaptchaenterprise/v1 API. The full documentation
    for this API can be found at:
    https://cloud.google.com/recaptcha-enterprise/

NOTES
    This variant is also available:

        $ gcloud alpha recaptcha keys create

