AWS Encryption SDK pour .NET - AWS Encryption SDK

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 Encryption SDK pour .NET

AWS Encryption SDK for .NET est une bibliothèque de chiffrement côté client destinée aux développeurs qui écrivent des applications en C# et dans d'autres langages de programmation .NET. Elle est prise en charge sur Windows, macOS et Linux.

Note

La version 4.0.0 de AWS Encryption SDK for .NET s'écarte de la spécification du AWS Encryption SDK message. Par conséquent, les messages chiffrés par la version 4.0.0 ne peuvent être déchiffrés que par la version 4.0.0 ou ultérieure pour .NET. AWS Encryption SDK Ils ne peuvent être déchiffrés par aucune autre implémentation de langage de programmation.

La version 4.0.1 de AWS Encryption SDK for .NET écrit des messages conformément à la spécification des AWS Encryption SDK messages et est interopérable avec d'autres implémentations de langages de programmation. Par défaut, la version 4.0.1 peut lire les messages chiffrés par la version 4.0.0. Toutefois, si vous ne souhaitez pas déchiffrer les messages chiffrés par la version 4.0.0, vous pouvez spécifier la NetV4_0_0_RetryPolicypropriété pour empêcher le client de lire ces messages. Pour plus d'informations, consultez les notes de mise à jour de la version 4.0.1 dans le aws-encryption-sdk référentiel sur. GitHub

Le AWS Encryption SDK pour .NET se distingue de certaines des autres implémentations du langage de programmation de la AWS Encryption SDK manière suivante :

Le AWS Encryption SDK pour .NET inclut toutes les fonctionnalités de sécurité introduites dans les versions 2.0. x et versions ultérieures d'autres implémentations linguistiques du AWS Encryption SDK. Toutefois, si vous utilisez le AWS Encryption SDK pour .NET pour déchiffrer des données chiffrées par une version antérieure à la version 2.0. version x, autre implémentation linguistique du AWS Encryption SDK, vous devrez peut-être ajuster votre politique d'engagement. Pour plus de détails, consultez Comment définir votre politique d'engagement.

Le AWS Encryption SDK for .NET est un produit de AWS Encryption SDK in Dafny, un langage de vérification formel dans lequel vous écrivez des spécifications, le code pour les implémenter et les preuves pour les tester. Le résultat est une bibliothèque qui implémente les fonctionnalités du AWS Encryption SDK dans un framework garantissant l'exactitude fonctionnelle.

En savoir plus

  • Pour des exemples montrant comment configurer des options dans le AWS Encryption SDK, telles que la spécification d'une suite d'algorithmes alternative, la limitation des clés de données chiffrées et l'utilisation de clés AWS KMS multirégionales, voirConfiguration du AWS Encryption SDK.

  • Pour plus de détails sur la programmation avec le AWS Encryption SDK pour .NET, consultez le aws-encryption-sdk-netrépertoire du aws-encryption-sdk référentiel sur GitHub.

Installation du AWS Encryption SDK pour .NET

Le AWS Encryption SDK pour .NET est disponible sous forme de AWS.Cryptography.EncryptionSDKpackage dans NuGet. Pour plus de détails sur l'installation et la génération du fichier AWS Encryption SDK pour .NET, consultez le fichier README.md dans le référentiel. aws-encryption-sdk-net

Version 3.x

Version 3. x of the AWS Encryption SDK for .NET prend en charge .NET Framework 4.5.2 à 4.8 uniquement sous Windows. Il prend en charge .NET Core 3.0+, .NET 5.0 et versions ultérieures sur tous les systèmes d'exploitation pris en charge.

Version 4.x

Version 4. x of the AWS Encryption SDK for .NET prend en charge .NET 6.0 et .NET Framework net48 et versions ultérieures.

AWS Encryption SDK Pour .NET, les touches «  AWS SDK for .NET  même si vous n'utilisez pas AWS Key Management Service (AWS KMS) » sont requises. Il est installé avec le NuGet package. Toutefois, sauf si vous utilisez AWS KMS des clés, AWS Encryption SDK car .NET ne nécessite pas d' Compte AWS AWS informations d'identification ou d'interaction avec un AWS service. Pour obtenir de l'aide pour configurer un AWS compte si vous en avez besoin, consultezUtilisation de l'AWS Encryption SDK avec AWS KMS.

Débogage du AWS Encryption SDK pour .NET

Le AWS Encryption SDK for .NET ne génère aucun journal. Les exceptions dans le AWS Encryption SDK fichier for .NET génèrent un message d'exception, mais aucune trace de pile.

Pour vous aider à déboguer, veillez à activer la connexion au AWS SDK for .NET. Les journaux et les messages d'erreur du AWS SDK for .NET peuvent vous aider à distinguer les erreurs survenant dans le fichier .NET AWS SDK for .NET de celles qui se produisent dans le AWS Encryption SDK fichier .NET. Pour obtenir de l'aide AWS SDK for .NET concernant la journalisation, consultez AWSLoggingle guide du AWS SDK for .NET développeur. (Pour consulter le sujet, développez la section Ouvrir pour afficher le contenu du .NET Framework.)