AWS CloudHSM Déchargement SSL/TLS sous Linux à l'aide de NGINX ou du fournisseur OpenSSL HAProxy - AWS CloudHSM

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS CloudHSM Déchargement SSL/TLS sous Linux à l'aide de NGINX ou du fournisseur OpenSSL HAProxy

Cette rubrique fournit des step-by-step instructions pour configurer le SSL/TLS délestage d'identité de serveur AWS CloudHSM sur un serveur Web Linux utilisant NGINX ou avec HAProxy le fournisseur OpenSSL.

Présentation de

Sous Linux, le logiciel NGINX et le serveur HAProxyWeb s'intègrent à OpenSSL pour prendre en charge le protocole HTTPS. Le fournisseur AWS CloudHSM OpenSSL fournit une interface qui permet au logiciel du serveur Web d'utiliser le contenu de votre cluster pour HSMs le déchargement cryptographique et le stockage de clés. Le fournisseur OpenSSL est le pont qui connecte le serveur Web à votre cluster. AWS CloudHSM

Pour terminer ce didacticiel, vous allez configurer NGINX ou HAProxy utiliser le fournisseur OpenSSL AWS CloudHSM . Le didacticiel explique comment effectuer les opérations suivantes :

  • Installez le logiciel du serveur Web sur une EC2 instance Amazon.

  • Configurez le logiciel du serveur Web pour qu'il prenne en charge le protocole HTTPS avec une clé privée stockée dans votre cluster AWS CloudHSM .

  • (Facultatif) Utilisez Amazon EC2 pour créer une deuxième instance de serveur Web et Elastic Load Balancing pour créer un équilibreur de charge. L'utilisation d'un équilibreur de charge peut accroître les performances en répartissant la charge sur plusieurs serveurs. Elle peut également assurer la redondance et une meilleure disponibilité en cas de défaillance d'un ou plusieurs serveurs.

Lorsque vous êtes prêt à commencer, consultez Étape 1 : Configurer les prérequis.

Étape 1 : Configurer les prérequis

Les différentes plateformes ont des prérequis différents. Utilisez la section des prérequis ci-dessous qui correspond à votre plateforme.

Conditions préalables pour le fournisseur AWS CloudHSM OpenSSL

Pour configurer le délestage d'identité SSL/TLS du serveur Web avec le fournisseur AWS CloudHSM OpenSSL pour le client SDK 5, vous avez besoin des éléments suivants :

  • Un AWS CloudHSM cluster actif avec au moins deux modules de sécurité matériels (HSM)

    Note

    Vous pouvez utiliser un seul cluster HSM, mais vous devez d'abord désactiver la durabilité des clés client. Pour plus d'informations, voir Gérer les paramètres de durabilité des clés client et Outil de configuration du SDK client 5.

  • Une EC2 instance Amazon exécutant un système d'exploitation Linux avec les logiciels suivants installés :

    • Un serveur Web (NGINX ou) HAProxy

    • Le fournisseur AWS CloudHSM OpenSSL pour le SDK client 5

  • Un utilisateur de chiffrement (CU) propriétaire et gestionnaire de la clé privée du serveur web sur le HSM.

Pour configurer une instance de serveur web Linux et créer un utilisateur de chiffrement sur le HSM
Note

La plupart des commandes de cette procédure nécessitent des privilèges élevés. Il se peut que vous deviez exécuter des commandes avec sudo ou en tant qu'utilisateur root en fonction de la configuration de votre système.

  1. Installez et configurez le fournisseur AWS CloudHSM OpenSSL pour le SDK client 5. Pour plus d'informations sur l'installation du fournisseur OpenSSL, consultez la section Fournisseur AWS CloudHSM OpenSSL pour client SDK 5.

  2. Sur une instance EC2 Linux ayant accès à votre cluster, installez NGINX ou un serveur HAProxy Web :

    Amazon Linux 2023
    • NGINX

      $ yum install nginx
    • HAProxy

      $ yum install haproxy
    RHEL 9 (9.2+)
    • NGINX

      $ yum install nginx
    • HAProxy

      $ yum install haproxy
    RHEL 10 (10.0+)
    • NGINX

      $ yum install nginx
    • HAProxy

      $ yum install haproxy
    Ubuntu 24.04
    • NGINX

      $ apt install nginx
    • HAProxy

      $ apt install haproxy
  3. Utilisez la CLI CloudHSM pour créer un utilisateur de chiffrement. Pour plus d'informations sur la gestion des utilisateurs HSM, consultez la section Gestion des utilisateurs HSM avec la CLI CloudHSM.

    Astuce

    Conservez le nom d'utilisateur et le mot de passe du CU. Vous en aurez besoin plus tard pour générer ou importer la clé privée HTTPS et le certificat de votre serveur web.

Une fois que vous avez terminé ces étapes, consultez Étape 2 : générer ou importer une clé privée et obtenir un certificat.

Remarques

  • Pour utiliser Security-Enhanced Linux (SELinux) et les serveurs Web, vous devez autoriser les connexions TCP sortantes sur le port 2223, qui est le port utilisé par le SDK client 5 pour communiquer avec le HSM.

  • Pour créer et activer un cluster et donner à une EC2 instance l'accès au cluster, suivez les étapes décrites dans Getting Started with AWS CloudHSM. La section Getting Started propose des step-by-step instructions pour créer un cluster actif avec un HSM et une instance EC2 client Amazon. Vous pouvez utiliser cette instance client comme serveur web.

  • Pour éviter de désactiver la durabilité des clés client, ajoutez plusieurs HSM à votre cluster. Pour de plus amples informations, veuillez consulter Ajouter un HSM à un cluster AWS CloudHSM.

  • Vous pouvez utiliser un SSH ou PuTTY pour vous connecter à votre instance client. Pour plus d'informations, consultez Connexion à votre instance Linux à l'aide de SSH ou Connexion à votre instance Linux depuis Windows à l'aide de PuTTY dans la documentation Amazon EC2.

