Crear claves de reCAPTCHA para aplicaciones móviles

En esta página se explica cómo crear claves de reCAPTCHA (también conocidas como claves) para verificar las interacciones de los usuarios en tus aplicaciones móviles.

Las claves de reCAPTCHA representan cómo se configura reCAPTCHA para una aplicación móvil.

Antes de empezar

• Prepara tu entorno para reCAPTCHA.
• Asegúrate de que tienes el siguiente rol de gestión de identidades y accesos: administrador de reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).

Crear una clave de reCAPTCHA

Solo puedes crear claves basadas en puntuación para aplicaciones móviles.

Te recomendamos que sigas estas prácticas al crear claves de reCAPTCHA para aplicaciones móviles:

• Crea una clave de reCAPTCHA para cada aplicación móvil.

• En Android, crea claves independientes para los siguientes casos:

  • El paquete Android solo está disponible en Google Play Store.
  • El paquete Android solo está disponible en tiendas de aplicaciones que no sean Google Play Store.

• Crea claves de reCAPTCHA independientes para los entornos de staging y producción. De lo contrario, corres el riesgo de contaminar el análisis de riesgos de reCAPTCHA con datos de tu entorno de prueba.

La forma más sencilla de crear una clave de reCAPTCHA es a través de laGoogle Cloud consola. También puedes usar la API de reCAPTCHA Enterprise o la CLI de Google Cloud.

Consola

1. En la Google Cloud consola, ve a la página reCAPTCHA.

   Ir a reCAPTCHA

2. Comprueba que el nombre de tu proyecto aparece en el selector de recursos de la parte superior de la página.

   Si no ves el nombre de tu proyecto, haz clic en el selector de recursos y, a continuación, selecciona tu proyecto.

3. Haz clic en Crear clave.
4. En el campo Nombre visible, introduce el nombre visible de la clave.
5. En función del tipo de clave de reCAPTCHA que quieras crear para tu aplicación móvil, realiza la acción correspondiente:

Crear claves de reCAPTCHA para aplicaciones iOS

Te recomendamos que crees una clave de reCAPTCHA por cada aplicación iOS.

1. En Tipo de aplicación, selecciona iOS.
1. En la sección Lista de IDs de paquete de iOS, haga clic en Añadir ID de paquete de iOS.

2. En el campo ID de paquete, introduce el nombre de tu ID de paquete de iOS.

3. Opcional: Para añadir otro ID de paquete, haga clic en Añadir ID de paquete de iOS e introduzca el nombre del ID de paquete de iOS en el campo ID de paquete.
4. Para proteger la clave de reCAPTCHA de tus IDs de paquete, asegúrate de que el interruptor Inhabilitar verificación de ID de paquete esté desactivado.

5. Opcional: Proporciona la configuración de desarrollador de Apple.

   Le recomendamos que proporcione estos datos, ya que permiten que reCAPTCHA proporcione puntuaciones de riesgo más precisas para su tráfico.

   Introduce la siguiente información:

   • Clave privada (.p8): se genera en el centro para desarrolladores de Apple, en Certificates, Identifiers & Profiles (Certificados, identificadores y perfiles).
   • Identificador de clave: el identificador de clave de desarrollador de Apple (cadena de 10 caracteres).
   • ID de equipo: el ID de equipo de Apple (cadena de 10 caracteres) propietario del perfil de aprovisionamiento que se usa para compilar tu aplicación.
6. Opcional: Haz clic en Siguiente paso (opcional).

1. En tu entorno de no producción, si quieres especificar una puntuación que quieres que devuelva la clave cuando se creen evaluaciones, haz lo siguiente:

   1. En Configuración adicional, haz clic en el interruptor ¿Estás creando esta clave solo con fines de prueba?.
   2. Usa el control deslizante Definir puntuación para especificar una puntuación entre 0 y 1,0.
7. Haz clic en Crear clave.

La clave que has creado se muestra en la página Claves de reCAPTCHA.

Crear claves de reCAPTCHA para aplicaciones Android

1. En Tipo de aplicación, selecciona Android.
   
