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.
- Interrompa todos os componentes principais da Apigee:
Consulte Iniciar/interromper/verificar todos os componentes./opt/apigee/apigee-service/bin/apigee-all stop
- Parar
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
- Desinstale o
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
- Reinstale o
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
- Execute
apigee-mtls setup:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
- Restart
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Reinicie todos os componentes principais da Apigee:
Consulte Iniciar/interromper/verificar todos os componentes./opt/apigee/apigee-service/bin/apigee-all start
Como alternar certificados locais com uma autoridade de certificação (CA) personalizada
Para alternar certificados locais com uma CA personalizada, siga estas etapas:
- Siga as etapas em Usar um certificado personalizado para gerar os novos certificados que você vai usar.
- Interrompa todos os componentes principais da Apigee:
Consulte Iniciar/interromper/verificar todos os componentes./opt/apigee/apigee-service/bin/apigee-all stop
- Parar
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
- 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.pemrm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pemrm -f /opt/apigee/apigee-mtls/source/certs/local_key.pemrm -rf /opt/apigee/data/apigee-mtls - 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.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/certs/local_cert.pemcp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemcp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemcp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pem - Restart
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Reinicie todos os componentes principais da Apigee:
Consulte Iniciar/interromper/verificar todos os componentes./opt/apigee/apigee-service/bin/apigee-all start