Guía de inicio rápido para migrar desde reCAPTCHA

En esta guía de inicio rápido, se muestra cómo migrar de reCAPTCHA (versión no empresarial) a reCAPTCHA Enterprise mediante una clave de sitio activa. El proceso de migración tarda de 5 a 10 minutos en completarse y no requiere cambios de código.

Si accedes a la Consola del administrador de reCAPTCHA, entonces usas la versión no empresarial de reCAPTCHA, que tiene poca funcionalidad y límites estrictos sobre el uso mensual. Para obtener más información sobre la comparación de características, consulta la comparación de características entre versiones de reCAPTCHA.

Luego de la migración, eres usuario de reCAPTCHA Enterprise y se te cobra cuando superas las 1,000,000 de solicitudes por mes. Para obtener más información, consulta los precios de reCAPTCHA Enterprise.

Para migrar, debes tener una clave de sitio activa. Si no tienes una clave de sitio activa, no podrás migrar con este método. Para configurar reCAPTCHA Enterprise, elige un método de configuración apropiado.

Antes de comenzar

  1. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyecto

  2. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

    reCAPTCHA Enterprise requiere que la facturación y se vincule en el proyecto para acceder a la API. Puedes habilitar la facturación mediante una tarjeta de crédito o un ID de facturación de un proyecto de Google Cloud existente. Si necesitas ayuda con la facturación, comunícate con la Asistencia para facturación de Cloud.

  3. Instala e inicializa el SDK de Cloud.

Habilita la API de reCAPTCHA Enterprise

Console

  1. En Cloud Console, ve a la página API de reCAPTCHA Enterprise.

    Ir a API de reCAPTCHA Enterprise

  2. Verifica que el nombre de tu proyecto aparezca en el selector de proyectos en la parte superior de la página.

    Si no ves el nombre de tu proyecto, haz clic en el selector de proyecto y, luego, selecciona tu proyecto.

  3. Haga clic en Habilitar.

gcloud

  1. Para configurar tu proyecto de Google Cloud en la sesión de gcloud, ejecuta el comando gcloud config set project. Reemplaza PROJECT_ID por tu ID del proyecto de Google Cloud.
           gcloud config set project PROJECT_ID
           
  2. Para habilitar la API de reCAPTCHA Enterprise, ejecuta el comando gcloud services enable:
             gcloud services enable recaptchaenterprise.googleapis.com
           
  3. Para verificar que la API de reCAPTCHA Enterprise esté habilitada, ejecuta el comando gcloud services list:
             gcloud services list --enabled
           

    Verifica que la API de reCAPTCHA Enterprise aparezca en la lista de API habilitadas.

Migra a reCAPTCHA Enterprise

La migración de una versión no empresarial de reCAPTCHA a reCAPTCHA Enterprise implica elegir una clave de sitio activa de la Consola del administrador de reCAPTCHA y migrar la clave del sitio. Puedes migrar una o más claves de sitio activas. Sin embargo, puedes migrar solo una clave de sitio a la vez.

Para ejecutar el proceso de migración, debes tener una cuenta de usuario de reCAPTCHA que cumpla con los siguientes requisitos:

  • En la Consola del administrador de reCAPTCHA, la cuenta de usuario aparece como propietario de la clave del sitio que deseas migrar.
  • La cuenta de usuario tiene la función de IAM Administrador de reCAPTCHA Enterprise (roles/recaptchaenterprise.admin) para el proyecto de Google Cloud para el que está habilitada la API de reCAPTCHA Enterprise. Si tu cuenta de usuario no tiene esta función, solicita a tu administrador que le otorgue la función o sigue las instrucciones sobre cómo otorgar, cambiar y revocar el acceso.

Para migrar una clave de sitio activa a reCAPTCHA Enterprise, haz lo siguiente:

  1. Para configurar la autenticación, ejecuta el siguiente comando de gcloud:

      gcloud auth login
    

    Accede con la cuenta de usuario de reCAPTCHA que posee la clave del sitio elegida y tiene la función Administrador de reCAPTCHA Enterprise.

  2. Elige y copia una clave de sitio activa que usaste para integrar reCAPTCHA a tus páginas web:

    1. Ve a la Consola del administrador de reCAPTCHA y haz clic en .
    2. Elige una clave del sitio. Las siguientes claves del sitio de reCAPTCHA son compatibles con la migración: reCAPTCHA v2, casilla de verificación v2, invisible v2 y reCAPTCHA v3.

    3. Para copiar la clave del sitio, haz clic en Copiar clave del sitio.

  3. Migra la clave del sitio con la herramienta de línea de comandos de gcloud o la API de reCAPTCHA Enterprise.

    gcloud

    Usa el comando de gcloud alpha recaptcha keys migrate como se muestra en el siguiente ejemplo:

     gcloud alpha recaptcha keys migrate SITE_KEY --project PROJECT-ID
    

    Ingresa los siguientes valores:

    • SITE_KEY: la clave del sitio activa que copiaste de la Consola del administrador de reCAPTCHA.
    • PROJECT-ID: El ID del proyecto de Google Cloud para el que está habilitada la API de reCAPTCHA Enterprise.

    LÍNEA DE REST Y CMD

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: El ID del proyecto de Google Cloud para el que está habilitada la API de reCAPTCHA Enterprise.
    • SITE_KEY: Es la clave del sitio activa que copiaste de la Consola del administrador de reCAPTCHA.

    Método HTTP y URL:

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

    Para enviar tu solicitud, elige una de estas opciones:

    curl

    Ejecuta el siguiente comando:

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

    PowerShell

    Ejecuta el siguiente comando:

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

    Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate" | Select-Object -Expand Content

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

    {
      "name": "projects/PROJECT-ID/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
      "displayName": "My site key",
      "webSettings": {
        "allowAllDomains": false,
        "allowedDomains": [
          recaptcha.net
        ],
        "allowAmpTraffic": false,
        "integrationType": "SCORE",
        "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
      }
    }
    

  4. Para verificar que se haya migrado la clave del sitio, siga estos pasos:

    gcloud

    Ejecuta el comando gcloud alpha recaptcha keys list y busca la clave del sitio migrado en la lista de claves.

    Console

    Ve a la página reCAPTCHA Enterprise y busca la clave del sitio migrada en la lista de claves.

    Ir a reCAPTCHA Enterprise

Después de migrar a reCAPTCHA Enterprise, puedes seguir usando el método siteverify para evaluar el token de respuesta de reCAPTCHA del usuario.

Limpia

Puedes revocar la función de IAM Administrador de reCAPTCHA Enterprise (roles/recaptchaenterprise.admin) desde tu cuenta de usuario de reCAPTCHA. Puedes pedirle a tu administrador que te otorgue acceso o siga las instrucciones para otorgar, cambiar y revocar el acceso.

¿Qué sigue?