Warning: This data type will be discontinued in GeneXus 18 Upgrade 5.
GeneXus Security API is on the way to replace this data type. It is recommended to migrate your code and use this API before GeneXus 18 Upgrade 5.
CryptoHash belongs to the Cryptography data types.
| Name |
Description |
| Compute(text:String[,key:String]) |
Returns the text resulting from the application of the hash function on the text entered.
As Keyed-Hash Message Authentication Code is supported, a key can be optionally passed to the method. |
| Algorithm:String |
Allows us to specify the hash algorithm that will be applied when the Compute(String,[key]) method is invoked. The SHA256 is used by default.
CryptoHashAlgorithm is a predefined enumerated domain containing the Hash algorithms supported. |
The example below uses the Hash algorithm SHA1.
&CryptoHash.Algorithm = CryptoHashAlgorithm.SHA1 //&CryptoHash is of CryptoHash type.
&resultstringSHA1 = &CryptoHash.Compute(&text)
The following example uses the HMAC SHA512 algorithm.
&CryptoHash.Algorithm = CryptoHashAlgorithm.HMACSHA512 //&CryptoHash is of CryptoHash type.
&resultingstringHMACSHA512 = &CryptoHash.Compute(&text,&key)
- The SHA256 is used by default since GeneXus Evolution v15 U10. The previous versions use SHA1
- When using a Non-Keyed-Hash Message Authentication code in Compute method, if a key is specified the following error is thrown:
3.00 Algorithm does not support Hashing with Key. Please use HMAC instead or remove the Key parameter
- When using sing Keyed-Hash Message Authentication code, the &CryptoHash.Algorithm property should be set to HMACSHA256, HMACSHA1, HMACSHA384, HMACSHA512, or HMACMD5.
In such case, if &CryptoHash.Algorithm is set to any of these values and no key is specified, the following error is thrown:
4.00 Key must be specified.
Another possible error is the following:
5.00 Invalid Key.
| Generators: |
.NET, Java, Apple |
The availability of the Keyed-Hash Authentication is as of GeneXus 15 Upgrade 3.
For Native Mobile environments, is available as of Genexus 15 Upgrade 10.