Esta página foi traduzida pela API Cloud Translation.

Integrar com o Google Cloud Armor para aplicativos móveis

Neste documento, mostramos como integrar os recursos do WAF do reCAPTCHA com o Google Cloud Armor em aplicativos para dispositivos móveis.

Para concluir a integração, implemente um ou mais recursos do reCAPTCHA para WAF e configure as políticas de segurança do Google Cloud Armor. No entanto, só é possível implementar tokens de ação do reCAPTCHA para integração com o Google Cloud Armor em aplicativos para dispositivos móveis.

Antes de começar

Ative a API reCAPTCHA Enterprise.

Enable the API
Identifique as ações que você quer proteger.

Implementar tokens de ação do reCAPTCHA

Para gerar tokens de ação, é preciso ter o reCAPTCHA em execução no seu aplicativo para dispositivos móveis. Depois que o reCAPTCHA gerar um token de ação, anexe-o a um cabeçalho de solicitação predefinido sempre que precisar proteger qualquer ação do usuário, como checkout. Por padrão, os tokens de ação são válidos por 30 minutos, mas podem variar dependendo do tráfego. É necessário anexar o token de ação a um cabeçalho de solicitação predefinido antes que o token expire. Assim, o Google Cloud Armor poderá avaliar os atributos do token.

Para implementar um token de ação reCAPTCHA, faça o seguinte:

Crie uma chave de token de ação para seu aplicativo para dispositivos móveis.
Console
1. No console do Google Cloud, acesse a página reCAPTCHA.
  
  Acessar o reCAPTCHA
2. Verifique se o nome do projeto aparece no seletor de recursos, na parte superior da página.
  
  Se você não vir o nome do projeto, clique no seletor de recursos para selecioná-lo.
3. Clique em Criar chave.
4. No campo Nome de exibição, insira um nome de exibição para a chave.
5. Dependendo do tipo de aplicativo para o qual você quer criar as chaves reCAPTCHA para o WAF, realize a ação adequada:
gcloud (iOS)

Para criar chaves reCAPTCHA, use o comando gcloud recaptcha keys create.

Observação:a criação de chaves reCAPTCHA para WAF em aplicativos para dispositivos móveis tem suporte apenas para integração com o Google Cloud Armor. Para essa integração, só é possível criar chaves de token de ação para aplicativos para dispositivos móveis.

Antes de usar os dados do comando abaixo, faça estas substituições:
- DISPLAY_NAME: o nome da chave. Geralmente, um nome de site.
- BUNDLE_IDs: os IDs do pacote de apps iOS autorizados a usar a chave. Para especificar vários IDs de pacote, use um formato de lista separada por vírgulas.
- WAF_FEATURE: nome do recurso do WAF. Especifique action-token.
- WAF_SERVICE: nome do provedor de serviço do WAF. Especifique CA para o Google Cloud Armor.
Execute o comando gcloud recaptcha keys create:
Linux, macOS ou Cloud Shell

gcloud recaptcha keys create \ --display-name=DISPLAY_NAME \ --ios --bundle-ids=BUNDLE_IDs \ --waf-feature=WAF_FEATURE \ --waf-service=WAF_SERVICE
Windows (PowerShell)

gcloud recaptcha keys create ` --display-name=DISPLAY_NAME ` --ios --bundle-ids=BUNDLE_IDs ` --waf-feature=WAF_FEATURE ` --waf-service=WAF_SERVICE
Windows (cmd.exe)

gcloud recaptcha keys create ^ --display-name=DISPLAY_NAME ^ --ios --bundle-ids=BUNDLE_IDs ^ --waf-feature=WAF_FEATURE ^ --waf-service=WAF_SERVICE
A resposta contém a chave reCAPTCHA recém-criada.
gcloud (Android)

Para criar chaves reCAPTCHA, use o comando gcloud recaptcha keys create.

Observação:a criação de chaves reCAPTCHA para WAF em aplicativos para dispositivos móveis tem suporte apenas para integração com o Google Cloud Armor. Para essa integração, só é possível criar chaves de token de ação para aplicativos para dispositivos móveis.