Étape 2 : générer ou importer une clé privée et obtenir un certificat

Pour activer le protocole HTTPS, votre application de serveur Web (NGINX ou HAProxy) a besoin d'une clé privée et d'un certificat correspondant SSL/TLS . Pour utiliser le SSL/TLS délestage d'identité du serveur Web avec AWS CloudHSM, vous devez stocker la clé privée dans un HSM de votre AWS CloudHSM cluster. Vous allez d'abord générer une clé privée et l'utiliser pour créer une demande de signature de certificat (CSR). Vous exportez ensuite une fausse clé privée PEM depuis le HSM, qui est un fichier de clé privée au format PEM contenant une référence à la clé privée stockée sur le HSM (il ne s'agit pas de la véritable clé privée). Votre serveur Web utilise le faux fichier de clé privée PEM pour identifier la clé privée sur le HSM lors du déchargement de l'identité SSL/TLS du serveur.

Générer une clé privée

Cette section explique comment générer une paire de clés à l'aide de la CLI CloudHSM. Une fois qu'une paire de clés est générée dans le HSM, vous pouvez l'exporter sous forme de faux fichier PEM et générer le certificat correspondant.

Installation et configuration de la CLI CloudHSM
  1. Installez et configurez la CLI CloudHSM.

  2. Utilisez la commande suivante pour démarrer la CLI CloudHSM.

    $ /opt/cloudhsm/bin/cloudhsm-cli interactive
  3. Exécutez la commande suivante pour vous connecter au HSM. Remplacez <user name> par le nom d'utilisateur de votre cryptomonniste

    aws-cloudhsm>login --username <user name> --role crypto-user

Générer une clé privée

En fonction de votre cas d'utilisation, vous pouvez générer une paire de clés RSA ou EC. Effectuez l’une des actions suivantes :

  • Pour générer une clé privée RSA sur un HSM

    Utilisez la commande key generate-asymmetric-pair rsa pour générer une paire de clés RSA. Cet exemple génère une paire de clés RSA avec un module de 2048, un exposant public de 65537, une étiquette de clé publique de et une étiquette de clé privée detls_rsa_pub. tls_rsa_private

    aws-cloudhsm > key generate-asymmetric-pair rsa \ --public-exponent 65537 \ --modulus-size-bits 2048 \ --public-label tls_rsa_pub \ --private-label tls_rsa_private \ --private-attributes sign=true { "error_code": 0, "data": { "public_key": { "key-reference": "0x0000000000280cc8", "key-info": { "key-owners": [ { "username": "cu1", "key-coverage": "full" } ], "shared-users": [], "cluster-coverage": "full" }, "attributes": { "key-type": "rsa", "label": "tls_rsa_pub", "id": "", "check-value": "0x01fe6e", "class": "public-key", "encrypt": true, "decrypt": false, "token": true, "always-sensitive": false, "derive": false, "destroyable": true, "extractable": true, "local": true, "modifiable": true, "never-extractable": false, "private": true, "sensitive": false, "sign": false, "trusted": false, "unwrap": false, "verify": false, "wrap": false, "wrap-with-trusted": false, "key-length-bytes": 512, "public-exponent": "0x010001", "modulus": "0xb1d27e857a876f4e9fd5de748a763c539b359f937eb4b4260e30d1435485a732c878cdad9c72538e2215351b1d41358c9bf80b599c73a80fdb457aa7b20cd61e486c326e2cfd5e124a7f6a996437437812b542e3caf85928aa866f0298580f7967ee6aa01440297d7308fdd9b76b70d1b67f12634df6e6296d6c116d5744c6d60d14d3bf3cb978fe6b75ac67b7089bafd50d8687213b31abc7dc1bad422780d29c851d5102b56f932551eaf52a9591fd8c43d81ecc133022653225bd129f8491101725e9ea33e1ded83fb57af35f847e532eb30cd7e726f23910d2671c6364092e834697ec3cef72cc23615a1ba7c5e100156ae0acac3160f0ca9725d38318b7", "modulus-size-bits": 2048 } }, "private_key": { "key-reference": "0x0000000000280cc7", "key-info": { "key-owners": [ { "username": "cu1", "key-coverage": "full" } ], "shared-users": [], "cluster-coverage": "full" }, "attributes": { "key-type": "rsa", "label": "tls_rsa_private", "id": "", "check-value": "0x01fe6e", "class": "private-key", "encrypt": false, "decrypt": true, "token": true, "always-sensitive": true, "derive": false, "destroyable": true, "extractable": true, "local": true, "modifiable": true, "never-extractable": false, "private": true, "sensitive": true, "sign": true, "trusted": false, "unwrap": false, "verify": false, "wrap": false, "wrap-with-trusted": false, "key-length-bytes": 1217, "public-exponent": "0x010001", "modulus": "0xb1d27e857a876f4e9fd5de748a763c539b359f937eb4b4260e30d1435485a732c878cdad9c72538e2215351b1d41358c9bf80b599c73a80fdb457aa7b20cd61e486c326e2cfd5e124a7f6a996437437812b542e3caf85928aa866f0298580f7967ee6aa01440297d7308fdd9b76b70d1b67f12634df6e6296d6c116d5744c6d60d14d3bf3cb978fe6b75ac67b7089bafd50d8687213b31abc7dc1bad422780d29c851d5102b56f932551eaf52a9591fd8c43d81ecc133022653225bd129f8491101725e9ea33e1ded83fb57af35f847e532eb30cd7e726f23910d2671c6364092e834697ec3cef72cc23615a1ba7c5e100156ae0acac3160f0ca9725d38318b7", "modulus-size-bits": 2048 } } } }
  • Pour générer une clé privée EC sur un HSM

    Utilisez la commande key generate-asymmetric-pair ec pour générer une paire de clés EC. Cet exemple génère une paire de clés EC avec la prime256v1 courbe (correspondant à la NID_X9_62_prime256v1 courbe), une étiquette de tls_ec_pub clé publique et une étiquette de clé privée detls_ec_private.

    aws-cloudhsm > key generate-asymmetric-pair ec \ --curve prime256v1 \ --public-label tls_ec_pub \ --private-label tls_ec_private \ --private-attributes sign=true { "error_code": 0, "data": { "public_key": { "key-reference": "0x000000000012000b", "key-info": { "key-owners": [ { "username": "cu1", "key-coverage": "full" } ], "shared-users": [], "cluster-coverage": "session" }, "attributes": { "key-type": "ec", "label": "tls_ec_pub", "id": "", "check-value": "0xd7c1a7", "class": "public-key", "encrypt": false, "decrypt": false, "token": false, "always-sensitive": false, "derive": false, "destroyable": true, "extractable": true, "local": true, "modifiable": true, "never-extractable": false, "private": true, "sensitive": false, "sign": false, "trusted": false, "unwrap": false, "verify": false, "wrap": false, "wrap-with-trusted": false, "key-length-bytes": 57, "ec-point": "0x047096513df542250a6b228fd9cb67fd0c903abc93488467681974d6f371083fce1d79da8ad1e9ede745fb9f38ac8622a1b3ebe9270556000c", "curve": "secp224r1" } }, "private_key": { "key-reference": "0x000000000012000c", "key-info": { "key-owners": [ { "username": "cu1", "key-coverage": "full" } ], "shared-users": [], "cluster-coverage": "session" }, "attributes": { "key-type": "ec", "label": "tls_ec_private", "id": "", "check-value": "0xd7c1a7", "class": "private-key", "encrypt": false, "decrypt": false, "token": false, "always-sensitive": true, "derive": false, "destroyable": true, "extractable": true, "local": true, "modifiable": true, "never-extractable": false, "private": true, "sensitive": true, "sign": true, "trusted": false, "unwrap": false, "verify": false, "wrap": false, "wrap-with-trusted": false, "key-length-bytes": 122, "ec-point": "0x047096513df542250a6b228fd9cb67fd0c903abc93488467681974d6f371083fce1d79da8ad1e9ede745fb9f38ac8622a1b3ebe9270556000c", "curve": "secp224r1" } } } }