2. En la sección Lista de paquetes de Android, haga clic en Añadir paquete de Android.
3. En el campo Paquete de Android, introduzca el nombre de su paquete de Android.
4. Opcional: Para añadir otro paquete, haz clic en Añadir paquete de Android e introduce el nombre de otro paquete de Android en el campo Paquete de Android.
5. Para obligar a que la clave de reCAPTCHA solo se use en tu aplicación, desactiva el interruptor Inhabilitar verificación del nombre del paquete.
6. Si quieres crear una clave para una aplicación que esté disponible en otras tiendas de aplicaciones además de Google Play Store, activa Admite aplicaciones distribuidas fuera de Google Play Store.
7. Opcional: Haz clic en Siguiente paso (opcional).

1. En tu entorno de no producción, si quieres especificar una puntuación que quieres que devuelva la clave cuando se creen evaluaciones, haz lo siguiente:

   1. En Configuración adicional, haz clic en el interruptor ¿Estás creando esta clave solo con fines de prueba?.
   2. Usa el control deslizante Definir puntuación para especificar una puntuación entre 0 y 1,0.
8. Haz clic en Crear clave.

La clave que has creado se muestra en la página Claves de reCAPTCHA.

gcloud (iOS)

Para crear claves de reCAPTCHA, usa el comando gcloud recaptcha keys create.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• DISPLAY_NAME: nombre de la clave. Normalmente, el nombre de un sitio.
• BUNDLE_IDs: IDs de paquete de iOS de las aplicaciones que pueden usar la clave. Especifique varios IDs de paquete en una lista separada por comas.

Ejecuta el comando gcloud recaptcha keys create:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

gcloud recaptcha keys create `
--display-name=DISPLAY_NAME  `
--ios --bundle-ids=BUNDLE_IDs

Windows (cmd.exe)

gcloud recaptcha keys create ^
--display-name=DISPLAY_NAME  ^
--ios --bundle-ids=BUNDLE_IDs

La respuesta contiene la clave de reCAPTCHA recién creada.

gcloud (Android)

Para crear claves de reCAPTCHA, usa el comando gcloud recaptcha keys create.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• DISPLAY_NAME: nombre de la clave. Normalmente, el nombre de un sitio.
• PACKAGE_NAMES: nombres de paquetes Android de las aplicaciones que pueden usar la clave. Especifica varios nombres de paquetes en una lista separada por comas.

Ejecuta el comando gcloud recaptcha keys create:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

La respuesta contiene la clave de reCAPTCHA recién creada.

REST (iOS)

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• DISPLAY_NAME: nombre de la clave. Normalmente, el nombre de una aplicación.
• BUNDLE_IDs: IDs de paquete de iOS de las aplicaciones que pueden usar la clave. Especifique varios IDs de paquete en una lista separada por comas.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth 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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/keys/6LfhtywnAAAAABY3sCS2duZ6A55kmDXz-PNEgKgT",
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
    "allowAllBundleIds": false,
    "allowedBundleIds": [
        BUNDLE_IDS
    ]
  },
  "labels": {},
}

REST (Android)

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• DISPLAY_NAME: nombre de la clave. Normalmente, el nombre de una aplicación.
• PACKAGE_NAMES: nombres de paquetes Android de las aplicaciones que pueden usar la clave. Especifica varios nombres de paquetes en una lista separada por comas.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth 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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/project-id/keys/6LcioSknAAAAABrjlMuZv2fjIGYMqwaAFC9izhoy",
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
      "allowAllPackageNames": false,
      "allowedPackageNames": [
          PACKAGE_NAMES
      ],
      "supportNonGoogleAppStoreDistribution": false
  },
  "labels": {},
}

Nota: Después de crear claves de reCAPTCHA, puedes editarlas o eliminarlas. No puedes recuperar las llaves eliminadas. Además, no puedes migrar claves de reCAPTCHA de un proyecto Google Cloud a otro Google Cloud .

Siguientes pasos

• Instala llaves en iOS.
• Instalar llaves en Android.