Antes de usar os dados do comando abaixo, faça estas substituições:
- DISPLAY_NAME: o nome da chave. Geralmente, um nome de site.
- PACKAGE_NAMES: nomes de pacotes de apps Android autorizados a usar a chave. Para especificar vários nomes de pacotes, use um formato de lista separada por vírgulas.
- WAF_FEATURE: nome do recurso do WAF. Especifique action-token.
- WAF_SERVICE: nome do provedor de serviço do WAF. Especifique CA para o Google Cloud Armor.
Execute o comando gcloud recaptcha keys create:
Linux, macOS ou Cloud Shell

gcloud recaptcha keys create \ --display-name=DISPLAY_NAME \ --android --package-names=PACKAGE_NAMES \ --waf-feature=WAF_FEATURE \ --waf-service=WAF_SERVICE
Windows (PowerShell)

gcloud recaptcha keys create ` --display-name=DISPLAY_NAME ` --android --package-names=PACKAGE_NAMES ` --waf-feature=WAF_FEATURE ` --waf-service=WAF_SERVICE
Windows (cmd.exe)

gcloud recaptcha keys create ^ --display-name=DISPLAY_NAME ^ --android --package-names=PACKAGE_NAMES ^ --waf-feature=WAF_FEATURE ^ --waf-service=WAF_SERVICE
A resposta contém a chave reCAPTCHA recém-criada.
REST (iOS)