Exporter un faux fichier de clé privée PEM

Une fois que vous avez une clé privée sur le HSM, vous devez exporter un faux fichier de clé privée PEM. Ce fichier ne contient pas les données clés réelles, mais il permet au moteur dynamique OpenSSL d'identifier la clé privée sur le HSM. Vous pouvez ensuite utiliser la clé privée pour créer une demande de signature de certificat (CSR) et signer la CSR pour créer le certificat.

Utilisez la key generate-filecommande pour exporter la clé privée au faux format PEM et enregistrez-la dans un fichier. Remplacez les valeurs suivantes par vos propres valeurs :

  • <private_key_label>— Libellé de la clé privée que vous avez générée à l'étape précédente.

  • <web_server_fake_pem.key>— Nom du fichier dans lequel votre fausse clé PEM sera écrite.

aws-cloudhsm > key generate-file --encoding reference-pem --path <web_server_fake_pem.key> --filter attr.label=<private_key_label> { "error_code": 0, "data": { "message": "Successfully generated key file" } }

Quittez la CLI CloudHSM

Exécutez la commande suivante pour arrêter la CLI CloudHSM.

aws-cloudhsm > quit

Vous devriez maintenant avoir un nouveau fichier sur votre système, situé sur le chemin indiqué <web_server_fake_pem.key> dans la commande précédente. Ce fichier est le faux fichier de clé privée PEM.

Générer un certificat signé automatiquement.

Une fois que vous avez généré une fausse clé privée PEM, vous pouvez utiliser ce fichier pour générer une demande de signature de certificat (CSR) et un certificat.

Dans un environnement de production, vous utilisez généralement une autorité de certification (CA) pour créer un certificat émis par une demande de signature de certificat (CSR). L'autorité de certification n'est pas nécessaire pour un environnement de test. Si vous utilisez une autorité de certification, envoyez-lui le fichier CSR et utilisez le SSL/TLS certificat signé qu'elle vous fournit sur votre serveur Web pour HTTPS.

Au lieu d'utiliser une autorité de certification, vous pouvez utiliser le moteur dynamique AWS CloudHSM OpenSSL pour créer un certificat auto-signé. Les certificats auto-signés ne sont pas approuvées par les navigateurs et ne doivent pas être utilisés dans les environnements de production. Ils peuvent cependant être utilisés dans les environnements de test.

