Manutenção de mTLS da Apigee

Nesta página, descrevemos as tarefas de manutenção da mTLS da Apigee que precisam ser realizadas regularmente.

Como alternar certificados locais

Os certificados locais, que são instalados em cada host da Apigee, precisam ser substituídos por novos anualmente. Isso é chamado de rotação de certificado. Há duas maneiras de alternar certificados, dependendo se você está usando uma autoridade certificadora personalizada ou um certificado instalado pelo Consul.

Como alternar certificados locais sem uma autoridade certificadora (CA) personalizada

A maneira mais simples de alternar certificados sem uma CA personalizada é desinstalar e reinstalar o apigee-mtls. Isso remove todos os certificados antigos e gera novos certificados localmente. Para fazer isso com o mínimo de inatividade, execute os seguintes comandos em cada host, um por vez:

Observação:isso pressupõe que o mesmo arquivo silent.conf usado para a instalação inicial está presente.

  1. Interrompa todos os componentes principais da Apigee:
    /opt/apigee/apigee-service/bin/apigee-all stop
    Consulte Iniciar/interromper/verificar todos os componentes.
  2. Parar apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  3. Desinstale o apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
  4. Reinstale o apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
  5. Execute apigee-mtls setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
  6. Restart apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Reinicie todos os componentes principais da Apigee:
    /opt/apigee/apigee-service/bin/apigee-all start
    Consulte Iniciar/interromper/verificar todos os componentes.

Como alternar certificados locais com uma autoridade de certificação (CA) personalizada

Para alternar certificados locais com uma CA personalizada, siga estas etapas:

  1. Siga as etapas em Usar um certificado personalizado para gerar os novos certificados que você vai usar.
  2. Interrompa todos os componentes principais da Apigee:
    /opt/apigee/apigee-service/bin/apigee-all stop
    Consulte Iniciar/interromper/verificar todos os componentes.
  3. Parar apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  4. Remova os arquivos de certificado local antigos:
    rm -f /opt/apigee/apigee-mtls/certs/local_cert.pem
    rm -f /opt/apigee/apigee-mtls/certs/local_key.pem
    rm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    rm -f /opt/apigee/apigee-mtls/source/certs/local_key.pem
    rm -rf /opt/apigee/data/apigee-mtls
  5. Copie o novo par de chaves/certificado gerado na primeira etapa para os seguintes locais e atualize as permissões:
    cp ${new_cert} /opt/apigee/apigee-mtls/certs/local_cert.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/certs/local_cert.pem
    
    cp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    cp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    cp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
  6. Restart apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Reinicie todos os componentes principais da Apigee:
    /opt/apigee/apigee-service/bin/apigee-all start
    Consulte Iniciar/interromper/verificar todos os componentes.