Note: You are looking at a static snapshot of documentation related to Robot Framework automations. The most recent documentation is at https://robocorp.com/docs

RPA.Crypto

Library for common encryption and hashing operations.

Library uses by default the Fernet format for encryption. More specifically, it uses AES in CBC mode with a 128-bit key for encryption and HMAC with SHA256 for authentication.

Alternative encryption format for the library is AES256.

To use the encryption features, generate a key with the command line utility rpa-crypto or with the keyword Generate Key. Store the key in a secure place, such as Robocorp Vault, and load it within the execution before calling encryption/decryption keywords.

Example usage with Robocorp Vault

Create an encryption key with the CLI utility:

> rpa-crypto key rGx1edA07yz7uD08ChiPSunn8vaauRxw0pAbsal9zjM=

Store the key in Robocorp Vault, in this case with the name EncryptionKey.

Load the key from the vault before encryption operations:

Use encryption key from vault EncryptionKey ${encrypted}= Encrypt file orders.xlsx Add work item file ${encrypted} name=Orders

In another task, this same key can be used to decrypt the file:

Use encryption key from vault EncryptionKey ${encrypted}= Get work item file Orders ${orders}= Decrypt file ${encrypted}

Importing

Initialize self. See help(type(self)) for accurate signature.