Avertissement

Les certificats auto-signés doivent uniquement être utilisés dans un environnement de test. Pour un environnement de production, utilisez une méthode plus sécurisée telle qu'une autorité de certification pour créer un certificat.

Installation et configuration du moteur dynamique OpenSSL
  1. Connectez-vous à votre instance client .

  2. Installation du moteur AWS CloudHSM dynamique OpenSSL pour le SDK client 5

Générez un certificat
  1. Obtenez une copie de votre faux fichier PEM généré lors d'une étape précédente.

  2. Création d'une CSR

    Exécutez la commande suivante pour utiliser le moteur dynamique AWS CloudHSM OpenSSL afin de créer une demande de signature de certificat (CSR). <web_server_fake_pem.key>Remplacez-le par le nom du fichier contenant votre fausse clé privée PEM. <web_server.csr>Remplacez-le par le nom du fichier contenant votre CSR.

    La commande req est interactive. Renseignez chaque champ. Les informations du champ sont copiées dans votre SSL/TLS certificat.

    Note

    La création de CSR n'est actuellement pas prise en charge par le fournisseur OpenSSL. Vous devez utiliser le moteur OpenSSL pour cette étape, mais les opérations de chiffrement TLS fonctionneront avec le fournisseur.

    $ openssl req -engine cloudhsm -new -key <web_server_fake_pem.key> -out <web_server.csr>
  3. Créer un certificat auto-signé

    Exécutez la commande suivante pour utiliser le moteur dynamique AWS CloudHSM OpenSSL afin de signer votre CSR avec votre clé privée sur votre HSM. Cette opération crée un certificat auto-signé. Remplacez les valeurs suivantes par vos propres valeurs dans la commande :

    • <web_server.csr>— Nom du fichier contenant le CSR.

    • <web_server_fake_pem.key>— Nom du fichier contenant la fausse clé privée PEM.

    • <web_server.crt>— Nom du fichier qui contiendra le certificat de votre serveur Web.

    $ openssl x509 -engine cloudhsm -req -days 365 -in <web_server.csr> -signkey <web_server_fake_pem.key> -out <web_server.crt>

Une fois que vous avez une clé privée et un certificat, rendez-vous surÉtape 3 : Configurer le serveur web.

Étape 3 : Configurer le serveur web

Mettez à jour votre configuration de logiciel serveur web pour utiliser le certificat HTTPS et la fausse clé privée PEM correspondante que vous avez créée à l'étape précédente. N'oubliez pas de sauvegarder vos certificats et clés existants avant de commencer. Cela terminera la configuration de votre logiciel de serveur Web Linux pour le délestage de l'identité SSL/TLS du serveur avec AWS CloudHSM.

Complétez les étapes de l'une des sections suivantes.

Configuration du serveur Web NGINX

Utilisez cette section pour configurer NGINX avec le fournisseur OpenSSL.

