Gerenciar mapas de certificados

Um mapa de certificados faz referência a um ou mais itens no mapa de certificados que atribuem certificados específicos a nomes de host específicos. Nesta página, descrevemos como criar e gerenciar mapas de certificados.

Para mais informações, consulte Mapas de certificados.

Criar um mapa de certificados

É possível criar um mapa de certificados para se referir ao item no mapa de certificados associado ao seu certificado.

Console

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

    Acessar o Gerenciador de Certificados

  2. Clique em Criar mapa de certificados.

  3. No campo Nome, insira um nome para o mapa de certificados, como cert-map-8.

  4. No campo Descrição, insira uma descrição para o mapa de certificados, como My new certificate map.

  5. Para criar um item no mapa de certificados e adicioná-lo ao mapa, clique em Adicionar item no mapa e siga as etapas mencionadas na seção a seguir.

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

  7. Clique em Criar.

gcloud

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

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

Substitua:

  • CERTIFICATE_MAP_NAME: nome do mapa de certificados

API

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

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps?certificate_map_id=CERTIFICATE_MAP_NAME

Substitua:

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

Terraform

Para criar um mapa de certificados, use um recurso google_certificate_manager_certificate_map:

resource "google_certificate_manager_certificate_map" "default" {
  name        = "${local.name}-certmap1-${random_id.tf_prefix.hex}"
  description = "${local.domain} certificate map"
  labels = {
    "terraform" : true
  }
}

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

Anexar um mapa de certificados a um proxy

Depois de criar e configurar um mapa de certificados com entradas de mapa de certificados, anexe o mapa de certificados ao proxy de destino. O Certificate Manager é compatível com proxies HTTPS e SSL de destino com escopo global. Para mais informações sobre as diferenças entre esses tipos de proxy, consulte Usar proxies de destino.

Se você anexar um certificado TLS (SSL) ao proxy de destino e também anexar certificados por um mapa de certificados, o proxy usará os certificados referenciados no mapa de certificados e ignorará o certificado anexado diretamente.

Console

Se o proxy de destino fizer parte de um balanceador de carga, será possível anexar o mapa de certificados editando a configuração de front-end do balanceador de carga.

  1. No console do Google Cloud , acesse a página Balanceamento de carga.

    Acessar o "Balanceamento de carga"

  2. Clique no nome do balanceador de carga que você quer atualizar e, em seguida, clique em Editar.

  3. Clique em Configuração de front-end e selecione o endereço IP de front-end e a configuração de porta que você quer editar.

  4. Se a opção Escolher repositório de certificados aparecer, selecione Usar mapa de certificados.

  5. Na lista Selecionar um mapa de certificados, escolha o mapa de certificados.

  6. Clique em Concluído e, depois, em Atualizar.

gcloud

Para anexar o mapa de certificados ao proxy HTTPS de destino, use o comando gcloud compute target-https-proxies update:

gcloud compute target-https-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

Para anexar o mapa de certificados ao proxy SSL de destino, use o comando gcloud compute target-ssl-proxies update:

gcloud compute target-ssl-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

Substitua:

  • PROXY_NAME: nome do proxy de destino.
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados que contém as entradas de mapa que fazem referência aos certificados de destino.

API

Para anexar o mapa de certificados ao proxy HTTPS de destino, faça uma solicitação POST ao método targetHttpsProxies:

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

Para anexar o mapa de certificados ao proxy SSL de destino, faça uma solicitação POST ao método targetSslProxies:

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud
  • PROXY_NAME: nome do proxy de destino.
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados que contém as entradas de mapa que fazem referência aos certificados de destino.

Desvincular um mapa de certificados de um proxy

Antes de remover um mapa de certificados de um proxy, observe o seguinte:

  • Se houver certificados TLS (SSL) anexados diretamente ao proxy, a remoção do mapa de certificados fará com que o proxy volte a usá-los.

  • Se nenhum certificado TLS (SSL) estiver anexado diretamente ao proxy, não será possível remover um mapa de certificados. Anexe pelo menos um certificado TLS diretamente ao proxy antes de remover o mapa de certificados.

gcloud

Para remover qualquer mapa de certificados anexado do proxy HTTPS de destino, use o comando gcloud compute target-https-proxies update:

gcloud compute target-https-proxies update PROXY_NAME \
    --clear-certificate-map

Para remover qualquer mapa de certificados anexado do proxy SSL de destino, use o comando gcloud compute target-ssl-proxies update:

gcloud compute target-ssl-proxies update PROXY_NAME \
    --clear-certificate-map

Substitua:

  • PROXY_NAME: nome do proxy de destino.

API

Para remover qualquer mapa de certificados anexado do proxy HTTPS de destino, faça uma solicitação POST ao método targetHttpsProxies:

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

