Module # Crypto --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ## Description Contains hashing methods for use with cryptography. ## Methods

table-centered_column_4

| Name | Parameters | Returns | Shared | |---------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|------------------------------------------| | `AESDecrypt` | publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock` | `MemoryBlock` | | | `AESEncrypt` | publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock` | `MemoryBlock` | | | `BERDecodePrivateKey` | privateKey As `String` | `MemoryBlock` | | | `BERDecodePublicKey` | publicKey As `String` | `MemoryBlock` | | | `BlowFishDecrypt` | publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock` | `MemoryBlock` | | | `BlowFishEncrypt` | publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock` | `MemoryBlock` | | | `DEREncodePrivateKey` | privateKey As `String` | `MemoryBlock` | | | `DEREncodePublicKey` | publicKey As `String` | `MemoryBlock` | | | `ED25519GenerateKeyPair` | `ByRef` PrivateKey As `String`, `ByRef` PublicKey As `String` | `Boolean` | | | `ED25519Sign` | data As `MemoryBlock` | privateKey As `String` | `MemoryBlock` | | `ED25519VerifyKey` | Key As `String` | `Boolean` | | | `ED25519VerifySignature` | data As `MemoryBlock`, signature As `MemoryBlock`, publicKey As `String` | `Boolean` | | | `ES256GenerateKeyPair` | `ByRef` PrivateKey As `String`, `ByRef` PublicKey As `String` | `Boolean` | | | `ES256Sign` | data As `MemoryBlock`, privateKey As `String` | `MemoryBlock` | | | `ES256VerifyKey` | Key As `String` | `Boolean` | | | `ES256VerifySignature` | data As `MemoryBlock`, signature As `MemoryBlock`, publicKey As `String` | `Boolean` | | | `GenerateRandomBytes` | ByteCount As `Integer` | `MemoryBlock` | | | `Hash` | data As `MemoryBlock`, hashAlgorithm As `Crypto.HashAlgorithms` | `MemoryBlock` | | | `HMAC` | key As `String`, data As `MemoryBlock`, hashAlgorithm As `Crypto.HashAlgorithms` | `MemoryBlock` | | | `MD5` | data As `MemoryBlock` | `MemoryBlock` | | | `PBKDF2` | salt As `String`, data As `MemoryBlock`, iterations As `Integer`, desiredHashLength As `Integer`, hashAlgorithm As `Crypto.HashAlgorithms` | `MemoryBlock` | | | `RSADecrypt` | Data As `MemoryBlock`, PrivateKey As `String` | `MemoryBlock` | | | `RSAEncrypt` | Data As `MemoryBlock`, PublicKey As `String` | `MemoryBlock` | | | `RSAGenerateKeyPair` | Bits As `Integer`, `ByRef` PrivateKey As `String`, `ByRef` PublicKey As `String` | `Boolean` | | | `RSASign` | data As `MemoryBlock`, privateKey As `String`, mode As `Crypto.RSASignModes` = `Crypto.RSASignModes.SHA1` | `MemoryBlock` | | | `RSAVerifyKey` | Key As `String` | `Boolean` | | | `RSAVerifySignature` | data As `MemoryBlock`, signature As `MemoryBlock`, publicKey As `String`, mode As `Crypto.RSASignModes.SHA1` | `Boolean` | | | `SHA1` | data As `MemoryBlock` | `MemoryBlock` | | | `SHA2_256` | data As `MemoryBlock` | `MemoryBlock` | | | `SHA2_512` | data As `MemoryBlock` | `MemoryBlock` | | | `SHA3_256` | data As `MemoryBlock` | `MemoryBlock` | | | `SHA3_512` | data As `MemoryBlock` | `MemoryBlock` | | | `TwoFishDecrypt` | publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto.BlockModes` = `BlockModes.CBC`, initializationVector As `MemoryBlock` | `MemoryBlock` | | | `TwoFishEncrypt` | publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto.BlockModes` = `BlockModes.CBC`, initializationVector As `MemoryBlock` | `MemoryBlock` | | ## Enumerations

forsearch

Crypto.BlockModes ### BlockModes > The block modes for use with AES, BlowFish and TwoFish encryption and decryption. > > | Enum | Description | > |------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| > | CBC | An initialization vector-based encryption scheme, the mode is secure as a probabilistic encryption scheme, achieving indistinguishability from random bits, assuming a random initialization vector. | > | ECB | A blockcipher, the mode enciphers messages that are a multiple of n bits by separately enciphering each n-bit piece. | > | CTR | A counter-based mode that turns the block cipher into a stream cipher by encrypting a nonce + counter value and XORing it with the data. It is fast, parallelizable, and uses the same operation for both encryption and decryption. |