Pour configurer NGINX pour le fournisseur OpenSSL
  1. Connectez-vous à votre instance client .

  2. Exécutez la commande suivante pour créer les répertoires requis pour le certificat de serveur web et la fausse clé privée PEM.

    $ mkdir -p /etc/pki/nginx/private
  3. Exécutez la commande suivante pour copier votre certificat de serveur web à l'emplacement requis. <web_server.crt>Remplacez-le par le nom de votre certificat de serveur Web.

    $ cp <web_server.crt> /etc/pki/nginx/server.crt
  4. Exécutez la commande suivante pour copier votre fausse clé privée PEM à l'emplacement requis. <web_server_fake_pem.key>Remplacez-le par le nom du fichier contenant votre fausse clé privée PEM.

    $ cp <web_server_fake_pem.key> /etc/pki/nginx/private/server.key
  5. Exécutez la commande suivante pour modifier la propriété des fichiers afin que l'utilisateur nommé nginx puisse les lire.

    $ chown nginx /etc/pki/nginx/server.crt /etc/pki/nginx/private/server.key
  6. Configurez OpenSSL pour utiliser le fournisseur. AWS CloudHSM Pour plus d'informations sur la configuration du fournisseur OpenSSL, consultez la section Fournisseur AWS CloudHSM OpenSSL pour client SDK 5.

    1. Localisez votre fichier de configuration OpenSSL :

      $ openssl version -d

      Vous devriez voir une sortie similaire à :

      OPENSSLDIR: "/etc/pki/tls"

      Le fichier de configuration se trouve openssl.cnf dans ce répertoire.

    2. Note

      Ne modifiez pas directement le fichier openssl.cnf par défaut de votre système. Cela empêche les opérations OpenSSL à l'échelle du système (connexions SSH, TLS et autres services) de passer par inadvertance par le biais du fournisseur CloudHSM.

      L'utilisation d'un fichier de configuration distinct vous permet d'étendre l'utilisation du fournisseur CloudHSM uniquement aux applications spécifiques qui nécessitent des opérations cryptographiques basées sur le protocole HSM.

      Créez un nouveau fichier de configuration OpenSSL avec le contenu suivant :

      $ cat > <example-cloudhsm-openssl.cnf> << 'EOF' ## NOTE: This should point to the system default openssl config file. # Replace /etc/pki/tls with the path to your OpenSSL configuration directory .include </etc/pki/tls>/openssl.cnf # Override the existing provider_section to include AWS CloudHSM OpenSSL Provider as a 3rd party OpenSSL provider [provider_sect] default = default_sect # Include AWS CloudHSM CloudHSM OpenSSL provider cloudhsm = cloudhsm_sect [default_sect] activate = 1 [cloudhsm_sect] activate = 1 EOF
    3. Assurez-vous que la variable d'CLOUDHSM_PINenvironnement est définie avec vos informations d'identification d'utilisateur cryptographique (CU) :

      $ export CLOUDHSM_PIN=<username>:<password>
    4. Définissez la variable d'OPENSSL_CONFenvironnement pour qu'elle pointe vers votre fichier de configuration mis à jour et vérifiez que le fournisseur est chargé :

      $ OPENSSL_CONF=/path/to/example-cloudhsm-openssl.cnf openssl list -providers

      Le fournisseur par défaut et le fournisseur CloudHSM devraient être répertoriés :

      OPENSSL_CONF=/path/to/example-cloudhsm-openssl.cnf openssl list -providers Providers: default name: OpenSSL Default Provider version: 3.2.2 status: active cloudhsm name: AWS CloudHSM OpenSSL Provider version: 5.17.0 status: active
  7. Exécutez la commande suivante pour sauvegarder le fichier /etc/nginx/nginx.conf.

    $ cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup
  8. Mise à jour de la configuration pour NGINX.

    Note

    Chaque cluster peut prendre en charge un maximum de 1 000 processus de travail NGINX sur tous les serveurs Web NGINX.

    Amazon Linux 2023

    Utilisez un éditeur de texte pour modifier le fichier /etc/nginx/nginx.conf. Cela peut nécessiter des autorisations root pour Linux. En haut du fichier, ajoutez les lignes suivantes :

    env CLOUDHSM_PIN; env OPENSSL_CONF;

    Ensuite, ajoutez ce qui suit à la section TLS du fichier :

    # Settings for a TLS enabled server. server { listen 443 ssl http2 default_server; listen [::]:443 ssl http2 default_server; server_name _; root /usr/share/nginx/html; ssl_certificate "/etc/pki/nginx/server.crt"; ssl_certificate_key "/etc/pki/nginx/private/server.key"; # It is *strongly* recommended to generate unique DH parameters for DHE ciphers # Generate them with: openssl dhparam -out /etc/pki/nginx/dhparams.pem 2048 # ssl_dhparam "/etc/pki/nginx/dhparams.pem"; ssl_session_cache shared:SSL:1m; ssl_session_timeout 10m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256"; ssl_prefer_server_ciphers off; # Load configuration files for the default server block. include /etc/nginx/default.d/*.conf; location / { } error_page 404 /404.html; location = /40x.html { } error_page 500 502 503 504 /50x.html; location = /50x.html { } }
    RHEL 9 (9.2+)

    Utilisez un éditeur de texte pour modifier le fichier /etc/nginx/nginx.conf. Cela peut nécessiter des autorisations root pour Linux. En haut du fichier, ajoutez les lignes suivantes :

    env CLOUDHSM_PIN; env OPENSSL_CONF;

    Ensuite, ajoutez ce qui suit à la section TLS du fichier :

    # Settings for a TLS enabled server. server { listen 443 ssl http2 default_server; listen [::]:443 ssl http2 default_server; server_name _; root /usr/share/nginx/html; ssl_certificate "/etc/pki/nginx/server.crt"; ssl_certificate_key "/etc/pki/nginx/private/server.key"; # It is *strongly* recommended to generate unique DH parameters for DHE ciphers # Generate them with: openssl dhparam -out /etc/pki/nginx/dhparams.pem 2048 # ssl_dhparam "/etc/pki/nginx/dhparams.pem"; ssl_session_cache shared:SSL:1m; ssl_session_timeout 10m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256"; ssl_prefer_server_ciphers off; # Load configuration files for the default server block. include /etc/nginx/default.d/*.conf; location / { } error_page 404 /404.html; location = /40x.html { } error_page 500 502 503 504 /50x.html; location = /50x.html { } }
    RHEL 10 (10.0+)

    Utilisez un éditeur de texte pour modifier le fichier /etc/nginx/nginx.conf. Cela peut nécessiter des autorisations root pour Linux. En haut du fichier, ajoutez les lignes suivantes :

    env CLOUDHSM_PIN; env OPENSSL_CONF;

    Ensuite, ajoutez ce qui suit à la section TLS du fichier :

    # Settings for a TLS enabled server. server { listen 443 ssl http2 default_server; listen [::]:443 ssl http2 default_server; server_name _; root /usr/share/nginx/html; ssl_certificate "/etc/pki/nginx/server.crt"; ssl_certificate_key "/etc/pki/nginx/private/server.key"; # It is *strongly* recommended to generate unique DH parameters for DHE ciphers # Generate them with: openssl dhparam -out /etc/pki/nginx/dhparams.pem 2048 # ssl_dhparam "/etc/pki/nginx/dhparams.pem"; ssl_session_cache shared:SSL:1m; ssl_session_timeout 10m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256"; ssl_prefer_server_ciphers off; # Load configuration files for the default server block. include /etc/nginx/default.d/*.conf; location / { } error_page 404 /404.html; location = /40x.html { } error_page 500 502 503 504 /50x.html; location = /50x.html { } }
    Ubuntu 24.04

    Utilisez un éditeur de texte pour modifier le fichier /etc/nginx/nginx.conf. Cela peut nécessiter des autorisations root pour Linux. En haut du fichier, ajoutez les lignes suivantes :

    env CLOUDHSM_PIN; env OPENSSL_CONF;

    Ensuite, ajoutez ce qui suit à la section TLS du fichier :

    # Settings for a TLS enabled server. server { listen 443 ssl http2 default_server; listen [::]:443 ssl http2 default_server; server_name _; root /var/www/html; ssl_certificate "/etc/ssl/certs/server.crt"; ssl_certificate_key "/etc/ssl/private/server.key"; # It is *strongly* recommended to generate unique DH parameters for DHE ciphers # Generate them with: openssl dhparam -out /etc/ssl/certs/dhparams.pem 2048 # ssl_dhparam "/etc/ssl/certs/dhparams.pem"; ssl_session_cache shared:SSL:1m; ssl_session_timeout 10m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256"; ssl_prefer_server_ciphers off; # Load configuration files for the default server block. include /etc/nginx/default.d/*.conf; location / { } error_page 404 /404.html; location = /40x.html { } error_page 500 502 503 504 /50x.html; location = /50x.html { } }

    Enregistrez le fichier.

  9. Sauvegardez le fichier de configuration systemd, puis définissez le chemin d'accès à EnvironmentFile.

    Amazon Linux 2023
    1. Sauvegardez le nginx.service fichier :

      $ cp /lib/systemd/system/nginx.service /lib/systemd/system/nginx.service.backup
    2. Ouvrez /lib/systemd/system/nginx.service dans un éditeur de texte. Dans la section [Service], ajoutez :

      EnvironmentFile=/etc/sysconfig/nginx
    RHEL 9 (9.2+)
    1. Sauvegardez le nginx.service fichier :

      $ cp /lib/systemd/system/nginx.service /lib/systemd/system/nginx.service.backup
    2. Ouvrez /lib/systemd/system/nginx.service dans un éditeur de texte. Dans la section [Service], ajoutez :

      EnvironmentFile=/etc/sysconfig/nginx
    RHEL 10 (10.0+)
    1. Sauvegardez le nginx.service fichier :

      $ cp /lib/systemd/system/nginx.service /lib/systemd/system/nginx.service.backup
    2. Ouvrez /lib/systemd/system/nginx.service dans un éditeur de texte. Dans la section [Service], ajoutez :

      EnvironmentFile=/etc/sysconfig/nginx
    Ubuntu 24.04
    1. Sauvegardez le nginx.service fichier :

      $ cp /lib/systemd/system/nginx.service /lib/systemd/system/nginx.service.backup
    2. Ouvrez /lib/systemd/system/nginx.service dans un éditeur de texte. Dans la section [Service], ajoutez :

      EnvironmentFile=/etc/sysconfig/nginx
  10. Vérifiez si le fichier /etc/sysconfig/nginx existe, puis effectuez l'une des actions suivantes :

    • Si le fichier existe, sauvegardez le fichier en exécutant la commande suivante :

      $ cp /etc/sysconfig/nginx /etc/sysconfig/nginx.backup
    • Si le fichier n'existe pas, ouvrez un éditeur de texte et créez un fichier nommé nginx dans le dossier /etc/sysconfig/.

  11. Configurez l'environnement NGINX.

    Amazon Linux 2023

    En tant qu'utilisateur root de Linux, ouvrez /etc/sysconfig/nginx le fichier dans un éditeur de texte. Par exemple,

    vi /etc/sysconfig/nginx

    Ajoutez les informations d'identification de l'utilisateur de cryptographie (CU) et le chemin d'accès à votre fichier de configuration OpenSSL :

    CLOUDHSM_PIN=<CU user name>:<password> OPENSSL_CONF=<path to example-cloudhsm-openssl.cnf>

    Remplacez <CU user name> et <password> par les informations d'identification CU. <path to example-cloudhsm-openssl.cnf>Remplacez-le par le chemin complet du fichier de configuration dans lequel vous l'avez crééPour configurer NGINX pour le fournisseur OpenSSL.

    Enregistrez le fichier.

    RHEL 9 (9.2+)

    Ouvrez le fichier /etc/sysconfig/nginx dans un éditeur de texte. Cela peut nécessiter des autorisations root pour Linux. Ajoutez les informations d'identification de l'utilisateur de cryptographie (CU) et le chemin d'accès à votre fichier de configuration OpenSSL :

    CLOUDHSM_PIN=<CU user name>:<password> OPENSSL_CONF=<path to example-cloudhsm-openssl.cnf>

    Remplacez <CU user name> et <password> par les informations d'identification CU. <path to example-cloudhsm-openssl.cnf>Remplacez-le par le chemin complet du fichier de configuration dans lequel vous l'avez crééPour configurer NGINX pour le fournisseur OpenSSL.

    Enregistrez le fichier.

    RHEL 10 (10.0+)

    Ouvrez le fichier /etc/sysconfig/nginx dans un éditeur de texte. Cela peut nécessiter des autorisations root pour Linux. Ajoutez les informations d'identification de l'utilisateur de cryptographie (CU) et le chemin d'accès à votre fichier de configuration OpenSSL :

    CLOUDHSM_PIN=<CU user name>:<password> OPENSSL_CONF=<path to example-cloudhsm-openssl.cnf>

    Remplacez <CU user name> et <password> par les informations d'identification CU. <path to example-cloudhsm-openssl.cnf>Remplacez-le par le chemin complet du fichier de configuration dans lequel vous l'avez crééPour configurer NGINX pour le fournisseur OpenSSL.

    Enregistrez le fichier.

    Ubuntu 24.04

    Ouvrez le fichier /etc/sysconfig/nginx dans un éditeur de texte. Cela peut nécessiter des autorisations root pour Linux. Ajoutez les informations d'identification de l'utilisateur de cryptographie (CU) et le chemin d'accès à votre fichier de configuration OpenSSL :

    CLOUDHSM_PIN=<CU user name>:<password> OPENSSL_CONF=<path to example-cloudhsm-openssl.cnf>

    Remplacez <CU user name> et <password> par les informations d'identification CU. <path to example-cloudhsm-openssl.cnf>Remplacez-le par le chemin complet du fichier de configuration dans lequel vous l'avez crééPour configurer NGINX pour le fournisseur OpenSSL.

    Enregistrez le fichier.

  12. Démarrez le serveur web NGINX.

    Amazon Linux 2023

    Arrêtez tous les processus NGINX

    $ systemctl stop nginx

    Rechargez la configuration systemd pour récupérer les dernières modifications

    $ systemctl daemon-reload

    Démarrez NGINX

    $ systemctl start nginx
    RHEL 9 (9.2+)

    Arrêtez tout processus NGINX en cours d'exécution

    $ systemctl stop nginx

    Rechargez la configuration systemd pour récupérer les dernières modifications

    $ systemctl daemon-reload

    Démarrez le processus NGINX

    $ systemctl start nginx
    RHEL 10 (10.0+)

    Arrêtez tout processus NGINX en cours d'exécution

    $ systemctl stop nginx

    Rechargez la configuration systemd pour récupérer les dernières modifications

    $ systemctl daemon-reload

    Démarrez le processus NGINX

    $ systemctl start nginx
    Ubuntu 24.04

    Arrêtez tout processus NGINX en cours d'exécution

    $ systemctl stop nginx

    Rechargez la configuration systemd pour récupérer les dernières modifications

    $ systemctl daemon-reload

    Démarrez le processus NGINX

    $ systemctl start nginx