Para remover qualquer mapa de certificados anexado do proxy SSL de destino, faça uma solicitação POST ao método targetSslProxies:

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud
  • PROXY_NAME: nome do proxy de destino.

Atualizar um mapa de certificados

É possível atualizar a descrição e os rótulos de um mapa de certificados. Se você usar o console doGoogle Cloud , poderá adicionar uma nova entrada de mapa a um mapa de certificados ou editar ou excluir uma entrada de mapa associada a um mapa de certificados.

Console

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

    Acessar o Gerenciador de Certificados

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

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

  4. No campo Descrição, insira uma nova descrição para o mapa de certificados.

  5. Para adicionar um novo item ao mapa de certificados, clique em Adicionar item no mapa e siga as etapas mencionadas na seção Criar um item no mapa de certificados.

    Para editar um item no mapa, na coluna Ações da linha do item no mapa, clique no ícone , selecione Editar e siga as etapas mencionadas na seção Atualizar um item no mapa de certificados.

    Para excluir um item no mapa, na coluna Ações da linha do item, clique no ícone , selecione Excluir e siga as etapas mencionadas na seção Excluir um item no mapa de certificados.

  6. É possível adicionar, excluir ou atualizar os rótulos associados ao mapa de certificados.

    Para adicionar um rótulo, clique em Adicionar rótulo e especifique uma chave e um valor para o rótulo.

    Para excluir um rótulo, clique em Excluir item no rótulo necessário.

  7. Clique em Salvar.

gcloud

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

gcloud certificate-manager maps update CERTIFICATE_MAP_NAME \
    --description="DESCRIPTION"
    --update-labels="LABELS"

Substitua:

  • CERTIFICATE_MAP_NAME: nome do mapa de certificados
  • DESCRIPTION: a nova descrição para este mapa de certificados
  • LABELS: uma lista separada por vírgulas de rótulos aplicados a este mapa de certificados

API

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

PATCH /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME?updateMask=labels,description
{
  "description": "DESCRIPTION",
  "labels": {
    "LABEL_KEY": "LABEL_VALUE",
  }
}

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud
  • CERTIFICATE_MAP_NAME: nome do mapa de certificados
  • DESCRIPTION: a nova descrição para este mapa de certificados
  • LABEL_KEY: uma chave de rótulo aplicada a esse mapa de certificados
  • LABEL_VALUE: um rótulo aplicado a esse mapa de certificados

Listar mapas de certificados

É possível visualizar, filtrar e classificar a lista de todos os mapas de certificados que você criou.

Console

  1. No console do Google Cloud , acesse a página Gerenciador de certificados.

    Acessar o Gerenciador de Certificados

  2. Clique na guia Mapas de certificados. É possível visualizar, filtrar e configurar as colunas de exibição de todos os mapas de certificados no projeto selecionado.

gcloud

Para listar mapas de certificados, use o comando gcloud certificate-manager maps list:

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

Substitua:

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

    Por exemplo, para filtrar os resultados por rótulos e horário de criação, especifique: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'.

    Para mais exemplos de filtragem que podem ser usados com o Gerenciador de certificados, consulte Como classificar e filtrar resultados de listas 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 que classifica os resultados retornados. A ordem de classificação padrão é crescente. Para a ordem decrescente, use o prefixo til (~) no campo.

API

Para listar os mapas de certificados configurados, faça uma solicitação LIST ao método certificateMaps.list:

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

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud

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

    Por exemplo, para filtrar os resultados pelos rótulos e pelo horário de criação, especifique: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    Para mais exemplos de filtragem que podem ser usados com o Gerenciador de certificados, consulte Como classificar e filtrar resultados de listas 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 que classifica os resultados retornados. A ordem de classificação padrão é crescente. Para a ordem decrescente, use o prefixo til (~) no campo.

Ver os detalhes de um mapa de certificados

É possível ver os detalhes de um mapa de certificados, como data e hora de criação, data e hora da última atualização e descrição.

Console

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

    Acessar o Gerenciador de Certificados

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

gcloud

Para ver os detalhes de um mapa de certificados, use o comando gcloud certificate-manager maps describe:

gcloud certificate-manager maps describe CERTIFICATE_MAP_NAME

Substitua:

  • CERTIFICATE_MAP_NAME: nome do mapa de certificados

API

Para conferir os detalhes do mapa de certificados, faça uma solicitação GET ao método certificateMaps.get:

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

Substitua:

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

Excluir um mapa de certificados

Antes de excluir um mapa de certificados, faça o seguinte:

Console

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

    Acessar o Gerenciador de Certificados

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

  3. Clique em Excluir e em Excluir.

gcloud

Para excluir um mapa de certificados, use o comando gcloud certificate-manager maps delete:

gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME

Substitua:

  • CERTIFICATE_MAP_NAME: nome do mapa de certificados

API

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

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

Substitua:

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

A seguir