Gerenciar entradas do mapa de certificados

Uma entrada de mapa de certificado associa um certificado a um nome de host de destino e a um mapa de certificado de destino. Nesta página, descrevemos como criar e gerenciar entradas de mapa de certificados.

Para mais informações, consulte Entradas do mapa de certificados.

Criar um item no mapa de certificados

É possível criar um item no mapa de certificados e associar até quatro certificados a ele. Recomendamos que você use um algoritmo de chave diferente para cada certificado ao especificar vários certificados para um nome de host. Por exemplo, é possível usar ECDSA para um certificado e RSA para outro. Associar vários certificados a um único item no mapa de certificados também ajuda ao migrar certificados autogerenciados para certificados gerenciados pelo Google.

Para mais informações sobre como um balanceador de carga seleciona certificados durante um handshake, consulte Lógica de seleção de certificados.

Console

  1. No console Google Cloud , acesse a página Certificate Manager e clique na guia Mapas de certificados.

    Acessar o Certificate Manager

  2. Para um novo mapa de certificado, clique em Criar mapa de certificado.

    Para um mapa de certificado atual, selecione o mapa necessário na lista.

  3. Na página Criar mapa de certificados ou Editar mapa de certificados, clique em Adicionar item no mapa. A janela Adicionar item no mapa é aberta.

  4. No campo Nome da entrada do mapa, insira um nome para o item no mapa de certificados, como my-cert-map-entry-01.

  5. No campo Descrição, insira uma descrição para a entrada do mapa de certificados, como My new cert map entry.

  6. Para definir o novo item no mapa de certificados como a entrada principal do seu mapa de certificados, selecione Entrada principal. Para mais informações, consulte Criar um item no mapa de certificados principal.

    Observação: só é possível associar um item no mapa de certificados principal a um mapa de certificado.

  7. No campo Nome do host, insira o nome de host que você quer associar à entrada do mapa de certificados, como www.example.com.

    Observação: para um item no mapa de certificados principal, o nome do host é especificado como <PRIMARY> por padrão, e não é possível mudar o nome do host.

  8. Para associar um certificado ao item no mapa de certificados, clique em Selecionar um certificado. Você pode selecionar um certificado existente ou clicar em Adicionar certificado para criar um certificado.

    Observação: é possível associar no máximo quatro certificados a um item no mapa de certificados.

  9. Para adicionar um rótulo e associá-lo à entrada do mapa de certificados, clique em Adicionar rótulo e insira uma chave e um valor para o rótulo.

  10. Clique em Adicionar. O item no mapa de certificados com os certificados associados é adicionado ao mapa de certificados.

gcloud

Para associar vários certificados a um item no mapa de certificados, forneça uma lista de nomes de certificados delimitada por vírgulas. Para cada subdomínio, crie uma entrada de mapa separada.

Para criar um item no mapa de certificados, use o comando gcloud certificate-manager maps entries create:

gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAMES" \
    --hostname="HOSTNAME"

Substitua:

  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_NAMES: uma lista separada por vírgulas dos nomes dos certificados que você quer associar à entrada do mapa de certificados
  • HOSTNAME: nome do host que você quer associar à entrada do mapa de certificados

API

Para associar vários certificados a um item no mapa de certificados, forneça uma lista de nomes de certificados delimitada por vírgulas. Para cada subdomínio, crie uma entrada de mapa separada.

Para criar um item no mapa de certificados, faça uma solicitação POST para o método certificateMaps.certificateMapEntries.create:

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?certificate_map_entry_id=CERTIFICATE_MAP_ENTRY_NAME
{
 hostname: "HOSTNAME"
 certificates: ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME1","projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME2"]
}

Substitua:

  • PROJECT_ID: ID do seu projeto Google Cloud
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • HOSTNAME: nome do host que você quer associar à entrada do mapa de certificados
  • CERTIFICATE_NAME1: nome do primeiro certificado que você quer associar ao item no mapa de certificados.
  • CERTIFICATE_NAME2: nome do segundo certificado que você quer associar ao item no mapa de certificados.