Après avoir configuré NGINX, accédez à. Vérification que le protocole HTTPS utilise le certificat que vous avez configuré

Configuration du serveur HAProxy Web

Utilisez cette section pour configurer HAProxy avec le fournisseur OpenSSL. Les exemples suivants montrent comment procéder à la configuration à l' HAProxy aide de vos certificats et clés CloudHSM.

Pour configurer HAProxy pour le fournisseur OpenSSL
  1. Sauvegardez le fichier de certificat combiné existant s'il existe :

    $ cp server-combined.pem server-combined.pem.backup
  2. Créez un fichier de certificat combiné pour HAProxy utiliser votre certificat et la fausse clé PEM CloudHSM :

    $ cat server.crt server.key > server-combined.pem
  3. Sauvegardez la HAProxy configuration existante :

    $ cp /etc/haproxy/haproxy.cfg /etc/haproxy/haproxy.cfg.backup
  4. Créez une nouvelle configuration de déchargement TLS CloudHSM à l'adresse suivante : /etc/haproxy/haproxy.cfg

    global daemon ssl-provider cloudhsm # It is *strongly* recommended to generate unique DH parameters # Generate them with: openssl dhparam -out /etc/haproxy/dhparams.pem 2048 # ssl-dh-param-file /etc/haproxy/dhparams.pem ssl-default-bind-ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305 ssl-default-bind-ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256 ssl-default-bind-options ssl-min-ver TLSv1.2 no-tls-tickets defaults mode http timeout connect 5000ms timeout client 50000ms timeout server 50000ms frontend haproxy_frontend bind *:443 ssl crt /path/to/server-combined.pem default_backend web_servers backend web_servers server web1 127.0.0.1:8080 check

    Mettez à jour le chemin du certificat pour qu'il corresponde à l'emplacement de votre fichier.

  5. Configurez systemd pour utiliser un fichier d'environnement pour HAProxy. L'emplacement dépend de votre distribution Linux.

    Amazon Linux and RHEL

    Sauvegardez et modifiez le fichier HAProxy de service :

    $ cp /lib/systemd/system/haproxy.service /lib/systemd/system/haproxy.service.backup

    Modifiez /lib/systemd/system/haproxy.service et ajoutez la ligne suivante dans la section [Service] :

    EnvironmentFile=/etc/sysconfig/haproxy
    Ubuntu

    Sauvegardez et modifiez le fichier HAProxy de service :

    $ cp /lib/systemd/system/haproxy.service /lib/systemd/system/haproxy.service.backup

    Modifiez /lib/systemd/system/haproxy.service et ajoutez la ligne suivante dans la section [Service] :

    EnvironmentFile=/etc/default/haproxy
  6. Créez le fichier d'environnement à l'emplacement approprié pour votre système.

    Amazon Linux and RHEL

    Sauvegardez le fichier d' HAProxy environnement s'il existe :

    $ cp /etc/sysconfig/haproxy /etc/sysconfig/haproxy.backup

    Créez le fichier d' HAProxy environnement /etc/sysconfig/haproxy avec le contenu suivant :

    CLOUDHSM_PIN=<CU user name>:<password>
    Ubuntu

    Sauvegardez le fichier d' HAProxy environnement s'il existe :

    $ cp /etc/default/haproxy /etc/default/haproxy.backup

    Créez le fichier d' HAProxy environnement /etc/default/haproxy avec le contenu suivant :

    CLOUDHSM_PIN=<CU user name>:<password>

    Remplacez <CU user name> et <password> par vos informations d'identification CU.

  7. Rechargez la configuration de Systemd :

    $ systemctl daemon-reload
  8. HAProxy Commencez par la configuration de déchargement TLS de CloudHSM :

    $ systemctl start haproxy

    Vous pouvez également exécuter HAProxy directement avec un fichier de configuration personnalisé :

    $ haproxy -f /path/to/haproxy-cloudhsm.cfg