forsearch

Crypto.HashAlgorithms ### HashAlgorithms > The hash algorithm to use with Crypto functions. > > | Enum | Description | > |----------|-------------------------------------------------------------------------------------| > | CRC32 | [CRC32](https://en.wikipedia.org/wiki/Cyclic_redundancy_check) | > | MD5 | [MD5 message-digest](https://en.wikipedia.org/wiki/MD5) | > | SHA1 | [SHA1 algorithm (160-bit (20-byte) hash value)](http://en.wikipedia.org/wiki/Sha1) | > | SHA256 | [SHA256 algorithm (SHA-2 with 256 bit digest)](http://en.wikipedia.org/wiki/Sha256) | > | SHA2_256 | [SHA256 algorithm (SHA-2 with 256 bit digest)](http://en.wikipedia.org/wiki/Sha256) | > | SHA2_512 | [SHA512 algorithm (SHA-2 with 512 bit digest)](http://en.wikipedia.org/wiki/Sha512) | > | SHA3_256 | [SHA3 algorithm](https://en.wikipedia.org/wiki/SHA-3) | > | SHA3_512 | [SHA3 algorithm](https://en.wikipedia.org/wiki/SHA-3) | > | SHA512 | [SHA512 algorithm (SHA-2 with 512 bit digest)](http://en.wikipedia.org/wiki/Sha512) |

forsearch

Crypto.RSASignModes ### RSASignModes > The sign modes to use with the `RSASign` and `RSAVerifySignature` methods. > > | Enum | Signing Scheme | > |-----------------|----------------------------------------------------------------------------------------------| > | PKCS1v15_SHA1 | [Public Key Cryptography Standards](https://en.wikipedia.org/wiki/PKCS_1) | > | PKCS1v15_SHA256 | [Public Key Cryptography Standards](https://en.wikipedia.org/wiki/PKCS_1) | > | PKCS1v15_SHA512 | [Public Key Cryptography Standards](https://en.wikipedia.org/wiki/PKCS_1) | > | PSS_SHA1 | [Probabilistic Signing Scheme](https://en.wikipedia.org/wiki/Probabilistic_signature_scheme) | > | PSS_SHA256 | [Probabilistic Signing Scheme](https://en.wikipedia.org/wiki/Probabilistic_signature_scheme) | > | PSS_SHA512 | [Probabilistic Signing Scheme](https://en.wikipedia.org/wiki/Probabilistic_signature_scheme) | The following RSASignModes are **deprecated** and thus should not be used: > | Enum | Description | > |----------|-------------------------------------------------------------------------------------| > | SHA1 | [SHA1 algorithm (160-bit (20-byte) hash value)](http://en.wikipedia.org/wiki/Sha1) | > | SHA2_256 | [SHA256 algorithm (SHA-2 with 256 bit digest)](http://en.wikipedia.org/wiki/Sha256) | > | SHA2_512 | [SHA512 algorithm (SHA-2 with 512 bit digest)](http://en.wikipedia.org/wiki/Sha512) | ## Method descriptions

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

forsearch

Crypto.AESDecrypt **AESDecrypt**(publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock`) As `MemoryBlock` > Decrypts the data using the specified *key*. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.AESEncrypt **AESEncrypt**(publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock`) As `MemoryBlock` > Encrypts the data using the specified *key*. > > An initialization vector (IV) is a block of bits that is used by several modes to randomize the encryption and hence to produce distinct ciphertexts even if the same plaintext is encrypted multiple times, without the need for a slower re-keying process. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.BERDecodePrivateKey **BERDecodePrivateKey**(privateKey As `String`) As `MemoryBlock` > Decodes a private key for interoperability with the BER encoding for use by other libraries. > > For more information, see: > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.BERDecodePublicKey **BERDecodePublicKey**(publicKey As `String`) As `MemoryBlock` > Decodes a public key for interoperability with the BER encoding for use by other libraries. > > For more information, see: > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.BlowFishDecrypt **BlowFishDecrypt**(publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock`) As `MemoryBlock` > Decrypts the data using the specified *key*. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.BlowFishEncrypt **BlowFishEncrypt**(publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto` = `BlockModes.CBC`, initializationVector As `MemoryBlock`) As `MemoryBlock` > Encrypts the data using the specified *key*. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.DEREncodePrivateKey **DEREncodePrivateKey**(privateKey As `String`) As `MemoryBlock` > Encodes a private key for interoperability with the DER encoding for use by other libraries. > > For more information, see: > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.DEREncodePublicKey **DEREncodePublicKey**(publicKey As `String`) As `MemoryBlock` > Encodes a public key for interoperability with the DER encoding for use by other libraries. > > For more information, see: > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.ED25519GenerateKeyPair **ED25519GenerateKeyPair**(`ByRef` PrivateKey As `String`, `ByRef` PublicKey As `String`) As `Boolean` > Generates a private and public key pair that is hex encoded. Returns `True` on success, `False` if failed. > > Generate 256-bit private and public keys: > >

