Codeunit 1465 EncryptedXml

System Application, System.Security.Encryption

src/System Application/App/Cryptography Management/src/Xml/EncryptedXml.Codeunit.al71 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Security.Encryption;/// <summary>/// Provides functionality for encrypting and decrypting XML documents./// </summary>codeunit 1465 EncryptedXml{    Access = Public;    InherentEntitlements = X;    InherentPermissions = X;    var        EncryptedXmlImpl: Codeunit "EncryptedXml Impl.";    /// <summary>    /// Creates a symmetric session key to encrypt the outer XML of an element using the specified X.509 certificate.    /// </summary>    /// <param name="XmlDocument">The XmlDocument to encrypt.</param>    /// <param name="ElementToEncrypt">The name of the element to encrypt.</param>    /// <param name="X509CertBase64Value">The X509Certificate2 to use for the asymmetric encryption.</param>    /// <param name="X509CertPassword">Password to the X509Certificate2.</param>    procedure Encrypt(var XmlDocument: XmlDocument; ElementToEncrypt: Text; X509CertBase64Value: Text; X509CertPassword: SecretText)    begin        EncryptedXmlImpl.Encrypt(XmlDocument, ElementToEncrypt, X509CertBase64Value, X509CertPassword);    end;    /// <summary>    /// Creates a symmetric session key using the specified SymmetricAlgorithm    /// to encrypt the outer XML of an element using the specified X.509 certificate.    /// </summary>    /// <param name="XmlDocument">The XmlDocument to encrypt.</param>    /// <param name="ElementToEncrypt">The name of the element to encrypt.</param>    /// <param name="X509CertBase64Value">The X509Certificate2 to use for the asymmetric encryption.</param>    /// <param name="X509CertPassword">Password to the X509Certificate2.</param>    /// <param name="SymmetricAlgorithm">The symmetric algorithm to be used when encrypting.</param>    procedure Encrypt(var XmlDocument: XmlDocument; ElementToEncrypt: Text; X509CertBase64Value: Text; X509CertPassword: SecretText; SymmetricAlgorithm: Enum SymmetricAlgorithm)    begin        EncryptedXmlImpl.Encrypt(XmlDocument, ElementToEncrypt, X509CertBase64Value, X509CertPassword, SymmetricAlgorithm);    end;    /// <summary>    /// Decrypts all EncryptedData elements of the XML document using the specified asymmetric key.    /// </summary>    /// <param name="EncryptedDocument">The XML document to decrypt.</param>    /// <param name="EncryptionKey">The asymmetric key to use to decrypt the symmetric keys in the document.</param>    /// <param name="SignatureAlgorithm">The asymmetric algorithm used to decrypt the symmetric key.</param>    /// <returns>Returns true if decryption was successful, otherwise false.</returns>    procedure DecryptDocument(var EncryptedDocument: XmlDocument; EncryptionKey: SecretText; SignatureAlgorithm: Enum SignatureAlgorithm): Boolean    begin        exit(EncryptedXmlImpl.DecryptDocument(EncryptedDocument, EncryptionKey, SignatureAlgorithm));    end;    /// <summary>    /// Decrypts an EncryptedKey XML element using an asymmetric algorithm.    /// </summary>    /// <param name="EncryptedKey">The EncryptedKey XML element with the key to be decrypted.</param>    /// <param name="EncryptionKey">The asymmetric key used to decrypt the symmetric key.</param>    /// <param name="UseOAEP">A value that specifies whether to use Optimal Asymmetric Encryption Padding (OAEP).</param>    /// <param name="KeyBase64Value">The Base64 encoded decrypted key value.</param>    /// <param name="SignatureAlgorithm">The asymmetric algorithm used to decrypt the symmetric key.</param>    /// <returns>Returns true if decryption was successful, otherwise false.</returns>    procedure DecryptKey(EncryptedKey: XmlElement; EncryptionKey: SecretText; UseOAEP: Boolean; var KeyBase64Value: Text; SignatureAlgorithm: Enum SignatureAlgorithm): Boolean    begin        exit(EncryptedXmlImpl.DecryptKey(EncryptedKey, EncryptionKey, UseOAEP, KeyBase64Value, SignatureAlgorithm));    end;}