Observação:a criação de chaves reCAPTCHA para WAF em aplicativos para dispositivos móveis tem suporte apenas para integração com o Google Cloud Armor. Para essa integração, só é possível criar chaves de token de ação para aplicativos para dispositivos móveis.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- DISPLAY_NAME: o nome da chave. Geralmente, o nome de um app.
- BUNDLE_IDs: os IDs do pacote de apps iOS autorizados a usar a chave. Para especificar vários IDs de pacote, use um formato de lista separada por vírgulas.
- WAF_FEATURE: nome do recurso do WAF. Especifique action-token.
- WAF_SERVICE: nome do provedor de serviço do WAF. Especifique CA para o Google Cloud Armor.
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys
Corpo JSON da solicitação:
{ "displayName": "DISPLAY_NAME", "iosSettings": { "allowedBundleIds": "BUNDLE_IDS" }, 'wafSettings': " { "wafService": "CA", "wafFeature": "ACTION_TOKEN" } }
Para enviar a solicitação, escolha uma destas opções:
curl

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/project-id/keys/6LfhtywnAAAAABY3sCS2duZ6A55kmDXz-PNEgKgT", "displayName": "DISPLAY_NAME", "iosSettings": { "allowAllBundleIds": false, "allowedBundleIds": [ BUNDLE_IDS ] }, "labels": {}, "wafSettings": { "wafService": "CA", "wafFeature": "ACTION_TOKEN" } }
REST (Android)

Observação:a criação de chaves reCAPTCHA para WAF em aplicativos para dispositivos móveis tem suporte apenas para integração com o Google Cloud Armor. Para essa integração, só é possível criar chaves de token de ação para aplicativos para dispositivos móveis.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- DISPLAY_NAME: o nome da chave. Geralmente, o nome de um app.
- PACKAGE_NAMES: nomes de pacotes de apps Android autorizados a usar a chave. Para especificar vários nomes de pacotes, use um formato de lista separada por vírgulas.
- WAF_FEATURE: nome do recurso do WAF. Especifique action-token.
- WAF_SERVICE: nome do provedor de serviço do WAF. Especifique CA para o Google Cloud Armor.
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys
Corpo JSON da solicitação:
{ "displayName": "DISPLAY_NAME", "androidSettings": { "allowedPackageNames":"PACKAGE_NAMES" }, 'wafSettings': " { "wafService": "CA", "wafFeature": "ACTION_TOKEN" } }
Para enviar a solicitação, escolha uma destas opções:
curl

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/project-id/keys/6LcioSknAAAAABrjlMuZv2fjIGYMqwaAFC9izhoy", "displayName": "DISPLAY_NAME", "androidSettings": { "allowAllPackageNames": false, "allowedPackageNames": [ PACKAGE_NAMES ], "supportNonGoogleAppStoreDistribution": false }, "labels": {}, "wafSettings": { "wafService": "CA", "wafFeature": "ACTION_TOKEN" } }
Integre o SDK reCAPTCHA para dispositivos móveis aos seus aplicativos para dispositivos móveis com a chave do token de ação que você criou. Para instruções, consulte o documento que corresponde ao tipo do seu aplicativo para dispositivos móveis.
- No Android, consulte Integrar chaves de WAF com aplicativos Android.
- No iOS, consulte Integrar chaves do WAF a aplicativos iOS.

Depois de receber o token do reCAPTCHA, anexe-o a um cabeçalho de solicitação predefinido no seguinte formato:

X-Recaptcha-Token: value-of-your-action-token

O exemplo de código abaixo mostra como anexar o token:

Android

Exemplo de código em Java

// This example shows how to send an HTTP request to the backend server
// attached with the reCAPTCHA token in the header.
//
// @param serverUrl: the URL of the backend server.
// @param rceToken: reCAPTCHA token that is attached to the header of the
// HTTP request.

public static void sendRequestToServerWithRceToken(
    String serverUrl, String rceToken) throws JSONException, IOException {
 URL url = new URL(String.format("http://%s/decryptcaptchacookie/accesswafserver", serverUrl));
 HttpURLConnection connection = (HttpURLConnection) url.openConnection();
 connection.setRequestProperty("X-Recaptcha-Token", rceToken);

 try {
    String requestBody = "['']";
    sendRequest(connection, requestBody, "AccessWithRceToken", "GET");
 } finally {
    connection.disconnect();
 }
}

private static void sendRequest(
    HttpURLConnection connection, String requestString, String requestName, String action)
    throws IOException {
 connection.setConnectTimeout(HTTP_CONNECT_TIMEOUT_MS);
 connection.setReadTimeout(HTTP_READ_TIMEOUT_MS);
 connection.setRequestProperty("Content-type", CONTENT_TYPE);
 connection.setRequestProperty(
    "Content-Length", Integer.toString(Utf8.encodedLength(requestString)));
 connection.setRequestMethod(action);
 connection.setDoOutput(true);
 connection.connect();
 try (OutputStream postStream = connection.getOutputStream()) {
    postStream.write(requestString.getBytes(UTF_8));
 }

 int responseCode = connection.getResponseCode();
 String response = connection.getResponseMessage();
 if (responseCode != HttpURLConnection.HTTP_OK) {
    throw new IOException(
       String.format(
          "Failed to complete request.\nResponse code:%s\nError Detail:\n%s",
          responseCode, response));
 }
}

iOS

Exemplo de código em Swift

// This example shows how to send an HTTP request to the backend server
// attached with the reCAPTCHA token in the header.
// @param serverUrl: the URL of the backend server.
// @param rceToken: reCAPTCHA token that is attached to the header of
// the HTTP request.

 public static func accessWafServer(rceToken: String, serverUrl: String)
    async throws -> String
 {
    let requestURL = try HttpHelper.createRequestURL(endpoint: serverUrl)
    var request = try HttpHelper.createRequest(requestURL: requestURL, action: "GET")
    request.setValue(rceToken, forHTTPHeaderField: "X-Recaptcha-Token")

    let data = try await HttpHelper.getDataFromServer(request)

    return String(decoding: data, as: UTF8.self)
 }

Configurar políticas de segurança do Google Cloud Armor

Depois de implementar os recursos do reCAPTCHA para WAF, configure as políticas de segurança do Google Cloud Armor que avaliam os tokens do reCAPTCHA para gerenciamento de bots.

Para saber como configurar políticas de segurança do Google Cloud Armor e usar as chaves de token de ação com elas, consulte Configurar regras para gerenciamento de bots.

A seguir

Configurar regras para o gerenciamento de bots.

Integrar com o Google Cloud Armor para aplicativos móveis

Antes de começar

Implementar tokens de ação do reCAPTCHA

Console

Criar chaves reCAPTCHA para o WAF para aplicativos iOS

Criar chaves reCAPTCHA para o WAF para aplicativos Android

gcloud (iOS)

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

gcloud (Android)

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST (iOS)

curl

PowerShell

REST (Android)

curl

PowerShell

Android

iOS

Configurar políticas de segurança do Google Cloud Armor

A seguir