> >

> > Important > >

> > This method is not currently supported for Android and Linux x86 64-bit. > >

> > Generate 1024-bit private and public keys: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.ED25519GenerateKeyPair(privateKey, publicKey) Then > ' 256-bit private and public keys were generated > End If > ```

forsearch

Crypto.ED25519Sign **ED25519Sign**(data As `MemoryBlock`, privateKey As `String`) As `MemoryBlock` > Encodes the *data* with the *privatekey* using ED25519 and returns it as a `MemoryBlock`. > >

> >

> > Important > >

> > This method is not currently supported for Android and Linux x86 64-bit. > >

forsearch

Crypto.ED25519VerifyKey **ED25519VerifyKey**(Key As `String`) As `Boolean` > Attempts to validate the specified public or private key passed. > >

> >

> > Important > >

> > This method is not currently supported for Android and Linux x86 64-bit. > >

> > Verifies the generated public key: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.ED25519GenerateKeyPair(privateKey, publicKey) Then > ' 256-bit private and public keys were generated > > If Crypto.ED25519VerifyKey(publicKey) Then > ' publicKey is valid > End If > > End If > ``` > > Verification fails on a "fake" key: > > ``` xojo > If Crypto.ED25519VerifyKey("not a real key!") Then > MessageBox("Valid!") > Else > MessageBox("Not valid!") > End If > ```

forsearch

Crypto.ED25519VerifySignature **ED25519VerifySignature**(data As `MemoryBlock`, signature As `MemoryBlock`, publicKey As `String`) As `Boolean` > Verifies the *data* using the specified *signature* and key. Returns `True` if the signature is verified, `False` if it is not. > >

> >

> > Important > >

> > This method is not currently supported for Android and Linux x86 64-bit. > >

> > Verify a message: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.ED25519GenerateKeyPair(privateKey, publicKey) Then > ' 256-bit private and public keys were generated > > Var msg As String = "this is a test" > Var signature As MemoryBlock = Crypto.ED25519Sign(msg, privateKey) > > If signature <> Nil Then ' msg was successfully signed > > ' Verify signature > If Crypto.ED25519VerifySignature(msg, signature, publicKey) Then > ' signature is valid > End If > > End If > End If > ```

forsearch

Crypto.ES256GenerateKeyPair **ES256GenerateKeyPair**(`ByRef` PrivateKey As `String`, `ByRef` PublicKey As `String`) As `Boolean` > Generates a private and public key pair that is hex encoded. Returns `True` on success, `False` if failed. > > Generate 256-bit private and public keys: > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

> > Generate 1024-bit private and public keys: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.ES256GenerateKeyPair(privateKey, publicKey) Then > ' 256-bit private and public keys were generated > End If > ```

forsearch

Crypto.ES256Sign **ES256Sign**(data As `MemoryBlock`, privateKey As `String`) As `MemoryBlock` > Encodes the *data* with the *privatekey* using ED256 and returns it as a `MemoryBlock`. > >

> >

> > Important > >

> > This method is not currently supported for Android and Linux 64-bit. > >

forsearch

Crypto.ES256VerifyKey **ES256VerifyKey**(Key As `String`) As `Boolean` > Attempts to validate the specified public or private key passed. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