Terraform

Para criar um item no mapa de certificados, use um recurso google_certificate_manager_certificate_map_entry.

resource "google_certificate_manager_certificate_map_entry" "default" {
  name        = "${local.name}-first-entry-${random_id.tf_prefix.hex}"
  description = "example certificate map entry"
  map         = google_certificate_manager_certificate_map.default.name
  labels = {
    "terraform" : true
  }
  certificates = [google_certificate_manager_certificate.default.id]
  hostname     = local.domain
}

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

Criar uma entrada principal de mapa de certificado

É possível especificar uma entrada de mapa de certificado principal que um balanceador de carga pode veicular se o cliente não fornecer um nome de host ou se o balanceador de carga não conseguir corresponder o nome de host a uma entrada de mapa de certificado configurada.

Console

  1. No console Google Cloud , acesse a página Certificate Manager e clique na guia Mapas de certificados.

    Acessar o Certificate Manager

  2. Para um novo mapa de certificado, clique em Criar mapa de certificado.

    Para um mapa de certificado atual, selecione o mapa necessário na lista.

  3. Ao adicionar uma nova entrada de mapa de certificado, na página Criar mapa de certificado, clique em Adicionar entrada de mapa.

    Para editar um item no mapa de certificados existente, na página Editar mapa de certificados, na coluna Ações da linha do item no mapa, clique no ícone e selecione Editar.

  4. Para definir uma entrada de mapa de certificado como a principal, na janela Adicionar entrada de mapa, selecione Entrada principal.

    Observação: só é possível associar um item no mapa de certificados principal a um mapa de certificado.

  5. Clique em Salvar.

gcloud

Para criar uma entrada de mapa de certificado principal, use o comando gcloud certificate-manager maps entries create com a flag set-primary:

gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAMES" \
    --set-primary

Substitua:

  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_NAMES: uma lista separada por vírgulas dos nomes dos certificados que você quer associar à entrada do mapa de certificados

API

Para criar um item no mapa de certificados, faça uma solicitação POST para o método certificateMaps.certificateMapEntries.create:

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?certificate_map_entry_id=CERTIFICATE_MAP_ENTRY_NAME
{
   matcher: "PRIMARY",
   certificates: ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME1","projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME2"]
}

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • CERTIFICATE_NAME1: nome do primeiro certificado que você quer associar à entrada principal do mapa de certificados.
  • CERTIFICATE_NAME2: nome do segundo certificado que você quer associar à entrada principal do mapa de certificados.

Para mais informações sobre como o balanceador de carga seleciona certificados durante um handshake, consulte Lógica de seleção de certificados.

Atualizar um item no mapa de certificados

Ao atualizar uma entrada de mapa de certificados, é possível fazer o seguinte:

  • Atribuir ou cancelar a atribuição de certificados
  • Mudar a descrição
  • Mudar os rótulos

Se você usa o console Google Cloud para atualizar uma entrada do mapa de certificados, também é possível fazer o seguinte:

  • Mudar o nome de um item no mapa.
  • Se nenhum outro item no mapa estiver atribuído como principal, atribua o item no mapa como o principal do mapa de certificados.

