Esta página foi traduzida pela API Cloud Translation.

Integrar com o Google Cloud Armor para aplicativos móveis

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

Para concluir a integração, você deve implementar um ou mais recursos do reCAPTCHA para WAF e configurar a segurança do Google Cloud Armor políticas. No entanto, só é possível implementar tokens de ação 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

Você precisa ter o reCAPTCHA em execução no seu aplicativo móvel para gerar tokens de ação. Depois que o reCAPTCHA gera um token de ação, você o anexa a um cabeçalho de solicitação sempre que você 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 para que o Google Cloud Armor pode avaliar os atributos de 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 WAF, faça 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 só é compatível com a 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: 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 só é compatível com a 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: 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 WAF. Especifique action-token.
- WAF_SERVICE: nome do Provedor de serviços 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 só é compatível com a 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ços 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 só é compatível com a integração com o Google Cloud Armor. Para essa integração, é possível criar somente 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: nome da chave. Geralmente, o nome de um app.
- PACKAGE_NAMES: nomes de pacotes Android de apps com permissão para use a chave. Para especificar vários nomes de pacotes, use um formato de lista separada por vírgulas.
- WAF_FEATURE: nome do recurso WAF. Especifique action-token.
- WAF_SERVICE: nome do Provedor de serviços 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 mais instruções, consulte o documento corresponde ao tipo de seu aplicativo móvel.
- No Android, consulte Integrar chaves de WAF com aplicativos Android.
- No iOS, consulte Integrar chaves WAF com 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 a seguir 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, você precisa configurar as políticas de segurança do Google Cloud Armor Tokens reCAPTCHA para gerenciamento de bots.

Para saber como configurar as políticas de segurança do Google Cloud Armor e usar o de token de ação com suas políticas de segurança, consulte Configure regras para o 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)