Après avoir configuré HAProxy, accédez àVérification que le protocole HTTPS utilise le certificat que vous avez configuré.

Étape 4 : Activer le trafic HTTPS et vérifier le certificat

Après avoir configuré votre serveur Web pour le SSL/TLS déchargement AWS CloudHSM, ajoutez votre instance de serveur Web à un groupe de sécurité qui autorise le trafic HTTPS entrant. Cela permet aux clients, tels que les navigateurs Web, d'établir une connexion HTTPS avec votre serveur Web. Établissez ensuite une connexion HTTPS avec votre serveur Web et vérifiez qu'il utilise le certificat que vous avez configuré pour le SSL/TLS déchargement. AWS CloudHSM

Activation des connexions HTTPS entrantes

Pour vous connecter à votre serveur web à partir d'un client (par exemple, un navigateur web), créez un groupe de sécurité qui autorise les connexions HTTPS entrantes. En particulier, il doit autoriser les connexions TCP entrantes sur le port 443. Affectez ce groupe de sécurité à votre serveur web.

Pour créer un groupe de sécurité pour le protocole HTTPS et l'affecter à votre serveur web
  1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/.

  2. Choisissez Groupes de sécurité dans le panneau de navigation.

  3. Sélectionnez Create security group (Créer un groupe de sécurité).

  4. Pour Créer un groupe de sécurité, procédez comme suit :

    1. Pour Nom du groupe de sécurité, tapez un nom pour le groupe de sécurité que vous créez.

    2. (Facultatif) Tapez une description du groupe de sécurité que vous créez.

    3. Pour le VPC, choisissez le VPC qui contient l'instance Amazon de votre serveur Web. EC2

    4. Sélectionnez Ajouter une règle.

    5. Pour Type, sélectionnez HTTPS dans la fenêtre déroulante.

    6. Pour Source, entrez l'emplacement de la source.

    7. Sélectionnez Create security group (Créer un groupe de sécurité).

  5. Dans le panneau de navigation, choisissez Instances.

  6. Cochez la case située en regard de votre instance de serveur web.

  7. Choisissez le menu déroulant Actions en haut de la page. Sélectionnez Sécurité, puis Modifier les groupes de sécurité.

  8. Pour Groupes de sécurité associés, veuillez consulter la zone de recherche, puis choisissez le groupe de sécurité que vous avez créé pour HTTPS. Ensuite, choisissez Ajouter des groupes de sécurité.

  9. Cliquez sur Enregistrer.

