Attestation

Le site IBM Cloud Hyper Protect Virtual Servers pour VPC est obsolète. À partir du 28 février 2026, vous ne pourrez plus créer de nouvelles instances. Les instances existantes seront prises en charge jusqu’au 20 février 2027. Toutes les instances qui existeront encore à cette date seront supprimées. Vous pouvez redéployer vos charges de travail en utilisant IBM Confidential Computing Container Runtime(anciennement connu sous le nom de Hyper Protect Virtual Servers ) ou IBM Confidential Computing Container Runtime for Red Hat Virtualization Solutions(anciennement connu sous le nom de Hyper Protect Container Runtime for Red Hat Virtualization Solutions). Pour plus d'informations sur la migration des données, voir le guide Migration. Pour plus d'informations, voir l'annonce de dépréciation du service.

L'attestation est un processus qui démarre par défaut lors de la création d'une instance virtuelle. Il garantit que l'image de l'instance du serveur virtuel a bien été créée par IBM et qu'elle n'a pas été modifiée. Ce processus fournit également des informations et permet la validation des données fournies à l'instance au moment du déploiement.

Lorsque vous créez une instance de serveur virtuel à l'aide de l'image IBM Hyper Protect Container Runtime, l'image utilise un système de fichiers initial qui est protégé par le chiffrement et signé par IBM Secure Execution. Pour plus d'informations, voir Informatique confidentielle avec LinuxONE. Pour en savoir plus sur le processus d'attestation, voir cette vidéo.

Le processus d'amorçage crée une clé de chiffrement de disque racine unique pour garantir la protection du disque racine. Pour effectuer l'attestation, l'image de l'instance de serveur virtuel contient une clé d'attestation-signature et le hachage de la partition racine lors de la génération. Le processus d'amorçage valide la partition racine. Si le hachage de la partition racine ne correspond pas, le processus d'amorçage ne se poursuit pas car il suppose que l'image a été modifiée avant l'amorçage. La clé de signature d'attestation est une clé RSA 4 K aléatoire signée par une clé racine IBM qui est gérée dans Hyper Protect Crypto Services. La clé racine IBM est signée par Digicert.

Lors du déploiement de l'instance de serveur virtuel dans le cloud, un enregistrement d'attestation est créé. Il contient des hachages des éléments suivants:

• L'image de base d'origine
• La partition racine au moment du premier amorçage
• Partition racine au moment de la génération
• Options d'initialisation du cloud

L'enregistrement d'attestation est signé par la clé d'attestation. En tant que couche de protection supplémentaire, vous pouvez fournir une clé publique lors du déploiement, par rapport à laquelle l'enregistrement d'attestation est chiffré. Le hachage de cette clé publique est ajouté à l'enregistrement d'attestation afin que celui-ci ne puisse être consulté que par l'autorité de conformité. L'autorité attendue peut être facilement identifiée grâce à ce hachage.

Avant de télécharger une charge de travail dans votre instance, vous devez valider l'enregistrement d'attestation. Une fois qu'une instance a été créée, vous pouvez valider l'enregistrement d'attestation dans l'instance créée. Votre instance doit avoir accès au répertoire /var/hyperprotect. Si tel est le cas, procédez comme suit:

• L'enregistrement d'attestation est signé par la clé de signature d'attestation.
• La clé de signature d'attestation peut être confirmée par le certificat intermédiaire IBM. LeIBM le certificat intermédiaire est signé parDigiCert, ce qui est prouvé par le certificat racine deDigiCert, complétant ainsi la chaîne de confiance.

Les certificats de chiffrement et d'attestation sont signés par le certificat intermédiaire IBM, qui est signé par le certificat intermédiaire Digicert IBM. Le certificat intermédiaire Digicert IBM est signé par la racine de confiance DigiCert G4. Pour plus d'informations sur les certificats, voir DigiCert Trusted Root Authority Certificates.

Utilisez la procédure suivante pour valider l'enregistrement d'attestation et les hachages:

