Gérer des certificats SSL/TLS

Cette page explique comment gérer les certificats d'autorité de certification (CA) de votre serveur.

Utiliser des connexions chiffrées

En savoir plus sur la façon dont SQL Server utilise des connexions chiffrées.

Gérer les certificats CA de serveur (CA par instance)

Cette section explique comment gérer les certificats CA de serveur créés en interne par Cloud SQL. Il s'agit du mode d'autorité de certification du serveur par défaut dans Cloud SQL. Dans cette hiérarchie d'autorités de certification, Cloud SQL crée une autorité de certification de serveur pour chaque instance.

Effectuer une rotation des certificats CA de serveur

Si vous avez reçu une notification d'expiration de vos certificats ou si vous souhaitez lancer une rotation, suivez les étapes ci-dessous pour effectuer la rotation. Avant de commencer la rotation, vous devez disposer d'une nouvelle autorité de certification de serveur sur l'instance. Si une autorité de certification de serveur a déjà été créée, vous pouvez ignorer la première étape de la procédure suivante.

  1. Créez une autorité de certification de serveur.
  2. Téléchargez les informations du nouveau certificat CA du serveur :
  3. Mettez à jour vos clients afin qu'ils utilisent les informations du nouveau certificat CA de serveur.
  4. Effectuez la rotation, qui place le certificat actuel dans l'emplacement "précédent" et active le certificat qui vient d'être ajouté.

Console

Téléchargez le nouveau certificat CA de serveur, encodé sous forme de fichier PEM, dans votre environnement local :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Cliquez sur l'onglet Sécurité.
  5. Cliquez pour développer Gérer les certificats.
  6. Sélectionnez Effectuer une rotation de certificat CA.

    Si aucun certificat n'est éligible, l'option de rotation n'est pas disponible. Vous devez créer un certificat CA de serveur.

  7. Cliquez sur Télécharger les certificats.

Mettez à jour l'ensemble de vos clients SQL Server pour qu'ils utilisent les nouvelles informations. Pour cela, copiez le fichier téléchargé vers vos machines hôtes clientes afin de remplacer le fichier server-ca.pem existant.

Après avoir mis à jour les clients, procédez à la rotation :

  1. Revenez à l'onglet Sécurité.
  2. Cliquez pour développer Gérer les certificats.
  3. Sélectionnez Effectuer une rotation de certificat CA.
  4. Assurez-vous que les clients se connectent correctement.
  5. Si certains clients ne parviennent pas à se connecter à l'aide du nouveau certificat, vous pouvez sélectionner Rollback du certificat CA pour effectuer un rollback vers la configuration précédente.

gcloud

  1. Créez un certificat CA de serveur :
    gcloud sql ssl server-ca-certs create \
    --instance=INSTANCE
  2. Téléchargez les informations de certificat sous la forme d'un fichier PEM local :
    gcloud sql ssl server-ca-certs list \
    --format="value(cert)" \
    --instance=INSTANCE_NAME > \
    FILE_PATH/FILE_NAME.pem
  3. Mettez à jour l'ensemble de vos clients pour qu'ils utilisent les nouvelles informations. Pour cela, copiez le fichier téléchargé vers vos machines hôtes clientes afin de remplacer le fichier server-ca.pem existant.
  4. Après avoir mis à jour les clients, procédez à la rotation :
    gcloud sql ssl server-ca-certs rotate \
    --instance=INSTANCE_NAME
          
  5. Assurez-vous que les clients se connectent correctement.
  6. Si certains clients ne parviennent pas à se connecter à l'aide du nouveau certificat, effectuez un rollback pour rétablir la configuration précédente.

REST v1

  1. Téléchargez les certificats CA du serveur :

    Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/listServerCas

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Procédez à la rotation :

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/rotateServerCa

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

  1. Téléchargez les certificats CA du serveur :

    Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/listServerCas

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Procédez à la rotation :

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rotateServerCa

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Si vous recevez une erreur indiquant No upcoming/previous Server CA Certificate exists lorsque vous essayez d'effectuer la rotation d'un certificat, vérifiez que vous exécutez la commande sur une instance qui utilise la hiérarchie d'autorités de certification par instance. Vous pouvez afficher la hiérarchie d'autorités de certification configurée pour une instance Cloud SQL à l'aide de la commande gcloud sql instances describe. Pour en savoir plus, consultez Afficher les informations sur les instances.

Effectuer un rollback pour annuler une opération de rotation de certificats

