Tâche Cloud KMS – Déchiffrement

Annonce : Application Integration est désormais disponible pour votre projet Google Cloud. Vous pouvez désormais utiliser Apigee Integration et Application Integration dans le même projet Google Cloud. En savoir plus

La tâche Cloud KMS – Déchiffrement vous permet de déchiffrer du texte ou des données chiffrés à l'aide d'une clé Cloud Key Management Service (Cloud KMS). Pour déchiffrer les données chiffrées, vous devez utiliser la même clé que celle utilisée lors du chiffrement. Le texte déchiffré qui est renvoyé par Cloud KMS est encodé en base64.

Cloud KMS est un service Google Cloud qui vous permet de créer, d'importer et de gérer des clés cryptographiques et d'effectuer des opérations cryptographiques dans un seul service cloud centralisé.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Cloud KMS – Déchiffrement :

1. Activez l'API Cloud Key Management Service (KMS) (cloudkms.googleapis.com).

   Activer l'API Cloud Key Management Service (KMS)

2. Créez un profil d'authentification. Apigee Integration utilise un profil d'authentification pour se connecter à un point de terminaison d'authentification pour la tâche Cloud KMS – Déchiffrement.
   Remarque : Si vous créez un profil d'authentification de type Compte de service, assurez-vous ensuite d'attribuer au compte de service le rôle IAM contenant la ou les autorisation(s) IAM suivante(s) :

   • cloudkms.cryptoKeyVersions.useToDecrypt

   Pour connaître les autorisations IAM et les rôles IAM prédéfinis qui les octroient, consultez la documentation de référence sur les autorisations IAM.

   Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la section Attribuer, modifier et révoquer les accès.

Configurer la tâche Cloud KMS – déchiffrement

1. Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
2. Cliquez sur Développer > Intégrations.
3. Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.

   Si vous créez une intégration :

   1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
   2. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
   3. Cliquez sur Créer.

   La page de conception d'intégration s'affiche.

4. Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
5. Cliquez sur l'élément Cloud KMS – Déchiffrement et placez-le dans le concepteur d'intégration.
6. Cliquez sur l'élément Cloud KMS – Déchiffrement dans le concepteur pour afficher le volet de configuration de la tâche Cloud KMS – Déchiffrement.
7. Accédez à Authentification, puis sélectionnez un profil d'authentification existant que vous souhaitez utiliser.

   Facultatif. Si vous n'avez pas créé de profil d'authentification avant de configurer la tâche, cliquez sur + Nouveau profil d'authentification et suivez les étapes mentionnées dans la section Créer un profil d'authentification.

8. Accédez à l'Entrée de la tâche et configurez les champs d'entrée affichés à l'aide du tableau Paramètres d'entrée de la tâche suivant.

   Les modifications apportées aux champs d'entrée sont enregistrées automatiquement.

Paramètres d'entrée de la tâche

Le tableau suivant décrit les paramètres d'entrée de la tâche Cloud KMS – Déchiffrement :

Propriété	Type de données	Description
Région	Chaîne	Emplacement Cloud KMS du trousseau de clés
ProjectsId	Chaîne	L'ID de votre projet Google Cloud.
KeyRingsId	Chaîne	Nom du trousseau de clés où sera située la clé.
CryptoKeysId	String	Nom de la clé à utiliser pour le déchiffrement.
Demande	JSON	Consultez la section Structure JSON de requête. Spécifiez le texte chiffré (cipher) à déchiffrer dans le champ ciphertext du corps de la requête.

Résultat de la tâche

La tâche Cloud KMS – Déchiffrement renvoie une réponse contenant les données chiffrées dans un format encodé en base64. Vous devez décoder la valeur encodée en base64 pour obtenir la chaîne de sortie.

Conseil : Vous pouvez encoder ou décoder des données en base64 à l'aide de la commande base64 sous Linux ou macOS, ou de la commande Base64.exe sous Windows. Les langages de programmation et de script incluent généralement des bibliothèques pour le codage en base64. Pour obtenir des exemples de ligne de commande, consultez l'article Décoder les contenus encodés en base64 dans la documentation de Cloud Text-to-Speech.

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.

Étapes suivantes

1. Ajoutez des arêtes et conditions d'arêtes.
2. Testez et publiez votre intégration.
3. Configurez un déclencheur.
4. Ajoutez une tâche de mappage de données.
5. Consultez toutes les tâches des services Google Cloud.