Configurer Key Access Justifications avec Cloud KMS et Cloud HSM

Cette page explique comment configurer Key Access Justifications avec Cloud KMS ou Cloud HSM pour la limite de données au Japon d'Assured Workloads.

Lorsque vous créez un dossier Assured Workloads pour les régions du Japon, vous avez la possibilité de créer un projet et un trousseau de clés pour vos clés cryptographiques. Les clés Cloud KMS et Cloud HSM peuvent être ajoutées à ce trousseau de clés. Vous pouvez également configurer une règle Key Access Justifications pour contrôler l'accès à chaque clé.

Avant de commencer

  • Vous ne pouvez utiliser Key Access Justifications qu'avec les clés Cloud KMS et Cloud HSM dans les dossiers enregistrés dans la limite de données du Japon dans Assured Workloads.
  • Assurez-vous que votre administrateur vous a attribué l'un des rôles IAM (Identity and Access Management) requis pour créer et gérer vos règles Key Access Justifications, ainsi que les clés Cloud KMS et Cloud HSM.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour créer et gérer des clés Cloud KMS et Cloud HSM, ainsi que leurs règles Key Access Justifications, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Cloud KMS (roles/cloudkms.admin) sur le projet contenant le trousseau de clés. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour créer et gérer des clés Cloud KMS et Cloud HSM, ainsi que leurs règles Key Access Justifications. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer et gérer des clés Cloud KMS et Cloud HSM, ainsi que leurs règles Key Access Justifications :

  • cloudkms.cryptoKeys.create
  • cloudkms.cryptoKeys.update
  • cloudkms.cryptoKeys.get

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer une clé avec Key Access Justifications

Pour configurer Key Access Justifications avec une clé Cloud KMS ou Cloud HSM, vous pouvez inclure la stratégie d'accès aux clés en tant que paramètre lors de la création de la clé, ou mettre à jour la clé avec la stratégie après sa création.

Créer une clé et une règle

Console

  1. Dans la console Google Cloud , accédez à la page Gestion des clés.

    Accéder à la page "Gestion des clés"

  2. Cliquez sur le nom du trousseau de clés dans lequel vous souhaitez créer la clé.

  3. Cliquez sur Créer une clé.

  4. Dans le champ Nom de la clé, saisissez un nom pour votre clé.

  5. Niveau de protection : sélectionnez Logiciel ou HSM.

  6. Continuez à sélectionner les paramètres selon vos besoins.

  7. Sous Paramètres supplémentaires > Stratégie de Key Access Justifications clés, sélectionnez Définir une stratégie personnalisée, puis Autoriser des codes de motif spécifiques.

  8. Pour Motifs de justification, sélectionnez Accès initié par le client, Opération du système initiée par Google et tout autre code de motif que vous souhaitez autoriser. L'accès initié par le client et l'opération du système initiée par Google sont essentiels au fonctionnement normal.

  9. Cliquez sur Créer.

REST

Créez une clé et une stratégie à l'aide de la méthode cryptoKeys.create :

POST https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys?crypto_key_id=KEY_NAME

Dans la requête, remplacez les valeurs d'espace réservé suivantes :

  • PROJECT_ID : ID du projet contenant le trousseau de clés auquel vous souhaitez ajouter une clé (par exemple, 919698201234).
  • LOCATION : emplacement du trousseau de clés, par exemple asia-northeast1.
  • KEY_RING : nom du trousseau de clés que vous avez spécifié lorsque vous avez créé le projet de gestion des clés et le trousseau de clés de votre dossier Assured Workloads.
  • KEY_NAME : nom de la clé HSM que vous souhaitez créer, par exemple my-hsm-key.

Corps de la requête :

{
  "purpose": "PURPOSE",
  "versionTemplate": {
    "protectionLevel": "PROTECTION_LEVEL",
    "algorithm": "ALGORITHM"
  },
  "keyAccessJustificationsPolicy": {
    "allowedAccessReasons": [
      ALLOWED_ACCESS_REASONS
    ]
  }
}

Dans le corps de la requête, remplacez les valeurs d'espace réservé suivantes :

  • PURPOSE : objectif de la clé. Pour obtenir la liste des différentes fonctions de clé, consultez Fonctions de clé (par exemple, ENCRYPT_DECRYPT).
  • PROTECTION_LEVEL : niveau de protection de la clé (par exemple, SOFTWARE ou HSM).
  • ALGORITHM : algorithme cryptographique à utiliser. Pour obtenir la liste des algorithmes disponibles, consultez Algorithmes Cloud KMS (par exemple, GOOGLE_SYMMETRIC_ENCRYPTION).
  • ALLOWED_ACCESS_REASONS : stratégie Key Access Justifications qui définit zéro ou plusieurs codes de justification autorisés pour accéder à la clé de chiffrement (par exemple, ["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"]).

L'exemple de requête et de corps de requête suivant crée une clé Cloud HSM qui n'autorise les justifications d'accès que pour quelques raisons :

POST https://cloudkms.googleapis.com/v1/projects/919698201234/locations/asia-northeast1/keyRings/my-key-ring/cryptoKeys?crypto_key_id=my-hsm-key
{
  "purpose": "ENCRYPT_DECRYPT",
  "versionTemplate": {
    "protectionLevel": "HSM",
    "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION"
  },
  "keyAccessJustificationsPolicy": {
    "allowedAccessReasons": [
      "CUSTOMER_INITIATED_ACCESS",
      "GOOGLE_INITIATED_SYSTEM_OPERATION"
    ]
  }
}

