Crie cabeçalhos personalizados em serviços de back-end

Os cabeçalhos de pedidos e respostas personalizados permitem-lhe especificar cabeçalhos adicionais que o balanceador de carga pode adicionar a pedidos e respostas HTTP(S). Consoante as informações detetadas pelo balanceador de carga, estes cabeçalhos podem incluir as seguintes informações:

• Latência para o cliente
• Localização geográfica do endereço IP do cliente
• Parâmetros da ligação TLS

Os cabeçalhos de pedidos personalizados são suportados para serviços de back-end, enquanto os cabeçalhos de respostas personalizados são suportados para serviços de back-end e contentores de back-end.

O balanceador de carga adiciona determinados cabeçalhos por predefinição a todos os pedidos e respostas HTTP(S) que encaminha entre back-ends e clientes. Para mais informações, consulte o artigo Segmente proxies.

Antes de começar

• Se necessário, atualize para a versão mais recente da CLI Google Cloud:

  gcloud components update
  

Como funcionam os cabeçalhos personalizados

Os cabeçalhos personalizados funcionam da seguinte forma:

• Quando o balanceador de carga encaminha um pedido para o back-end, o balanceador de carga adiciona cabeçalhos de pedidos.

  O equilibrador de carga adiciona cabeçalhos de pedidos personalizados apenas aos pedidos do cliente e não às sondagens de verificação do estado. Se o seu back-end exigir um cabeçalho específico para autorização que esteja em falta no pacote de verificação de funcionamento, a verificação de funcionamento pode falhar.

• O equilibrador de carga define os cabeçalhos de resposta antes de devolver as respostas ao cliente.

Para ativar os cabeçalhos personalizados, especifica uma lista de cabeçalhos numa propriedade do serviço de back-end ou do contentor de back-end.

Especifique cada cabeçalho como uma string header-name:header-value. O cabeçalho tem de conter dois pontos a separar o nome do cabeçalho e o valor do cabeçalho.

Os nomes dos cabeçalhos têm de cumprir os seguintes requisitos:

• O nome do cabeçalho tem de ser uma definição de nome de campo de cabeçalho HTTP válida (de acordo com o RFC 7230).
• O nome do cabeçalho não pode ser X-User-IP nem CDN-Loop.
• Os seguintes cabeçalhos hop-by-hop não podem ser usados: Keep-Alive, Transfer-Encoding, TE, Connection, Trailer e Upgrade. De acordo com a RFC 2616, estes cabeçalhos não são armazenados em cache nem propagados pelos proxies de destino.
• O nome do cabeçalho não pode começar com X-Google, X-Goog-, X-GFE ou X-Amz-.
• Um nome de cabeçalho não pode aparecer mais do que uma vez na lista de cabeçalhos adicionados.

Os valores dos cabeçalhos têm de cumprir os seguintes requisitos:

• O valor do cabeçalho tem de ser uma definição de campo de cabeçalho HTTP válida de acordo com a RFC 7230, com formulários obsoletos não permitidos).
• O valor do cabeçalho pode estar em branco.
• O valor do cabeçalho pode incluir uma ou mais variáveis, entre chavetas, que se expandem para valores fornecidos pelo equilibrador de carga. Uma lista de variáveis permitidas no valor do cabeçalho encontra-se na secção seguinte.

