lr_encrypt_ex

Encrypts a string.

C Language

char* lr_encrypt_ex(const char* plaintext);

Java

String lr.encrypt_ex( String plaintext);

Arguments

NameComments
plaintextThe string to encrypt.

The lr_encrypt_ex function is used to encrypt messages. Encryption is based on the AES-256-GCM algorithm and is compliant with FIPS requirements. The encrypted string can be decrypted by lr_decrypt_ex.

The AES key must be set before this function can be used. For details, see Add an AES key in the Help Center.

Tip: You can encrypt a string in the script using the same encryption method, by right-clicking the string and selecting Encrypt String (Stronger Encryption). The string is encrypted and inserted as an argument of lr_decrypt_ex.

Return Values

This function returns an encrypted string.

Parameterization

The argument plaintext can be parameterized.

Examples

C

Copy code
Action()
{
    char* ciphertext;
    char* plaintext;
    
    ciphertext = lr_encrypt_ex("hello world!");
    plaintext = lr_decrypt_ex(ciphertext);
    
    lr_output_message("ciphertext is %s", ciphertext);
    lr_output_message("plaintext is %s", plaintext);
    
    return 0;
}

Java

Copy code
import lrapi.lr;

public class Actions
{

    public int init() throws Throwable {
        return 0;
    }//end of init
    
    public int action() throws Throwable {
        String ciphertext = "Hello World!";
        String encrypted = lr.encrypt_ex(ciphertext);
        String decrypted = lr.decrypt_ex(encrypted);
        lr.output_message(decrypted);
        return 0;
    }//end of action
    
    public int end() throws Throwable {
        return 0;
    }//end of end