Après avoir accompli une rotation, tous les clients doivent utiliser le nouveau certificat pour se connecter à l'instance Cloud SQL. S'ils ne sont pas mis à jour correctement pour utiliser les informations du nouveau certificat, ils ne peuvent pas se connecter à l'instance à l'aide de SSL/TLS. Dans ce cas, vous pouvez revenir à la configuration de certificat précédente.

L'opération de restauration consiste à placer le certificat actif dans l'emplacement "à venir" (remplaçant tout certificat "à venir"). Le certificat "précédent" redevient le certificat actif, ramenant votre configuration à son état d'origine.

Pour revenir à la configuration de certificat précédente :

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Cliquez sur l'onglet Sécurité.
  5. Cliquez pour développer Gérer les certificats.
  6. Sélectionnez Effectuer un rollback de certificat CA.

    Si aucun certificat n'est éligible, l'option de rollback n'est pas disponible. Sinon, l'action de rollback se termine après quelques secondes.

gcloud

gcloud sql ssl server-ca-certs rollback \
--instance=INSTANCE_NAME
   

REST v1

  1. Téléchargez les certificats CA du serveur :

    Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/listServerCas

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Copiez le champ sha1Fingerprint correspondant à la version à restaurer.

    Recherchez la version ayant une valeur createTime immédiatement antérieure à la version dont la valeur sha1Fingerprint est activeVersion.

  3. Effectuez la restauration avant la rotation :

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/rotateServerCa

    Corps JSON de la requête :

    {
      "rotateServerCaContext": {"nextVersion": "sha1Fingerprint"}
    }
    

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

  1. Téléchargez les certificats CA du serveur :

    Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/listServerCas

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Copiez le champ sha1Fingerprint correspondant à la version à restaurer.

    Recherchez la version ayant une valeur createTime immédiatement antérieure à la version dont la valeur sha1Fingerprint est activeVersion.

  3. Effectuez la restauration avant la rotation :

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rotateServerCa

    Corps JSON de la requête :

    {
      "rotateServerCaContext": {"nextVersion": "sha1Fingerprint"}
    }
    

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Si vous recevez une erreur indiquant No upcoming/previous Server CA Certificate exists lorsque vous essayez d'effectuer un rollback d'une rotation de l'autorité de certification, vérifiez que vous exécutez la commande sur une instance qui utilise la hiérarchie d'autorité de certification par instance. Vous pouvez afficher la hiérarchie d'autorités de certification configurée pour une instance Cloud SQL à l'aide de la commande gcloud sql instances describe. Pour en savoir plus, consultez Afficher les informations sur les instances.

Lancer une rotation

Vous n'avez pas besoin d'attendre l'e-mail de Cloud SQL pour démarrer une rotation. Vous pouvez en initier une à tout moment. Dès lors que vous démarrez une rotation, un nouveau certificat est créé et placé dans l'emplacement "à venir". Si un certificat est déjà présent dans l'emplacement suivant au moment de votre demande, ce certificat est supprimé. Il ne peut y avoir qu'un seul certificat à venir.

Pour démarrer une rotation :

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Cliquez sur l'onglet Sécurité.
  5. Cliquez pour développer Gérer les certificats.
  6. Cliquez sur Créer un certificat CA.
  7. Sélectionnez Effectuer une rotation de certificat CA.

    Si aucun certificat n'est éligible, l'option de rotation n'est pas disponible.

  8. Procédez à la rotation comme décrit dans la section Effectuer une rotation des certificats CA de serveur.

gcloud

  1. Démarrez la rotation :
    gcloud sql ssl server-ca-certs create \
    --instance=INSTANCE_NAME
         
  2. Procédez à la rotation comme décrit dans la section Effectuer une rotation des certificats CA de serveur.

REST v1

  1. Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/rotateServerCa

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Procédez à la rotation comme décrit dans la section Effectuer une rotation des certificats CA de serveur.

REST v1beta4

  1. Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rotateServerCa

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Procédez à la rotation comme décrit dans la section Effectuer une rotation des certificats CA de serveur.

Obtenir des informations sur un certificat CA de serveur

Vous pouvez obtenir des informations sur votre certificat CA de serveur, par exemple sa date d'expiration ou son niveau de chiffrement.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Cliquez sur l'onglet Sécurité.

    Dans le champ Gérer les certificats CA de serveur, vous pouvez voir la date d'expiration de votre certificat CA de serveur dans le tableau.

    Pour afficher le type de certificat, utilisez la commande gcloud sql ssl server-ca-certs list --instance=INSTANCE_NAME.