Console

  1. No console Google Cloud , acesse a página Certificate Manager e clique na guia Mapas de certificados.

    Acessar o Certificate Manager

  2. Na lista de mapas de certificados, clique no mapa necessário. A página Detalhes do mapa de certificados é aberta.

  3. Clique em Editar. A página Editar mapa de certificados é aberta.

  4. Na coluna Ações do item no mapa, clique no ícone e selecione Editar. A janela Editar item no mapa é aberta.

  5. No campo Nome da entrada do mapa, mude o nome do item no mapa de certificados.

  6. No campo Descrição, mude a descrição do item no mapa de certificados.

  7. Para definir o item no mapa de certificados como a entrada principal do seu mapa de certificados, selecione Entrada principal. Para mais informações, consulte Criar um item no mapa de certificados principal.

    Observação: só é possível associar um item no mapa de certificados principal a um mapa de certificado.

  8. No campo Nome do host, mude o nome do host que você quer associar à entrada do mapa de certificados.

    Observação: para um item no mapa de certificados principal, o nome do host é especificado como <PRIMARY> por padrão, e não é possível mudar o nome do host.

  9. Para associar um certificado ao item no mapa de certificados, clique em Selecionar um certificado. Você pode selecionar um certificado existente ou clicar em Adicionar certificado para criar um certificado.

    Observação: é possível associar no máximo quatro certificados a um item no mapa de certificados.

    Para mover um certificado para cima ou para baixo na ordem, clique no ícone ou do certificado necessário.

    Para excluir um certificado, clique em Excluir item no certificado necessário.

  10. Para adicionar um rótulo e associá-lo à entrada do mapa de certificados, clique em Adicionar rótulo e insira uma chave e um valor para o rótulo.

    Para excluir um marcador, clique em Excluir item no marcador necessário.

  11. Clique em Salvar.

gcloud

Para atualizar um item no mapa de certificados, use o comando gcloud certificate-manager maps entries update:

gcloud certificate-manager maps entries update CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAME,CERTIFICATE_NAME" \
    --description="DESCRIPTION" \
    --update-labels="LABELS"

Substitua:

  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_NAME: o nome do certificado que você quer associar ao item no mapa de certificados.
  • DESCRIPTION: descrição do item no mapa de certificados.
  • LABELS: lista de rótulos aplicados à entrada do mapa de certificados

API

Para atualizar a entrada do mapa de certificados, faça uma solicitação PATCH ao método certificateMaps.certificateMapEntries.patch:

PATCH  /v1/projects/example-project/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME?updateMask=labels,description,certificates
{
  "certificates": ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME"],
  "description": "DESCRIPTION",
  "labels": { "LABEL_KEY": "LABEL_VALUE" }
}

Substitua:

  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • PROJECT_ID: ID do seu projeto Google Cloud
  • CERTIFICATE_NAME: o nome do certificado
  • DESCRIPTION: descrição do item no mapa de certificados.
  • LABEL_KEY: uma chave de rótulo aplicada à entrada do mapa de certificados.
  • LABEL_VALUE: um valor de rótulo aplicado à entrada do mapa de certificados

Listar entradas do mapa de certificados

É possível ver, filtrar e classificar a lista de todas as entradas de mapa de certificado associadas a um mapa de certificado.

Console

  1. No console do Google Cloud , acesse a página Certificate Manager e clique na guia Mapas de certificados.

    Acessar o Certificate Manager

  2. Na lista de mapas de certificados, clique no mapa necessário. A página Detalhes do mapa de certificado é aberta com informações detalhadas sobre o mapa de certificado selecionado e a lista de entradas de mapa associada.

gcloud

Para listar as entradas do mapa de certificados associadas a um mapa de certificados, use o comando gcloud certificate-manager maps entries list.

gcloud certificate-manager maps entries list --map=CERTIFICATE_MAP_NAME \
    --filter="FILTER" \
    --page-size="PAGE_SIZE" \
    --limit="LIMIT" \
    --sort-by="SORT_BY"

Substitua:

  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados

  • FILTER: uma expressão que restringe os resultados retornados a valores específicos.

    Por exemplo, você pode filtrar os resultados pelos seguintes critérios:

    • Estado da veiculação: --filter='state=ACTIVE'
    • Correspondência (definida como principal): --filter='-matcher=PRIMARY'
    • Nome do host: --filter='hostname=example.com'
    • Certificados atribuídos: --filter='certificates:my-cert'
    • Marcadores e horário de criação: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    Para mais exemplos de filtragem que podem ser usados com o Certificate Manager, consulte Como classificar e filtrar resultados da lista na documentação do Cloud Key Management Service.

  • PAGE_SIZE: número de resultados que você quer retornar por página

  • LIMIT: número máximo de resultados que você quer retornar

  • SORT_BY: uma lista separada por vírgulas de campos name pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para classificar em ordem decrescente, adicione um til (~) antes do campo.

