Receber as credenciais TLS: um exemplo

Você está visualizando a versão 1.2 da documentação da Apigee híbrida. This version is end of life. You should upgrade to a newer version. Para mais informações, consulte Versões compatíveis.

Version 1.2 (unsupported)

Versões com suporte:

• v1.13 (mais recente)                        
• v1.12                         
• v1.11
• Lista de versões com suporte

Versões sem suporte:

• v1.10                                      
• v1.9
• v1.8                                         
• v1.7
• v1.6
• v1.5
• v1.4
• v1.3
• v1.2
• v1.1

Este tópico é apenas um exemplo. Ele explica como conseguir um certificado TLS da autoridade de certificação (CA, na sigla em inglês) Let's Encrypt (em inglês). Essas etapas são fornecidas principalmente como um exemplo a ser seguido se você não tiver outra maneira pronta de obter um par de certificado/chave autorizado por uma CA. No exemplo, mostramos como gerar certificados usando a CA Let's Encrypt, o cliente Certbot e o Cloud DNS do Google Cloud Platform.

Onde usar essas credenciais

Você precisa fornecer credenciais TLS para dois gateways de entrada do Istio expostos fora do cluster:

Gateway	Requisito de TLS
Gateway de entrada do MART	Requer um par de chave/certificado TLS autorizado.
Gateway de entrada do ambiente de execução	É possível usar um par de certificado/chave autoassinado ou credenciais TLS autorizadas.

Consulte também Conexões externas.

Requisitos

Você precisará de um nome de domínio proveniente de um registrador de nomes de domínio. É possível registrar um nome de domínio por meio do Google Domains ou outro registro de domínios da sua escolha.

Configurar o Cloud DNS

Para conseguir credenciais TLS autorizadas, você precisa ter um nome de domínio qualificado. As etapas a seguir explicam como usar o Google Cloud DNS para conseguir um nome de domínio e gerenciar seus servidores de domínio.

1. Abra o Console do Google Cloud e faça login com a conta que você criou na Etapa 1: criar uma conta do Google Cloud.
2. Selecione o projeto criado na Etapa 2: criar um projeto do GCP.
3. Ative a API Cloud DNS. Consulte Como ativar APIs.
4. Crie dois endereços IP estáticos:
   • Se você estiver no GKE, siga as instruções em Como reservar um endereço IP externo estático para criar dois endereços IP estáticos. É possível atribuir os nomes a qualquer nome, como apigee-hybrid-mart e apigee-hybrid-runtime. Quando terminar, você terá dois números de IP para usar na configuração do cluster na próxima etapa. Por exemplo: 35.225.131.189 e 34.66.75.196.
   • Se você estiver no Anthos GKE, siga as instruções na documentação do Anthos GKE para criar dois endereços IP estáticos.
5. Crie uma zona pública gerenciada. Para mais instruções, consulte Criar uma zona pública gerenciada.
6. Consiga o IP externo reservado para o apigee-hybrid-mart.
7. Cria um conjunto de registros para o endpoint MART. Insira o IP externo que você recebeu na etapa anterior e adicione um prefixo ao nome do domínio, como mart. Para mais instruções, consulte Criar um novo registro.

   

8. Receba o IP externo reservado para apigee-hybrid-runtime.
9. Crie um conjunto de registros para o endpoint de entrada do Istio. Esse é o endereço para fazer chamadas de API para o gateway híbrido. Insira o IP externo que você recebeu na etapa anterior e adicione um prefixo ao nome do domínio, como apitest. Para mais instruções, consulte Criar um novo registro.

   

10. Copie os dados do registro DNS, conforme mostrado no exemplo a seguir:

    

11. Volte para a página do seu domínio no Google Domains.
12. Selecione seu domínio.
13. Selecione DNS.
14. Na seção "Servidores de nomes", clique em Editar.

15. Insira os servidores de nomes de domínio que você copiou da página Serviços de rede do Cloud DNS.

    

Agora o Google Cloud DNS gerenciará os registros DNS do seu domínio.

Instalar o Certbot em uma VM