gcloud

gcloud sql ssl server-ca-certs list \
--instance=INSTANCE_NAME

REST v1

Lorsque vous décrivez votre instance, vous pouvez afficher des informations sur le certificat CA du serveur :

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=serverCaCert

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

Lorsque vous décrivez votre instance, vous pouvez afficher des informations sur le certificat CA du serveur :

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=serverCaCert

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Afficher le contenu des certificats CA

Vous pouvez utiliser openssl storeutl pour afficher le contenu des certificats CA.

Lorsque vous exécutez la commande sql ssl server-ca-certs list, vous pouvez obtenir plusieurs certificats CA à partir d'opérations précédentes liées à la rotation.

gcloud

  1. Exécutez la commande suivante :
    gcloud sql ssl server-ca-certs list \
      --instance=INSTANCE_NAME \
      --format='value(cert)' > temp_cert.pem

    Remplacez INSTANCE_NAME par le nom de l'instance.

  2. Utilisez openssl pour examiner le contenu des certificats CA.
  3. openssl storeutl -noout -text temp_cert.pem
       

Afficher le contenu d'un certificat de serveur

Vous pouvez utiliser nmap pour afficher le contenu des certificats de serveur. Pour télécharger et installer nmap, accédez à https://nmap.org/.

gcloud

Pour afficher le contenu du certificat du serveur, exécutez la commande suivante :

nmap -sV -p 1433 --script ssl-cert INSTANCE_IP_ADDRESS -Pn

Remplacez INSTANCE_IP_ADDRESS par l'adresse IP de l'instance.

Notification d'expiration du certificat SSL du serveur externe

  • Si le certificat CA du serveur externe arrive à expiration, effectuez une rotation des certificats SSL, y compris du certificat CA du serveur sur l'instance sur site. Cette étape dépend de la manière dont l'instance sur site est gérée. Les étapes peuvent varier si, par exemple, vous utilisez un certificat CA de serveur RDS, un certificat CA de serveur Cloud SQL ou un certificat CA de serveur générique de base de données.
  • Si le certificat client arrive à expiration, vous devez générer un nouveau certificat et une nouvelle clé. Cela s'applique aux certificats SSL gérés par Google Cloudet aux certificats autosignés.
  • Mettez à jour l'instance de représentation source Cloud SQL avec les nouveaux certificats SSL.

Gérer les certificats de serveur (CA partagée)

Cette section explique comment gérer les certificats de serveur sur les instances qui utilisent des CA partagées ou des CA gérées par le client.

Vous pouvez choisir d'utiliser des CA partagées comme mode de CA de serveur pour votre instance en spécifiant GOOGLE_MANAGED_CAS_CA pour le paramètre serverCaMode (API Cloud SQL Admin) ou l'option --server-ca-mode (gcloud CLI) lorsque vous créez ou modifiez votre instance.

Pour utiliser une autorité de certification gérée par le client comme mode d'autorité de certification du serveur pour votre instance, vous devez spécifier CUSTOMER_MANAGED_CAS_CA pour le paramètre serverCaMode (API Cloud SQL Admin) ou l'option --server-ca-mode (gcloud CLI) lorsque vous créez ou modifiez votre instance. Vous devez également disposer d'un pool d'autorités de certification et d'une autorité de certification valides. Pour en savoir plus, consultez Utiliser une CA gérée par le client.

Activer ou désactiver la rotation automatique des certificats de serveur

Nous vous recommandons d'activer la rotation automatique des certificats de serveur. Lorsque cette fonctionnalité est activée, Cloud SQL effectue automatiquement la rotation de votre certificat de serveur lors de la mise à jour de maintenance planifiée ou lorsque vous effectuez une maintenance en libre-service jusqu'à 180 jours avant l'expiration du certificat. La rotation automatique des certificats vous permet d'éviter les interruptions de connexion causées par des certificats arrivés à expiration et d'éliminer la nécessité d'effectuer une rotation manuelle des certificats.

Vous pouvez activer la rotation automatique des certificats de serveur lorsque vous créez votre instance ou lorsque vous modifiez votre instance existante.

La procédure suivante explique comment modifier une instance existante pour activer ou désactiver la rotation automatique des certificats de serveur.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Cliquez sur Modifier.
  4. Dans la section Personnaliser votre instance, développez Afficher les options de configuration.
  5. Cliquez sur Sécurité pour développer la section de configuration de la sécurité.
  6. Effectuez l'une des opérations suivantes :
    • Pour activer la rotation automatique des certificats de serveur, cochez la case Effectuer une rotation automatique des certificats de serveur.
    • Pour désactiver la rotation automatique des certificats de serveur, décochez la case Effectuer une rotation automatique des certificats de serveur.
  7. Cliquez sur Enregistrer.