Mettre à jour la stratégie d'une clé existante

Console

  1. Dans la console Google Cloud , accédez à la page Gestion des clés.

    Accéder à la page "Gestion des clés"

  2. Cliquez sur le nom du trousseau de clés dans lequel vous avez créé la clé.

  3. Cliquez sur le nom de la clé pour laquelle vous souhaitez mettre à jour la stratégie Key Access Justifications.

  4. Cliquez sur Modifier la stratégie Key Access Justifications.

  5. Effectuez l'une des opérations suivantes :

    • Pour désactiver la stratégie Key Access Justifications sur la clé, décochez la case Définir la stratégie Key Access Justifications.

    • Pour modifier les motifs de justification autorisés, cliquez sur le champ Motifs de justification, puis sélectionnez ou désélectionnez les codes de motif selon vos besoins. L'accès initié par le client et l'opération du système initiée par Google sont tous deux essentiels au fonctionnement normal.

    • Pour refuser tous les codes de motif, sélectionnez Refuser tous les codes de motif (non recommandé). Cela empêche l'utilisation de la clé, même si elle est activée et que le demandeur dispose des autorisations requises.

  6. Cliquez sur Enregistrer.

REST

Mettez à jour une clé existante dans Cloud KMS à l'aide de la méthode cryptoKeys.patch :

PATCH https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME?update_mask=keyAccessJustificationsPolicy

Dans la requête, remplacez les valeurs d'espace réservé suivantes :

  • PROJECT_ID : ID du projet contenant le trousseau de clés de la clé (par exemple, 919698201234).
  • LOCATION : emplacement du trousseau de clés, par exemple asia-northeast1.
  • KEY_RING : nom du trousseau de clés que vous avez spécifié lors de la création du projet de gestion des clés et du trousseau de clés de votre dossier Assured Workloads.
  • KEY_NAME : nom de la clé que vous souhaitez mettre à jour.

Corps de la requête :

{
  "purpose": "PURPOSE",
  "versionTemplate": {
    "protectionLevel": "PROTECTION_LEVEL",
    "algorithm": "ALGORITHM"
  },
  "keyAccessJustificationsPolicy": {
    "allowedAccessReasons": [
      ALLOWED_ACCESS_REASONS
    ]
  }
}

Dans le corps de la requête, remplacez les valeurs d'espace réservé suivantes :

  • PURPOSE : objectif de la clé. Pour obtenir la liste des différentes fonctions de clé, consultez Fonctions de clé (par exemple, ENCRYPT_DECRYPT).
  • PROTECTION_LEVEL : niveau de protection de la clé (par exemple, SOFTWARE ou HSM).
  • ALGORITHM : algorithme cryptographique à utiliser. Pour obtenir la liste des algorithmes disponibles, consultez Algorithmes Cloud KMS (par exemple, GOOGLE_SYMMETRIC_ENCRYPTION).
  • ALLOWED_ACCESS_REASONS : stratégie Key Access Justifications qui définit zéro ou plusieurs codes de justification autorisés pour accéder à la clé de chiffrement (par exemple, ["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"]).

L'exemple de requête et de corps de requête suivant n'autorise les justifications d'accès que pour quelques raisons :

PATCH https://cloudkms.googleapis.com/v1/projects/919698201234/locations/asia-northeast1/keyRings/my-key-ring/cryptoKeys/my-hsm-key?keyAccessJustificationsPolicy
{
  "purpose": "ENCRYPT_DECRYPT",
  "versionTemplate": {
    "protectionLevel": "HSM",
    "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION"
  },
  "keyAccessJustificationsPolicy": {
    "allowedAccessReasons": [
      "CUSTOMER_INITIATED_ACCESS",
      "GOOGLE_INITIATED_SYSTEM_OPERATION"
    ]
  }
}

Obtenir la stratégie Key Access Justifications pour une clé

REST

Obtenez les métadonnées d'une clé existante dans Cloud KMS à l'aide de la méthode cryptoKeys.get :

GET https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME

Dans les paramètres de requête, remplacez les valeurs d'espace réservé suivantes par les vôtres :

  • PROJECT_ID : ID du projet contenant le trousseau de clés de la clé, par exemple 919698201234.
  • LOCATION : emplacement du trousseau de clés, par exemple asia-northeast1.
  • KEY_RING : nom du trousseau de clés que vous avez spécifié lors de la création du projet de gestion des clés et du trousseau de clés de votre dossier Assured Workloads (par exemple, my-key-ring).
  • KEY_NAME : nom de la clé que vous souhaitez obtenir.

L'exemple de requête suivant récupère les métadonnées d'une clé dans Cloud KMS :

GET https://cloudkms.googleapis.com/v1/projects/919698201234/locations/asia-northeast1/keyRings/my-key-ring/cryptoKeys/my-hsm-key

Le corps de la réponse contient des métadonnées sur votre clé, y compris le keyAccessJustificationsPolicy. Exemple :

{
  "purpose": "ENCRYPT_DECRYPT",
  "versionTemplate": {
    "protectionLevel": "HSM",
    "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION"
  },
  "keyAccessJustificationsPolicy": {
    "allowedAccessReasons": [
      "CUSTOMER_INITIATED_ACCESS",
      "GOOGLE_INITIATED_SYSTEM_OPERATION"
    ]
  }
}

Étapes suivantes