A ferramenta de linha de comandos gcloud tem uma marca para especificar os cabeçalhos de pedidos, que é --custom-request-header. Certifique-se de que inclui o nome do cabeçalho e o valor do cabeçalho entre aspas simples retas (') com esta flag.

O formato geral da flag é:

    --custom-request-header='HEADER_NAME:[HEADER_VALUE]'

Segue-se um exemplo de um valor de cabeçalho com duas variáveis, client_region e client_city, entre chavetas.

    --custom-request-header='X-Client-Geo-Location:{client_region},{client_city}'

Para clientes localizados em Mountain View, Califórnia, o balanceador de carga adiciona um cabeçalho da seguinte forma:

X-Client-Geo-Location:US,Mountain View

Variáveis suportadas com valores de cabeçalho

As seguintes variáveis podem aparecer em valores de cabeçalho personalizados.

O equilibrador de carga expande as variáveis para strings vazias quando não consegue determinar os respetivos valores. Por exemplo:

• Variáveis de localização geográfica quando a localização do endereço IP é desconhecida
• Parâmetros TLS quando o TLS não está em utilização
• O {origin_request_header} quando o pedido não inclui um cabeçalho Origin
• O cabeçalho {cdn_cache_status} quando incluído num cabeçalho de pedido

Os valores geográficos (regiões, subdivisões e cidades) são estimativas baseadas no endereço IP do cliente. Periodicamente, a Google atualiza os dados que fornecem estes valores para melhorar a precisão e refletir alterações geográficas e políticas. Mesmo que o cabeçalho X-Forwarded-For original contenha informações de localização válidas, a Google estima as localizações dos clientes através das informações do endereço IP de origem contidas nos pacotes recebidos pelo equilibrador de carga.

Os cabeçalhos adicionados pelo equilibrador de carga substituem os cabeçalhos existentes com o mesmo nome. Os nomes dos cabeçalhos não são sensíveis a maiúsculas e minúsculas. Quando os nomes dos cabeçalhos são transmitidos a um back-end HTTP/2, o protocolo HTTP/2 codifica os nomes dos cabeçalhos em letras minúsculas.

Nos valores dos cabeçalhos, os espaços em branco à esquerda e à direita são insignificantes e não são transmitidos ao back-end. Para permitir chavetas nos valores dos cabeçalhos, o equilibrador de carga interpreta duas chavetas de abertura ({{) como uma única chaveta de abertura ({) e duas chavetas de fecho (}}) como uma única chaveta de fecho (}).

Cabeçalhos personalizados do TLS mútuo

As seguintes variáveis de cabeçalho adicionais estão disponíveis se o TLS mútuo (mTLS) estiver configurado no TargetHttpsProxy do balanceador de carga.

Configure cabeçalhos de pedidos personalizados

gcloud compute backend-services create BACKEND_SERVICE_NAME \
    --global-health-checks \
    --global \
    --protocol HTTPS \
    --health-checks https-basic-check \
    --custom-request-header='HEADER_NAME:[HEADER_VALUE]'

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --global \
    --custom-request-header='HEADER_1_NAME:[HEADER_1_VALUE]' \
    --custom-request-header='HEADER_2_NAME:[HEADER_2_VALUE]'

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --global \
    --no-custom-request-headers

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME
"customRequestHeaders": [
   "client_city:Mountain View"
]

Configure cabeçalhos das respostas personalizados

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --custom-response-header='HEADER_NAME:[HEADER_VALUE]'

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --custom-response-header='HEADER_NAME:[HEADER_VALUE]'

gcloud compute backend-buckets update gaming-lab \
    --custom-response-header='X-Frame-Options: DENY'

gcloud compute backend-services update customer-bs-name \
    --global \
    --custom-response-header='Strict-Transport-Security: max-age=63072000'

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets

PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET_NAME

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices

PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME

"customResponseHeaders":HEADER_NAME:[HEADER_VALUE]

Defina cabeçalhos de resposta para o Cloud Storage

Se precisar de definir cabeçalhos HTTP em respostas do armazenamento na nuvem, como cabeçalhos de política de recursos de origem cruzada, X-Frame-Options ou X-XSS-Protection, oGoogle Cloud oferece a opção de usar cabeçalhos personalizados para a RFC do Google Cloud com o armazenamento na nuvem. Pode fazê-lo configurando cabeçalhos personalizados ao nível do contentor de back-end do equilibrador de carga, conforme descrito nesta página.

Os cabeçalhos de resposta personalizados configurados ao nível do depósito de back-end só são adicionados às respostas se o pedido do cliente for enviado para o endereço IP do equilibrador de carga. Os cabeçalhos personalizados não são adicionados às respostas se o pedido do cliente tiver sido feito diretamente à API Cloud Storage.

Use cabeçalhos personalizados com o Google Cloud Armor

Quando configura uma política de segurança do Cloud Armor, pode configurar o Cloud Armor para inserir um cabeçalho e um valor personalizados. Se a sua política de segurança do Cloud Armor estiver configurada para inserir o mesmo nome do cabeçalho personalizado que os cabeçalhos personalizados do Application Load Balancer externo global ou do Application Load Balancer clássico, o valor do cabeçalho especificado na sua política de segurança do Cloud Armor é substituído pelo valor preenchido pelo equilibrador de carga. Se não quiser que a política do Cloud Armor seja substituída, certifique-se de que não usa o mesmo nome.

Limitações

As seguintes limitações aplicam-se aos cabeçalhos personalizados usados com balanceadores de carga globais:

• O tamanho total de todos os cabeçalhos de pedidos personalizados (nome e valor combinados, antes da expansão de variáveis) para cada serviço de back-end não pode exceder 8 KB ou 16 cabeçalhos de pedidos.
• O tamanho total de todos os cabeçalhos de resposta personalizados (nome e valor combinados, antes da expansão de variáveis) para cada serviço de back-end não pode exceder 8 KB ou 16 cabeçalhos de resposta.

O que se segue?

• Para ver um exemplo de utilização, consulte o artigo Configurar um balanceador de carga com um back-end externo.