Vérification que le protocole HTTPS utilise le certificat que vous avez configuré

Après avoir ajouté le serveur Web à un groupe de sécurité, vous pouvez vérifier que le SSL/TLS déchargement utilise votre certificat auto-signé. Vous pouvez faire cela à l'aide d'un navigateur web ou avec un outil tel qu'OpenSSL s_client.

Pour vérifier le SSL/TLS déchargement à l'aide d'un navigateur Web
  1. Utilisez un navigateur web pour vous connecter à votre serveur web à l'aide du nom DNS public ou de l'adresse IP du serveur. Assurez-vous que l'URL dans la barre d'adresse commence par https://. Par exemple, https://ec2-52-14-212-67.us-east-2.compute.amazonaws.com/.

    Astuce

    Vous pouvez utiliser un service DNS tel qu'Amazon Route 53 pour acheminer le nom de domaine de votre site Web (par exemple, https://www.example.com/) vers votre serveur Web. Pour plus d'informations, consultez la section Router le trafic vers une EC2 instance Amazon dans le guide du développeur Amazon Route 53 ou dans la documentation de votre service DNS.

  2. Utilisez votre navigateur web pour afficher le certificat de serveur web. Pour plus d’informations, consultez les ressources suivantes :

    D'autres navigateurs web peuvent avoir des fonctions similaires que vous pouvez utiliser pour afficher le certificat de serveur web.

  3. Assurez-vous que le SSL/TLS certificat est celui que vous avez configuré pour utiliser sur votre serveur Web.

Pour vérifier le SSL/TLS déchargement avec OpenSSL s_client
  1. Exécutez la commande OpenSSL suivante pour vous connecter à votre serveur web en utilisant le protocole HTTPS. <server name>Remplacez-le par le nom DNS public ou l'adresse IP de votre serveur Web.

    openssl s_client -connect <server name>:443
    Astuce

    Vous pouvez utiliser un service DNS tel qu'Amazon Route 53 pour acheminer le nom de domaine de votre site Web (par exemple, https://www.example.com/) vers votre serveur Web. Pour plus d'informations, consultez la section Router le trafic vers une EC2 instance Amazon dans le guide du développeur Amazon Route 53 ou dans la documentation de votre service DNS.

  2. Assurez-vous que le SSL/TLS certificat est celui que vous avez configuré pour utiliser sur votre serveur Web.

Vous disposez maintenant d'un site web sécurisé avec HTTPS. La clé privée du serveur Web est stockée dans un HSM de votre AWS CloudHSM cluster.

Pour ajouter un équilibreur de charge, veuillez consulter Ajoutez un équilibreur de charge avec Elastic Load Balancing pour AWS CloudHSM(facultatif).