• Obtenez l'enregistrement d'attestation se-checksums.txt et le fichier de signature se-signature.bin de votre instance Hyper Protect Virtual Servers for VPC. Pour ce faire, vous pouvez implémenter votre conteneur pour fournir l'enregistrement d'attestation et le fichier de signature. L'enregistrement d'attestation et le fichier de signature sont mis à la disposition de votre conteneur dans le répertoire /var/hyperprotect.
• Obtenez le certificat d'attestation IBM. Le tableau suivant répertorie les dates d'expiration des certificats d'attestation en fonction de la version de l'image.

A partir du 25 mars 2025, les liens du certificat sont modifiés.

• Validez le certificat d'attestation en suivant les instructions ici.

• Extraire la clé publique d'attestation du certificat d'attestation à l'aide de la commande suivante :

  openssl x509 -pubkey -noout -in ibm-hyper-protect-container-runtime-1-0-s390x-29-attestation.crt > contract-public-key.pub
  

• Vérifiez la signature de l'enregistrement d'attestation:

  openssl sha256 -verify contract-public-key.pub -signature se-signature.bin se-checksums.txt
  

  La vérification de signature doit être effectuée sur un fichier d'attestation déchiffré.

• Vous pouvez maintenant utiliser les hachages de l'enregistrement d'attestation pour la validation.

Si vous avez fourni une clé publique pour le chiffrement de l'enregistrement d'attestation, le script suivant peut vous aider à déchiffrer l'enregistrement.

  #!/bin/bash
  #
  # Example script to decrypt attestation document.
  #
  # Usage:
  #   ./decrypt-attestation.sh <rsa-priv-key.pem> [file]
  #
  # Token Format:
  #   hyper-protect-basic.<ENC_AES_KEY_BASE64>.<ENC_MESSAGE_BASE64>
  RSA_PRIV_KEY="$1"
  if [ -z "$RSA_PRIV_KEY" ]; then
      echo "Usage: $0 <rsa-priv-key.pem>"
      exit 1
  fi
  INPUT_FILE="${2:-se-checksums.txt.enc}"
  TMP_DIR="$(mktemp -d)"
  #trap 'rm -r $TMP_DIR' EXIT
  PASSWORD_ENC="${TMP_DIR}/password_enc"
  MESSAGE_ENC="${TMP_DIR}/message_enc"
  # extract encrypted AES key and encrypted message
  cut -d. -f 2 "$INPUT_FILE"| base64 -d > "$PASSWORD_ENC"
  cut -d. -f 3 "$INPUT_FILE"| base64 -d > "$MESSAGE_ENC"
  # decrypt password
  PASSWORD=$(openssl pkeyutl -decrypt -inkey "$RSA_PRIV_KEY" -in "$PASSWORD_ENC")
  # decrypt message
  echo -n "$PASSWORD" | openssl aes-256-cbc -d -pbkdf2 -in "$MESSAGE_ENC" -pass stdin --out se-checksums.txt

Dans le cas d'un conteneur Docker, le fichier decrypt-attestation.sh est accessible en montant /var/hyperprotect dans le conteneur Docker. Par exemple :

 volumes:
      - "/var/hyperprotect/:/var/hyperprotect/:ro"

Dans le cas d'un conteneur Podman, le fichier decrypt-attestation.sh est accessible en montant /var/hyperprotect dans le conteneur Podman. Par exemple :

 volumeMounts:
     - name: attestation
       readOnly: true
       mountPath: /var/hyperprotect:Z,U

​/var/hyperprotect
/var/hyperprotect/
|-- certificate_expiry_date.json 
|-- cidata
|   |-- meta-data
|   |-- vendor-data
|-- se-checksums.txt
|-- se-signature.bin
|-- se-version
|-- user-data.decrypted

sha256sum <file>