gcloud

Pour modifier le mode de rotation des certificats de serveur d'une instance, utilisez la commande gcloud sql instances patch :

gcloud sql instances patch INSTANCE_NAME \
  --project=PROJECT_ID \
  --server-certificate-rotation-mode=SERVER_CERTIFICATE_ROTATION_MODE

Effectuez les remplacements suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL dont vous modifiez le certificat de serveur.
  • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance.
  • SERVER_CERTIFICATE_ROTATION_MODE : spécifiez NO_AUTOMATIC_ROTATION ou AUTOMATIC_ROTATION_DURING_MAINTENANCE.

REST v1

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID ou numéro de votre projet Google Cloud . Ce projet contient une instance Cloud SQL dotée d'un certificat de serveur que vous gérez.
  • INSTANCE_NAME : nom de l'instance.
  • SERVER_CERTIFICATE_ROTATION_MODE : spécifiez NO_AUTOMATIC_ROTATION ou AUTOMATIC_ROTATION_DURING_MAINTENANCE.

Méthode HTTP et URL :

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corps JSON de la requête :

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "serverCertificateRotationMode": "SERVER_CERTIFICATE_ROTATION_MODE"
    },
    "kind": "sql#settings"
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2026-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Pour découvrir comment est formée la requête API REST sous-jacente pour cette tâche, consultez la page dédiée à la méthode "instances:patch" dans APIs Explorer.

REST v1beta4

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID ou numéro de votre projet Google Cloud . Ce projet contient une instance Cloud SQL dotée d'un certificat de serveur que vous gérez.
  • INSTANCE_NAME : nom de l'instance.
  • SERVER_CERTIFICATE_ROTATION_MODE : spécifiez NO_AUTOMATIC_ROTATION ou AUTOMATIC_ROTATION_DURING_MAINTENANCE.

Méthode HTTP et URL :

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corps JSON de la requête :

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "serverCertificateRotationMode": "SERVER_CERTIFICATE_ROTATION_MODE"
    },
    "kind": "sql#settings"
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2026-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Pour découvrir comment est formée la requête API REST sous-jacente pour cette tâche, consultez la page dédiée à la méthode "instances:patch" dans APIs Explorer.

Effectuer une rotation manuelle des certificats de serveur

Si vous avez reçu une notification d'expiration de vos certificats de serveur ou si vous souhaitez lancer une rotation, mais que la rotation automatique des certificats de serveur n'est pas activée, suivez les étapes ci-dessous pour effectuer la rotation. Avant de démarrer la rotation, un certificat de serveur doit être créé pour la rotation à venir. Si un certificat de serveur a déjà été créé pour la rotation à venir, vous pouvez ignorer la première étape de la procédure suivante.

Pour effectuer une rotation du certificat de serveur sur votre instance, procédez comme suit :

  1. Si vous avez besoin d'un nouveau certificat de serveur, créez-en un.

  2. Si vos clients font déjà confiance au dernier bundle d'autorités de certification régional, cette étape est facultative. Toutefois, si vous devez mettre à jour vos clients avec les informations de l'autorité de certification du serveur, procédez comme suit :

    1. Téléchargez les dernières informations sur les CA de serveur.
    2. Mettez à jour vos clients afin qu'ils utilisent les informations les plus récentes du certificat CA de serveur.
  3. Effectuez la rotation en déplaçant le certificat actif vers l'emplacement précédent et en définissant le nouveau certificat comme certificat actif.

Console

Téléchargez les informations de certificat CA de serveur, encodées sous forme de fichier PEM, dans votre environnement local :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Cliquez sur l'onglet Sécurité.
  5. Cliquez pour développer Gérer les certificats.
  6. Vérifiez que l'option Faire pivoter le certificat du serveur apparaît comme une option disponible, mais ne la sélectionnez pas encore.

    Si aucun certificat n'est éligible, l'option de rotation n'est pas disponible. Vous devez créer un certificat de serveur.

  7. Cliquez sur Télécharger les certificats.

Mettez à jour l'ensemble de vos clients SQL Server pour qu'ils utilisent les nouvelles informations. Pour cela, copiez le fichier téléchargé vers vos machines hôtes clientes afin de remplacer le fichier server-ca.pem existant.