API

Para listar as entradas de mapa de certificados associadas a um mapa de certificados, faça uma solicitação GET para o método certificateMaps.certificateMapEntries.list:

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY

Substitua:

  • PROJECT_ID: ID do seu projeto Google Cloud
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados de destino

  • FILTER: uma expressão que restringe os resultados retornados a valores específicos.

    Por exemplo, você pode filtrar os resultados pelos seguintes critérios:

    • Estado da veiculação: --filter='state=ACTIVE'
    • Correspondência (definida como principal): --filter='-matcher=PRIMARY'
    • Nome do host: --filter='hostname=example.com'
    • Certificados atribuídos: --filter='certificates:my-cert'
    • Marcadores e horário de criação: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    Para mais exemplos de filtragem que podem ser usados com o Certificate Manager, consulte Como classificar e filtrar resultados da lista na documentação do Cloud Key Management Service.

  • PAGE_SIZE: número de resultados que você quer retornar por página

  • SORT_BY: uma lista separada por vírgulas de campos name pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para classificar em ordem decrescente, adicione um til (~) antes do campo.

Ver o estado de uma entrada do mapa de certificado

É possível conferir os detalhes e o estado de uma entrada de mapa de certificado associada a um mapa de certificado.

Console

  1. No console do Google Cloud , acesse a página Certificate Manager e clique na guia Mapas de certificados.

    Acessar o Certificate Manager

  2. Na lista de mapas de certificados, clique no mapa necessário. A página Detalhes do mapa de certificado é aberta com informações detalhadas sobre o mapa de certificado selecionado e a lista de entradas de mapa associada.

  3. Na seção Itens no mapa, clique no nome do item no mapa que você quer visualizar. A página Detalhes do item no mapa é aberta com informações detalhadas sobre o item no mapa selecionado.

gcloud

Para conferir o estado de um item no mapa de certificados associado a um mapa de certificados, use o comando gcloud certificate-manager maps entries describe:

gcloud certificate-manager maps entries describe CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME"

Substitua:

  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados

O resultado será o seguinte:

certificates:
createTime: '2021-09-06T10:01:56.229472109Z'
hostname: example.com
name: projects/my-project/locations/global/certificateMaps/myCertMap/certificateMapEntries/myCertMapEntry
state: ACTIVE
updateTime: '2021-09-06T10:01:58.277031787Z'

API

Para conferir o estado de um item no mapa de certificados associado a um mapa de certificado, faça uma solicitação GET para o método certificateMaps.certificateMapEntries.get:

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME

Substitua:

  • PROJECT_ID: ID do seu projeto Google Cloud
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados

Excluir um item no mapa de certificados

Quando você exclui um item no mapa de certificados, os certificados associados a ele são desvinculados do proxy de destino.

Excluir um item do mapa de certificados não exclui os certificados associados de Google Cloud. É necessário excluir manualmente esses certificados.

Console

  1. No console Google Cloud , acesse a página Certificate Manager e clique na guia Mapas de certificados.

    Acessar o Certificate Manager

  2. Na lista de mapas de certificados, clique no mapa necessário. A página Detalhes do mapa de certificados é aberta.

  3. Clique em Editar. A página Editar mapa de certificados é aberta.

  4. Na coluna Ações do item no mapa, clique no ícone e selecione Excluir. Em seguida, clique em Excluir.

gcloud

Para excluir um item no mapa de certificados associado a um mapa de certificados, use o comando gcloud certificate-manager maps entries delete:

gcloud certificate-manager maps entries delete CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME"

Substitua:

  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados

API

Para excluir uma entrada de mapa de certificados associada a um mapa de certificados, faça uma solicitação DELETE ao método certificateMaps.certificateMapEntries.delete:

DELETE /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME

Substitua:

  • PROJECT_ID: ID do seu projeto Google Cloud
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados associado ao item no mapa de certificados
  • CERTIFICATE_MAP_ENTRY_NAME: nome da entrada do mapa de certificados

A seguir