Codeunit 1266 Cryptography Management

System Application, System.Security.Encryption

src/System Application/App/Cryptography Management/src/CryptographyManagement.Codeunit.al415 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 helper functions for encryption and hashing./// For encryption in an on-premises versions, use it to turn encryption on or off, and import and export the encryption key./// Encryption is always turned on for online versions./// </summary>codeunit 1266 "Cryptography Management"{    Access = Public;    InherentEntitlements = X;    InherentPermissions = X;    var        CryptographyManagementImpl: Codeunit "Cryptography Management Impl.";    /// <summary>    /// Returns plain text as an encrypted value.    /// </summary>    /// <param name="InputString">The value to encrypt.</param>    /// <returns>Encrypted value.</returns>    [NonDebuggable]    procedure EncryptText(InputString: Text[215]): Text    begin        exit(CryptographyManagementImpl.Encrypt(InputString));    end;    /// <summary>    /// Returns encrypted text as plain text.    /// </summary>    /// <param name="EncryptedString">The value to decrypt.</param>    /// <returns>Plain text.</returns>    [NonDebuggable]    procedure Decrypt(EncryptedString: Text): Text    begin        exit(CryptographyManagementImpl.Decrypt(EncryptedString));    end;    /// <summary>    /// Checks if Encryption is enabled.    /// </summary>    /// <returns>True if encryption is enabled, false otherwise.</returns>    procedure IsEncryptionEnabled(): Boolean    begin        exit(CryptographyManagementImpl.IsEncryptionEnabled());    end;    /// <summary>    /// Checks whether the encryption key is present, which only works if encryption is enabled.    /// </summary>    /// <returns>True if the encryption key exists, false otherwise.</returns>    procedure IsEncryptionPossible(): Boolean    begin        exit(CryptographyManagementImpl.IsEncryptionPossible());    end;    /// <summary>    /// Gets the recommended question to activate encryption.    /// </summary>    /// <returns>String of a recommended question to activate encryption.</returns>    procedure GetEncryptionIsNotActivatedQst(): Text    begin        exit(CryptographyManagementImpl.GetEncryptionIsNotActivatedQst());    end;    /// <summary>    /// Enables encryption.    /// </summary>    /// <param name="Silent">Enables encryption silently if true, otherwise will prompt the user.</param>    [Scope('OnPrem')]    procedure EnableEncryption(Silent: Boolean)    begin        CryptographyManagementImpl.EnableEncryption(Silent);    end;    /// <summary>    /// Disables encryption.    /// </summary>    /// <param name="Silent">Turns off encryption silently if true, otherwise will prompt the user.</param>    [Scope('OnPrem')]    procedure DisableEncryption(Silent: Boolean)    begin        CryptographyManagementImpl.DisableEncryption(Silent);    end;    /// <summary>    /// Publishes an event that allows subscription when enabling encryption.    /// </summary>    [IntegrationEvent(false, false)]    [Scope('OnPrem')]    internal procedure OnBeforeEnableEncryptionOnPrem()    begin    end;    /// <summary>    /// Publishes an event that allows subscription when disabling encryption.    /// </summary>    [IntegrationEvent(false, false)]    [Scope('OnPrem')]    internal procedure OnBeforeDisableEncryptionOnPrem()    begin    end;    /// <summary>    /// Generates a hash from a string based on the provided hash algorithm.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <returns>Hashed value.</returns>    procedure GenerateHash(InputString: SecretText; HashAlgorithmType: Option MD5,SHA1,SHA256,SHA384,SHA512): SecretText    begin        exit(CryptographyManagementImpl.GenerateHash(InputString, HashAlgorithmType));    end;    /// <summary>    /// Generates a hash from a string based on the provided hash algorithm.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <returns>Hashed value.</returns>    procedure GenerateHash(InputString: Text; HashAlgorithmType: Option MD5,SHA1,SHA256,SHA384,SHA512): Text    begin        exit(CryptographyManagementImpl.GenerateHash(InputString, HashAlgorithmType));    end;    /// <summary>    /// Generates a keyed hash from a string based on provided hash algorithm and key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Hashed value.</returns>    procedure GenerateHash(InputString: SecretText; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): SecretText    begin        exit(CryptographyManagementImpl.GenerateHash(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates a keyed hash from a string based on provided hash algorithm and key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Hashed value.</returns>    procedure GenerateHash(InputString: Text; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): Text    begin        exit(CryptographyManagementImpl.GenerateHash(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates a hash from a stream based on the provided hash algorithm.    /// </summary>    /// <param name="InputInStream">Input string.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateHash(InputInStream: InStream; HashAlgorithmType: Option MD5,SHA1,SHA256,SHA384,SHA512): Text    begin        exit(CryptographyManagementImpl.GenerateHash(InputInStream, HashAlgorithmType));    end;    /// <summary>    /// Generates a base64 encoded hash from a string based on provided hash algorithm.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateHashAsBase64String(InputString: SecretText; HashAlgorithmType: Option MD5,SHA1,SHA256,SHA384,SHA512): SecretText    begin        exit(CryptographyManagementImpl.GenerateHashAsBase64String(InputString, HashAlgorithmType));    end;    /// <summary>    /// Generates a base64 encoded hash from a string based on provided hash algorithm.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateHashAsBase64String(InputString: Text; HashAlgorithmType: Option MD5,SHA1,SHA256,SHA384,SHA512): Text    begin        exit(CryptographyManagementImpl.GenerateHashAsBase64String(InputString, HashAlgorithmType));    end;    /// <summary>    /// Generates a keyed base64 encoded hash from a string based on provided hash algorithm and key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateHashAsBase64String(InputString: SecretText; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): SecretText    begin        exit(CryptographyManagementImpl.GenerateHashAsBase64String(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates a keyed base64 encoded hash from a string based on provided hash algorithm and key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateHashAsBase64String(InputString: Text; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): Text    begin        exit(CryptographyManagementImpl.GenerateHashAsBase64String(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates keyed base64 encoded hash from provided string based on provided hash algorithm and base64 key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateBase64KeyedHashAsBase64String(InputString: SecretText; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): SecretText    begin        exit(CryptographyManagementImpl.GenerateBase64KeyedHashAsBase64String(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates keyed base64 encoded hash from provided string based on provided hash algorithm and base64 key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Base64 hashed value.</returns>    procedure GenerateBase64KeyedHashAsBase64String(InputString: Text; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): Text    begin        exit(CryptographyManagementImpl.GenerateBase64KeyedHashAsBase64String(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates keyed base64 encoded hash from provided string based on provided hash algorithm and base64 key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Hashed value.</returns>    procedure GenerateBase64KeyedHash(InputString: SecretText; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): SecretText    begin        exit(CryptographyManagementImpl.GenerateBase64KeyedHash(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Generates keyed base64 encoded hash from provided string based on provided hash algorithm and base64 key.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="Key">Key to use in the hash algorithm.</param>    /// <param name="HashAlgorithmType">The available hash algorithms include HMACMD5, HMACSHA1, HMACSHA256, HMACSHA384, and HMACSHA512.</param>    /// <returns>Hashed value.</returns>    procedure GenerateBase64KeyedHash(InputString: Text; "Key": SecretText; HashAlgorithmType: Option HMACMD5,HMACSHA1,HMACSHA256,HMACSHA384,HMACSHA512): Text    begin        exit(CryptographyManagementImpl.GenerateBase64KeyedHash(InputString, Key, HashAlgorithmType));    end;    /// <summary>    /// Computes the hash value of the specified string and signs it.    /// </summary>    /// <param name="InputString">Input string for signing.</param>    /// <param name="XmlString">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified string.</param>    procedure SignData(InputString: Text; XmlString: SecretText; HashAlgorithm: Enum "Hash Algorithm"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(InputString, XmlString, HashAlgorithm, SignatureOutStream);    end;    /// <summary>    /// Computes the hash value of the specified string and signs it.    /// </summary>    /// <param name="InputString">Input string for signing.</param>    /// <param name="XmlString">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified string.</param>    procedure SignData(InputString: SecretText; XmlString: SecretText; HashAlgorithm: Enum "Hash Algorithm"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(InputString, XmlString, HashAlgorithm, SignatureOutStream);    end;    /// <summary>    /// Computes the hash value of the specified data and signs it.    /// </summary>    /// <param name="DataInStream">The stream of input data.</param>    /// <param name="XmlString">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified input data.</param>    procedure SignData(DataInStream: InStream; XmlString: SecretText; HashAlgorithm: Enum "Hash Algorithm"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(DataInStream, XmlString, HashAlgorithm, SignatureOutStream);    end;    /// <summary>    /// Computes the hash value of the specified string and signs it.    /// </summary>    /// <param name="InputString">Input string for signing.</param>    /// <param name="SignatureKey">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified string.</param>    procedure SignData(InputString: Text; SignatureKey: Codeunit "Signature Key"; HashAlgorithm: Enum "Hash Algorithm"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(InputString, SignatureKey, HashAlgorithm, SignatureOutStream);    end;    /// <summary>    /// Computes the hash value of the specified string and signs it.    /// </summary>    /// <param name="InputString">Input string for signing.</param>    /// <param name="SignatureKey">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified string.</param>    procedure SignData(InputString: SecretText; SignatureKey: Codeunit "Signature Key"; HashAlgorithm: Enum "Hash Algorithm"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(InputString, SignatureKey, HashAlgorithm, SignatureOutStream);    end;    /// <summary>    /// Computes the hash value of the specified data and signs it.    /// </summary>    /// <param name="DataInStream">The stream of input data.</param>    /// <param name="SignatureKey">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified input data.</param>    procedure SignData(DataInStream: InStream; SignatureKey: Codeunit "Signature Key"; HashAlgorithm: Enum "Hash Algorithm"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(DataInStream, SignatureKey, HashAlgorithm, SignatureOutStream);    end;    /// <summary>    /// Computes the hash value of the specified string and signs it.    /// </summary>    /// <param name="InputString">Input string for signing.</param>    /// <param name="XmlString">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="RSASignaturePadding">The padding mode to use for the RSA signature.</param>    /// <param name="SignatureOutStream">The stream to write the signature for the specified string.</param>    procedure SignData(InputString: Text; XmlString: SecretText; HashAlgorithm: Enum "Hash Algorithm"; RSASignaturePadding: Enum "RSA Signature Padding"; SignatureOutStream: OutStream)    begin        CryptographyManagementImpl.SignData(InputString, XmlString, HashAlgorithm, RSASignaturePadding, SignatureOutStream);    end;    /// <summary>    /// Verifies that a digital signature is valid.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="XmlString">The public key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureInStream">The stream of signature.</param>    /// <returns>True if the signature is valid; otherwise, false.</returns>    procedure VerifyData(InputString: Text; XmlString: Text; HashAlgorithm: Enum "Hash Algorithm"; SignatureInStream: InStream): Boolean    begin        exit(CryptographyManagementImpl.VerifyData(InputString, XmlString, HashAlgorithm, SignatureInStream));    end;    /// <summary>    /// Verifies that a digital signature is valid.    /// </summary>    /// <param name="DataInStream">The stream of input data.</param>    /// <param name="XmlString">The public key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureInStream">The stream of signature.</param>    /// <returns>True if the signature is valid; otherwise, false.</returns>    procedure VerifyData(DataInStream: InStream; XmlString: Text; HashAlgorithm: Enum "Hash Algorithm"; SignatureInStream: InStream): Boolean    begin        exit(CryptographyManagementImpl.VerifyData(DataInStream, XmlString, HashAlgorithm, SignatureInStream));    end;    /// <summary>    /// Verifies that a digital signature is valid.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="SignatureKey">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureInStream">The stream of signature.</param>    /// <returns>True if the signature is valid; otherwise, false.</returns>    procedure VerifyData(InputString: Text; SignatureKey: Codeunit "Signature Key"; HashAlgorithm: Enum "Hash Algorithm"; SignatureInStream: InStream): Boolean    begin        exit(CryptographyManagementImpl.VerifyData(InputString, SignatureKey, HashAlgorithm, SignatureInStream));    end;    /// <summary>    /// Verifies that a digital signature is valid.    /// </summary>    /// <param name="InputString">Input string.</param>    /// <param name="XmlString">The public key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureInStream">The stream of signature.</param>    /// <returns>True if the signature is valid; otherwise, false.</returns>    procedure VerifyData(InputString: SecretText; XmlString: Text; HashAlgorithm: Enum "Hash Algorithm"; SignatureInStream: InStream): Boolean    begin        exit(CryptographyManagementImpl.VerifyData(InputString, XmlString, HashAlgorithm, SignatureInStream));    end;    /// <summary>    /// Verifies that a digital signature is valid.    /// </summary>    /// <param name="DataInStream">The stream of input data.</param>    /// <param name="SignatureKey">The private key to use in the hash algorithm.</param>    /// <param name="HashAlgorithm">The available hash algorithms are MD5, SHA1, SHA256, SHA384, and SHA512.</param>    /// <param name="SignatureInStream">The stream of signature.</param>    /// <returns>True if the signature is valid; otherwise, false.</returns>    procedure VerifyData(DataInStream: InStream; SignatureKey: Codeunit "Signature Key"; HashAlgorithm: Enum "Hash Algorithm"; SignatureInStream: InStream): Boolean    begin        exit(CryptographyManagementImpl.VerifyData(DataInStream, SignatureKey, HashAlgorithm, SignatureInStream));    end;}