Après avoir mis à jour les clients, procédez à la rotation :

  1. Revenez à l'onglet Sécurité.
  2. Cliquez pour développer Gérer les certificats.
  3. Sélectionnez Alterner le certificat.
  4. Dans la boîte de dialogue Confirmer la rotation des certificats, cliquez sur Effectuer une rotation.
  5. Assurez-vous que les clients se connectent correctement.

    Si certains clients ne parviennent pas à se connecter à l'aide du nouveau certificat, vous pouvez sélectionner Rollback du certificat pour effectuer un rollback vers la configuration précédente.

gcloud

  1. Pour créer un certificat de serveur, exécutez la commande suivante :
    gcloud sql ssl server-certs create \
    --instance=INSTANCE
  2. Remplacez INSTANCE par le nom de l'instance.
  3. Assurez-vous d'utiliser le dernier bundle d'autorités de certification. Si vous n'utilisez pas le dernier bundle d'autorités de certification, exécutez la commande suivante pour télécharger les dernières informations sur les autorités de certification du serveur pour l'instance dans un fichier PEM local :
    gcloud sql ssl server-certs list \
    --format="value(ca_cert.cert)" \
    --instance=INSTANCE_NAME > \
    FILE_PATH/server-ca.pem

    Vous pouvez également télécharger les groupes de certificats CA à partir du tableau des groupes de certificats CA racine et régionale sur cette page.

    Mettez ensuite à jour l'ensemble de vos clients pour qu'ils utilisent les nouvelles informations de l'autorité de certification du serveur. Pour cela, copiez le fichier téléchargé vers vos machines hôtes clientes afin de remplacer les fichiers server-ca.pem existants.

  4. Après avoir mis à jour tous vos clients (si des mises à jour sont requises), effectuez la rotation :
    gcloud sql ssl server-certs rotate \
    --instance=INSTANCE_NAME
          
  5. Assurez-vous que les clients se connectent correctement.

    Si certains clients ne parviennent pas à se connecter à l'aide du nouveau certificat de serveur, effectuez un rollback pour rétablir la configuration précédente.

REST v1

  1. Créez un certificat de serveur.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/addServerCertificate

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Si vous devez télécharger les informations du certificat CA du serveur, vous pouvez utiliser la commande suivante.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/listServerCertificates

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  3. Terminez la rotation.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rotateServerCertificate

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

  1. Créez un certificat de serveur.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/addServerCertificate

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Si vous devez télécharger les informations du certificat CA du serveur, vous pouvez utiliser la commande suivante.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/listServerCertificates

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  3. Terminez la rotation.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rotateServerCertificate

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Effectuer un rollback pour annuler une rotation de certificats

Après avoir accompli une rotation de certificat de serveur, tous les clients doivent utiliser le nouveau certificat pour se connecter à l'instance Cloud SQL. S'ils ne sont pas mis à jour correctement pour utiliser les informations du nouveau certificat, ils ne peuvent pas se connecter à l'instance à l'aide de SSL/TLS. Dans ce cas, vous pouvez revenir à la configuration de certificat précédente.

L'opération de rollback consiste à placer le certificat actif dans l'emplacement "à venir", ce qui remplace tout certificat "à venir". Le certificat "précédent" redevient le certificat actif, ramenant votre configuration à son état d'origine.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Cliquez sur l'onglet Sécurité.
  5. Cliquez pour développer Gérer les certificats.
  6. Sélectionnez Effectuer un rollback de certificat de serveur.

    Si aucun certificat n'est éligible, l'option de rollback n'est pas disponible.

  7. Dans la boîte de dialogue Confirmer le rollback du certificat, sélectionnez Rollback.

    Le rollback peut prendre quelques secondes.

gcloud

gcloud sql ssl server-certs rollback \
--instance=INSTANCE_NAME
   

REST v1

  1. Répertoriez vos certificats de serveur.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/listServerCertificates

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Copiez le champ sha1Fingerprint correspondant à la version à restaurer.

    Recherchez la version dont la valeur createTime est immédiatement antérieure à la version dont la valeur sha1Fingerprint est affichée sous la forme activeVersion.

  3. Effectuez la restauration avant la rotation.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rotateServerCertificate

    Corps JSON de la requête :

    {
      "rotateServerCertificateContext": {"nextVersion": "sha1Fingerprint"}
    }
    

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

  1. Répertoriez vos certificats de serveur.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/listServerCertificates

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Copiez le champ sha1Fingerprint correspondant à la version à restaurer.

    Recherchez la version dont la valeur createTime est immédiatement antérieure à la version dont la valeur sha1Fingerprint est affichée sous la forme activeVersion.

  3. Effectuez la restauration avant la rotation.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rotateServerCertificate

    Corps JSON de la requête :

    {
      "rotateServerCertificateContext": {"nextVersion": "sha1Fingerprint"}
    }
    

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Afficher le contenu des certificats CA