26.7.1
Machine Type/Plant/Serial: 8562/02/4C598
Image age: 10 days since creation.
Encryption Certificate valid until: Jul 06 06:44:41 2027 UTC
Attestation Certificate valid until: Jul 06 12:28:59 2027 UTC
5df88e43e3b0819f05c4a2d90253f26fe72308c7102f1cafe60cf2902f26cc06 certificate_expiry_date.json
44d9ccbb009ba581a391ec569f4cce97b365c5ca63c47574c3a3168ddb4115b3 root.tar.gz
87cba102a31c9131a5e04c4d555ef93ff4294aa28faedecb7b94bb726e6a9f4a baseimage
fe40ba8362e570e5caa533b7cbed3cb5f8fa67ed2e7022a678c1c06760821c8f sbom
65b99110547298d3f6fec2888664dcf74fdf53b52e27fa2f9e4e97c274055ac2 /dev/disk/by-label/cidata
f95185cc25937c43d0b912cfcae1934996785f5ecbeed07c1cca3cb8cefd4e0e cidata/meta-data
98a916c28414671a04623ee1a6902dda41777fbb0cd56ebb5ab3c5cb399bc163 cidata/user-data
3bee754bb0c58bb691242b0d1787bc5b1f71d22885d9444b581e4b51adecac0d cidata/vendor-data
6c338061a8a39a9d0d6ca6e8c0ee5b758741b01484abd7403e1481ae75ed1ca1 contract:workload
7f326b4f780652d77e7d2d22631b9da7ec000b97f5363030ed1d7fab4378bb6c contract:env
d879515efa1fb1b94bf00f3e03855539d169c54f4beb4dad3fff91b39467c461 contract:attestationPublicKey

87cba102a31c9131a5e04c4d555ef93ff4294aa28faedecb7b94bb726e6a9f4a baseimage

334549f6dfcf8e0e2132c0eb9a5281e9e0b335e319fe2f66158be5b524acdc48 baseimage

f8614f9f6a39302b97b0a590e14b2e64affddb0f98ef459bf0f8c7f185c98bd5 baseimage

f73df7d02327896fbda67f6e7368c3e27fe5e15b580cdfdb60e7310afeed5b75 baseimage

14d2a725746bf9a6cbf9847e09422f5a97609d03f15b373519a16015619f227d baseimage

3e13f7658ef790dbc040e90ff4f8d537c9c10da879b0b16df9e98265c7b5170a baseimage

538170f79b7bd44553847e81afce7ae14c8ea8857df243e4f8656c9d06d42c18 baseimage

538170f79b7bd44553847e81afce7ae14c8ea8857df243e4f8656c9d06d42c18 baseimage

44d9ccbb009ba581a391ec569f4cce97b365c5ca63c47574c3a3168ddb4115b3 root.tar.gz

692f9724bb6c6fb855d6724c903e080998997b3a8aa2350fd5cb95b1c967ea92 root.tar.gz

f700d860d931d953bffa6a7f2593ec53074a757c0184bcfbea0648de7f2b501b root.tar.gz

3c5866a25d0e64c47e56ba29238b96435c6a81933d4e19bf3bc0704c0504d16b root.tar.gz

a93839d82b98323665740a12ca2b30107bd8488e02eb411a6db6c17703b9b5cf root.tar.gz

84ae048bc5d88e99f6ec13b4c4ba3e2ffe5f10285f7dd71a65ea99eaa1838ce0 root.tar.gz

ff09f53f19d0f82ca24d4f2d5277c851516734c3d55ae7f8db47cde378a51ec9 root.tar.gz

024ff109be23e1e4e7b9f07dc553afc60a5a93645939eedf2a936930cc8a44ae root.tar.gz

f95185cc25937c43d0b912cfcae1934996785f5ecbeed07c1cca3cb8cefd4e0e cidata/meta-data
98a916c28414671a04623ee1a6902dda41777fbb0cd56ebb5ab3c5cb399bc163 cidata/user-data
3bee754bb0c58bb691242b0d1787bc5b1f71d22885d9444b581e4b51adecac0d cidata/vendor-data

d879515efa1fb1b94bf00f3e03855539d169c54f4beb4dad3fff91b39467c461 contract:attestationPublicKey

 volumes:
      - "/var/hyperprotect/:/var/hyperprotect/:ro"

 volumeMounts:
     - name: attestation
       readOnly: true
       mountPath: /var/hyperprotect:Z,U