Agora que o Cloud DNS está configurado para gerenciar os servidores de domínio, instale o cliente Certbot com o plug-in dns_google em uma VM do Cloud. O cliente permite que você receba certificados autorizados para seu domínio a partir de um endpoint Let's Encrypt.

1. Abra o Console do Google Cloud e faça login com a conta que você criou na Etapa 1: criar uma conta do Google Cloud.
2. Selecione o projeto criado na Etapa 2: criar um projeto do GCP.
3. Selecione IAM e administrador > Contas de serviço.

   A visualização "Contas de serviço" exibe uma lista das contas de serviço do projeto.

4. Para criar uma nova conta de serviço, clique em +Criar conta de serviço na parte superior da visualização.

   A visualização Detalhes da conta de serviço é exibida.

5. No campo Nome da conta de serviço, insira o nome da conta de serviço.

   

   Se quiser, adicione uma descrição no campo Descrição da conta de serviço. As descrições são úteis para lembrar você sobre como uma conta de serviço específica é usada.

6. Clique em Criar

   O GCP cria uma nova conta de serviço e exibe a visualização Permissões da conta de serviço. Use essa visualização para atribuir um papel à sua nova conta de serviço.

7. Clique na lista suspensa Selecionar um papel.
8. Selecione o papel Proprietário do projeto.
9. Clique em Continuar.
10. Clique em Concluído.
11. No console do GCP, selecione Compute Engine > Instâncias de VM.
12. Crie uma instância de VM chamada certmanager.
13. Na seção "Disco de inicialização", escolha CentOS7 e 20 GB para a unidade permanente SSD.
14. Defina a conta de serviço como a que você criou acima.
15. Instale o Certbot e o plug-in dns_google na máquina e execute o cliente do Certbot:

      sudo su -
      yum -y install yum-utils
      yum install certbot -y
      yum install certbot-dns-google -y
      certbot certonly --dns-google -d *.your_domain_name,*.your_domain_name --server https://acme-v02.api.letsencrypt.org/directory
      

    Exemplo:

    sudo su -
    yum -y install yum-utils
    yum install certbot -y
    yum install certbot-dns-google -y
    certbot certonly --dns-google -d *.apigee-hybrid-docs.net,*.apigee-hybrid-docs.net --server https://acme-v02.api.letsencrypt.org/directory

16. Agora é possível encontrar o certificado autorizado e os arquivos de chave privada nesse diretório: cd /etc/letsencrypt/live/your_domain_name/

    Exemplo:

    cd /etc/letsencrypt/live/apigee-hybrid-docs.net
    ls
      cert.pem  chain.pem  fullchain.pem  privkey.pem  README

17. Copie os arquivos fullchain.pem e privkey.pem para sua máquina local.
18. Atualize seu arquivo de modificação para apontar para o certificado e a chave privada. Para o hostAliases, use o nome do DNS que você criou anteriormente.

    Exemplo:

    ...
    envs:
      - name: test
        serviceAccountPaths:
          synchronizer: "your_keypath/synchronizer-manager-service-account.json
          udca: "your_keypath/analytic-agent-service-account.json
    
    virtualhosts:
      - name: default
        hostAliases: ["apitest.apigee-hybrid-docs.net"]
        sslCertPath: "$HOME/hybrid/apigee-hybrid-setup/tls/fullchain.pem"
        sslKeyPath: "$HOME/hybrid/apigee-hybrid-setup/tls/privkey.pem"
        routingRules:
          - env: test
    
    mart:
      nodeSelector:
        key: cloud.google.com/gke-nodepool
        value: apigee-runtime
      sslCertPath: "$HOME/hybrid/apigee-hybrid-setup/tls/fullchain.pem"
      sslKeyPath: "$HOME/hybrid/apigee-hybrid-setup/tls/privkey.pem"
      replicaCountMin: 1
      replicaCountMax: 1
      hostAlias: "mart.apigee-hybrid-docs.net"

19. Aplique as alterações:

    Se você alterou a configuração mart, aplique as alterações:

    apigeectl apply -f your_overrides_file -c mart

    Se você alterou a configuração envs, aplique as alterações:

    apigeectl apply -f your_overrides_file -c runtime

Testar a configuração

Implante e teste um proxy, conforme explicado em Criar e implantar um novo proxy de API.