Vous pouvez utiliser l'utilitaire openssl storeutl pour afficher le contenu des certificats CA.

Lorsque vous exécutez la commande sql ssl server-certs list, vous obtenez toujours plusieurs certificats CA en raison de la chaîne de confiance. Vous pouvez également obtenir plusieurs certificats CA à partir d'opérations précédentes liées à la rotation.

gcloud

  1. Exécutez la commande suivante :
    gcloud sql ssl server-certs list \
      --instance=INSTANCE_NAME \
      --format='value(ca_cert.cert)' > temp_cert.pem

    Remplacez INSTANCE_NAME par le nom de l'instance.

  2. Utilisez openssl pour examiner le contenu des certificats CA.
  3. openssl storeutl -noout -text temp_cert.pem
       

Télécharger des groupes de certificats CA racine et régionaux pour une CA partagée

Si vous utilisez une configuration d'autorité de certification partagée gérée par Google, vous pouvez télécharger les bundles de certificats CA racine et régionale à partir du tableau suivant.

Ces bundles de certificats ne s'appliquent pas aux instances qui utilisent les options d'autorité de certification par instance ou gérée par le client.

Nom de la région Emplacement Ensemble de certificats
Monde
CA pour toutes les régions Tous les emplacements global.pem
Asie
asia-east1 Taïwan asia-east1.pem
asia-east2 Hong Kong asia-east2.pem
asia-northeast1 Tokyo asia-northeast1.pem
asia-northeast2 Osaka asia-northeast2.pem
asia-northeast3 Séoul asia-northeast3.pem
asia-south1 Mumbai asia-south1.pem
asia-south2 Delhi asia-south2.pem
asia-southeast1 Singapour asia-southeast1.pem
asia-southeast2 Jakarta asia-southeast2.pem
asia-southeast3 Bangkok asia-southeast3.pem
Afrique
africa-south1 Johannesburg africa-south1.pem
Australie
australia-southeast1 Sydney australia-southeast1.pem
australia-southeast2 Melbourne australia-southeast2.pem
Europe
europe-central2 Varsovie europe-central2.pem
europe-north1 Finlande europe-north1.pem
europe-north2 Stockholm europe-north2.pem
europe-southwest1 Madrid europe-southwest1.pem
europe-west1 Belgique europe-west1.pem
europe-west2 Londres europe-west2.pem
europe-west3 Francfort europe-west3.pem
europe-west4 Pays-Bas europe-west4.pem
europe-west6 Zurich europe-west6.pem
europe-west8 Milan europe-west8.pem
europe-west9 Paris europe-west9.pem
europe-west10 Berlin europe-west10.pem
europe-west12 Turin europe-west12.pem
Moyen-Orient
me-central1 Doha me-central1.pem
me-central2 Dammam me-central2.pem
me-west1 Tel-Aviv me-west1.pem
Amérique du Nord
northamerica-northeast1 Montréal northamerica-northeast1.pem
northamerica-northeast2 Toronto northamerica-northeast2.pem
northamerica-south1 Mexique northamerica-south1.pem
us-central1 Iowa us-central1.pem
us-east1 Caroline du Sud us-east1.pem
us-east4 Virginie du Nord us-east4.pem
us-east5 Columbus us-east5.pem
us-south1 Dallas us-south1.pem
us-west1 Oregon us-west1.pem
us-west2 Los Angeles us-west2.pem
us-west3 Salt Lake City us-west3.pem
us-west4 Las Vegas us-west4.pem
Amérique du Sud
southamerica-east1 São Paulo southamerica-east1.pem
southamerica-west1 Santiago southamerica-west1.pem

Réinitialiser la configuration SSL/TLS

Vous pouvez réinitialiser complètement votre configuration SSL/TLS.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Connexions.
  4. Accédez à la section Réinitialiser la configuration SSL.
  5. Cliquez sur Réinitialiser la configuration SSL.

gcloud

  1. Actualisez le certificat :

    gcloud sql instances reset-ssl-config INSTANCE_NAME

REST v1beta4

  1. Actualisez le certificat :

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/resetSslConfig

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Étape suivante