> > Verifies the generated public key: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.ES256GenerateKeyPair(privateKey, publicKey) Then > ' 256-bit private and public keys were generated > > If Crypto.ES256VerifyKey(publicKey) Then > ' publicKey is valid > End If > > End If > ``` > > Verification fails on a "fake" key: > > ``` xojo > If Crypto.ES256VerifyKey("not a real key!") Then > MessageBox("Valid!") > Else > MessageBox("Not valid!") > End If > ```

forsearch

Crypto.ES256VerifySignature **ES256VerifySignature**(data As `MemoryBlock`, signature As `MemoryBlock`, publicKey As `String`) As `Boolean` > Verifies the *data* using the specified *signature* and key. Returns `True` if the signature is verified, `False` if it is not. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

> > Verify a message: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.ES256GenerateKeyPair(privateKey, publicKey) Then > ' 256-bit private and public keys were generated > > Var msg As String = "this is a test" > Var signature As MemoryBlock = Crypto.ES256Sign(msg, privateKey) > > If signature <> Nil Then ' msg was successfully signed > > ' Verify signature > If Crypto.ES256VerifySignature(msg, signature, publicKey) Then > ' signature is valid > End If > > End If > End If > ```

forsearch

Crypto.GenerateRandomBytes **GenerateRandomBytes**(ByteCount As `Integer`) As `MemoryBlock` > Generates a random block of data.

forsearch

Crypto.Hash **Hash**(data As `MemoryBlock`, hashAlgorithm As `Crypto.HashAlgorithms`) As `MemoryBlock` > Creates a hash value for the *data* using the specified *hashAlgorithm*. > > See the `Crypto` enumeration for values that can be used specify the type of Hash. > > This code calculates a hash for a password using SHA512: > > ``` xojo > Var hash As String > hash = Crypto.Hash("YourPasswordSentence", Crypto.HashAlgorithms.SHA512) > ```

forsearch

