Maintenance mTLS d'Apigee

Cette page décrit les tâches de maintenance mTLS Apigee qui doivent être effectuées régulièrement.

Effectuer une rotation des certificats locaux

Les certificats locaux, qui sont installés sur chaque hôte Apigee, doivent être remplacés par de nouveaux certificats chaque année. C'est ce qu'on appelle la rotation des certificats. Il existe deux façons d'effectuer la rotation des certificats, selon que vous utilisez une autorité de certification personnalisée ou un certificat installé par Consul.

Effectuer une rotation des certificats locaux sans autorité de certification (CA) personnalisée

Le moyen le plus simple d'effectuer une rotation des certificats sans autorité de certification personnalisée consiste à désinstaller et réinstaller apigee-mtls. Cette opération supprime tous les anciens certificats présents et en génère de nouveaux localement. Pour ce faire, vous pouvez exécuter les commandes suivantes sur chaque hôte, un par un, avec un temps d'arrêt minimal :

Remarque : Cela suppose que le même fichier silent.conf que celui utilisé pour l'installation initiale est présent.

  1. Arrêtez tous les composants Apigee principaux :
    /opt/apigee/apigee-service/bin/apigee-all stop
     : consultez Démarrer/arrêter/vérifier tous les composants.
  2. Arrêtez apigee-mtls :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  3. Désinstallez apigee-mtls :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
  4. Réinstallez apigee-mtls :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
  5. Exécutez apigee-mtls setup :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
  6. Redémarrez apigee-mtls :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Redémarrez tous les composants Apigee principaux :
    /opt/apigee/apigee-service/bin/apigee-all start
     : consultez Démarrer/arrêter/vérifier tous les composants.

Effectuer une rotation des certificats locaux avec une autorité de certification (CA) personnalisée

Pour effectuer la rotation des certificats locaux avec une CA personnalisée, procédez comme suit :

  1. Suivez la procédure décrite dans Utiliser un certificat personnalisé pour générer les nouveaux certificats que vous utiliserez.
  2. Arrêtez tous les composants Apigee principaux :
    /opt/apigee/apigee-service/bin/apigee-all stop
     : consultez Démarrer/arrêter/vérifier tous les composants.
  3. Arrêtez apigee-mtls :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  4. Supprimez les anciens fichiers de certificat locaux :
    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. Copiez la nouvelle paire certificat/clé générée à la première étape dans les emplacements suivants, puis mettez à jour les autorisations :
    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. Redémarrez apigee-mtls :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Redémarrez tous les composants Apigee principaux :
    /opt/apigee/apigee-service/bin/apigee-all start
     : consultez Démarrer/arrêter/vérifier tous les composants.