Crypto.HMAC **HMAC**(key As `String`, data As `MemoryBlock`, hashAlgorithm As `Crypto.HashAlgorithms`) As `MemoryBlock` > Creates the hash-based message authentication code using the *data* and the supplied *key* value and the supplied *hashAlgorithm*. > > The *key* value is applied to the *data* before generating the hash. > > See [HMAC on Wikipedia](http://en.wikipedia.org/wiki/Hash-based_message_authentication_code). > > Use the `Crypto` enumeration with the Hash method to specify the type of hash. It has these values: > > - MD5 > - SHA1 > - SHA2_256 > - SHA2_512 > >

> >

> > Warning > >

> > HMAC does not support CRC32, SHA3_256 and SHA3_512 modes. Using them will raise an `UnsupportedOperationException`. > >

> > This example creates a hash using HMAC and SHA512: > > ``` xojo > Var hash As String > hash = Crypto.HMAC("SaltValue", "YourPasswordSentence", Crypto.HashAlgorithms.SHA512) > ```

forsearch

Crypto.MD5 **MD5**(data As `MemoryBlock`) As `MemoryBlock` > Returns the MD5 message-digest value of the *data*. > > Works the same as the `MD5` function. > > ``` xojo > Var md5Value As MemoryBlock > md5Value = Crypto.MD5("SomeStringData") > > Var hexValue As String = EncodeHex(md5Value) > ' hexValue = 1E7984567DBC8AF6A48102C5E71A08E9 > ``` > > This above is equivalent to calling the Hash method with MD5 as the algorithm: > > ``` xojo > Var md5Value As MemoryBlock > md5Value = Crypto.Hash("SomeStringData", Crypto.Algorithm.MD5) > > Var hexValue As String = EncodeHex(md5Value) > ' hexValue = 1E7984567DBC8AF6A48102C5E71A08E9 > ```

forsearch

Crypto.PBKDF2 **PBKDF2**(salt As `String`, data As `MemoryBlock`, iterations As `Integer`, desiredHashLength As `Integer`, hashAlgorithm As `Crypto.hashAlgorithm`) As `MemoryBlock` > Returns the PBKDF2 hash value of the *data*, first applying the *salt* value and using the specified *hashAlgorithm*. The *iteration* parameter is the number of loops that the hash algorithm does. The *desiredHashLength* parameter lets you specify the number of bytes that you want the resulting hash to be. 16 or 32 bytes are commonly used. > > PBKDF2 is a "slow", i.e. deliberately processing intensive, algorithm for generating hash values. Slow is relative, for generating a single hash value it is plenty fast. The benefit of a slow algorithm is that it is impractical for hackers to generate hash tables using it because it would take too long to generate the thousands of hashes for commonly used values. > > Use a higher value for *iterations' to further slow the hash creation.* > > Refer to [PBKDF2](http://en.wikipedia.org/wiki/Pbkdf2) on Wikipedia. > > Use the `Crypto` enumeration with the Hash method to specify the type of hash. It has these values: > > - MD5 > - SHA1 > - SHA2_256 > - SHA2_512 > >

> >

> > Warning > >

> > PBKDF2 does not support CRC32, SHA3_256 and SHA3_512 modes. Using them will raise an `UnsupportedOperationException`. > >

> > This example generates a 32-byte hash using PBKDF2 for the salt and data, iterating 100 times: > > ``` xojo > Var hash As MemoryBlock > hash = Crypto.PBKDF2("SaltValue", "YourPasswordSentence", 100, 32, Crypto.HashAlgorithms.SHA512) > > Var hashValue As String = EncodeHex(hash) > ' FB8F64E66A72517AC7CA70145640B1932A986A7A7DDE7EC79602F8CE94DE0F8A > ```

forsearch

Crypto.RSADecrypt **RSADecrypt**(Data As `MemoryBlock`, PrivateKey As `String`) As `MemoryBlock` > Decrypts data using the specified key, which is either a private or public key. > > Decrypt a message: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.RSAGenerateKeyPair(1024, privateKey, publicKey) Then > ' 1024-bit private and public keys were generated > > Const kMessage = "this is a test" > > Var msg As New MemoryBlock(14) > msg.StringValue(0, 14) = kMessage > > ' Encrypt msg using the publicKey > Var encryptedData As MemoryBlock = Crypto.RSAEncrypt(msg, publicKey) > > If encryptedData <> Nil Then > MessageBox("Successfully encrypted.") > > ' Now decrypt > Var decryptedData As MemoryBlock = Crypto.RSADecrypt(encryptedData, privateKey) > MessageBox("DecryptedData=" + decryptedData.StringValue(0, 14)) > End If > End If > ```

forsearch

Crypto.RSAEncrypt **RSAEncrypt**(Data As `MemoryBlock`, PublicKey As `String`) As `MemoryBlock` > Encrypts the data using the specified *PublicKey*. > > Attempting to encrypt using a PrivateKey raises a `CryptoException`. > > Encrypt some text: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.RSAGenerateKeyPair(1024, privateKey, publicKey) Then > ' 1024-bit private and public keys were generated > > Const kMessage = "this is a test" > > Var msg As New MemoryBlock(14) > msg.StringValue(0, 14) = kMessage > > ' Encrypt msg using the publicKey > Var encryptedData As MemoryBlock = Crypto.RSAEncrypt(msg, publicKey) > > If encryptedData <> Nil Then > MessageBox("Successfully encrypted.") > End If > End If > ```

forsearch

Crypto.RSAGenerateKeyPair **RSAGenerateKeyPair**(Bits As `Integer`, `ByRef` PrivateKey As `String`, `ByRef` PublicKey As `String`) As `Boolean` > Generates a private and public key pair that is hex encoded. Returns `True` on success, `False` if failed. Bits is usually 1024 or 2048. > > Generate 1024-bit private and public keys: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.RSAGenerateKeyPair(1024, privateKey, publicKey) Then > ' 1024-bit private and public keys were generated > End If > ```

forsearch

Crypto.RSASign **RSASign**(data As `MemoryBlock`, privateKey As `String`, mode As `Crypto.RSASignModes.SHA1`) As `MemoryBlock` > Signs the *data* block using the specified *privateKey* using PKCS v1.5 with SHA1. > > Sign a message: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.RSAGenerateKeyPair(1024, privateKey, publicKey) Then > ' 1024-bit private and public keys were generated > > Var msg As String = "this is a test" > Var signature As MemoryBlock = Crypto.RSASign(msg, privateKey) > > If signature <> Nil Then > ' msg was successfully signed > End If > End If > ```

forsearch

Crypto.RSAVerifyKey **RSAVerifyKey**(Key As `String`) As `Boolean` > Attempts to validate the specified key. > > Verifies the generated public key: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.RSAGenerateKeyPair(1024, privateKey, publicKey) Then > ' 1024-bit private and public keys were generated > > If Crypto.RSAVerifyKey(publicKey) Then > ' publicKey is valid > End If > > End If > ``` > > Verification fails on a "fake" key: > > ``` xojo > If Crypto.RSAVerifyKey("not a real key!") Then > MessageBox("Valid!") > Else > MessageBox("Not valid!") > End If > ```

forsearch

Crypto.RSAVerifySignature **RSAVerifySignature**(data As `MemoryBlock`, signature As `MemoryBlock`, publicKey As `String`, mode As `Crypto.RSASignModes.SHA1`) As `Boolean` > Verifies the *data* using the specified *signature* and key using PKCS v1.5 with SHA1. Returns `True` if the signature is verified, `False` if it is not. > > Verify a message: > > ``` xojo > Var privateKey As String > Var publicKey As String > > If Crypto.RSAGenerateKeyPair(1024, privateKey, publicKey) Then > ' 1024-bit private and public keys were generated > > Var msg As String = "this is a test" > Var signature As MemoryBlock = Crypto.RSASign(msg, privateKey) > > If signature <> Nil Then ' msg was successfully signed > > ' Verify signature > If Crypto.RSAVerifySignature(msg, signature, publicKey) Then > ' signature is valid > End If > > End If > End If > ```

forsearch

Crypto.SHA1 **SHA1**(data As `MemoryBlock`) As `MemoryBlock` > Returns the SHA1 hash value of the *data*. > > Refer to [SHA1](http://en.wikipedia.org/wiki/Sha1) on Wikipedia. > > This is equivalent of calling the Hash method with SHA1 as the algorithm: > > ``` xojo > Var encryptedValue As String > encryptedValue = Crypto.Hash("DataToEncrypt", Crypto.HashAlgorithms.SHA1) > ```

forsearch

Crypto.SHA2_256 **SHA2_256**(data As `MemoryBlock`) As `MemoryBlock` > Returns the SHA256 hash value of the *data*. > > Refer to [SHA256](http://en.wikipedia.org/wiki/Sha256) on Wikipedia. > > This is equivalent of calling the Hash method with SHA256 as the algorithm: > > ``` xojo > Var encryptedValue As String > encryptedValue = Crypto.Hash("DataToEncrypt", Crypto.HashAlgorithms.SHA256) > ```

forsearch

Crypto.SHA2_512 **SHA2_512**(data As `MemoryBlock`) As `MemoryBlock` > Returns the SHA512 hash value of the *data*. > > Refer to [SHA512](http://en.wikipedia.org/wiki/Sha512) on Wikipedia. > > This is equivalent of calling the Hash method with SHA512 as the algorithm: > > ``` xojo > Var encryptedValue As String > encryptedValue = Crypto.Hash("DataToEncrypt", Crypto.HashAlgorithms.SHA512) > ```

forsearch

Crypto.SHA3_256 **SHA3_256**(data As `MemoryBlock`) As `MemoryBlock` > Returns the SHA3_256 hash value of the *data*. > > Refer to [SHA-3](https://en.wikipedia.org/wiki/SHA-3) on Wikipedia. > > This is equivalent of calling the Hash method with SHA3_256 as the algorithm: > > ``` xojo > Var encryptedValue As String > encryptedValue = Crypto.Hash("DataToEncrypt", Crypto.HashAlgorithms.SHA3_256) > ```

forsearch

Crypto.SHA3_512 **SHA3_512**(data As `MemoryBlock`) As `MemoryBlock` > Returns the SHA3_512 hash value of the *data*. > > Refer to [SHA-3](http://en.wikipedia.org/wiki/SHA-3) on Wikipedia. > > This is equivalent of calling the Hash method with SHA3_512 as the algorithm: > > ``` xojo > Var encryptedValue As String > encryptedValue = Crypto.Hash("DataToEncrypt", Crypto.HashAlgorithms.SHA3_512) > ```

forsearch

Crypto.TwoFishDecrypt **TwoFishDecrypt**(publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto.BlockModes` = `BlockModes.CBC`, initializationVector As `MemoryBlock`) As `MemoryBlock` > Decrypts the data using the specified *key*. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

forsearch

Crypto.TwoFishEncrypt **TwoFishEncrypt**(publicKey As `String`, data As `MemoryBlock`, blockMode As `Crypto.BlockModes` = `BlockModes.CBC`, initializationVector As `MemoryBlock`) As `MemoryBlock` > Encrypts the data using the specified *key*. > >

> >

> > Important > >

> > This method is not currently supported for Android. > >

## Notes Uses Crypto++ [Library 5.6.5](http://cryptopp.com). Use the `HashAlgorithms` enumeration with the Hash method to specify the type of hash. Should any Crypto function fail, a `CryptoException` will be raised. ## Compatibility | | | |-----------------------|-----| | **Project Types** | All | | **Operating Systems** | All |

`CryptoException` class.