Package: digitalsign

Digital signature reading API. 

Since 1.5.2

Example #

Read digital signatures from P7S #

This example shows how to read signatures for a given P7S signed file.

workflow DigitalSignExample;

method main() {
	//The key for a P7S signed file
	var signedFileKey = 100;
	var signature as string;
	foreach sign in digitalsign->getSignatures(signedFileKey) {
		signature = signature + sign.subjectGivenName + " " + sign.subjectSN + " ";
	}
}

RSA Encrypt/Decrypt #

This example shows how to generate a RSA key pair and then encrypt and decrypt a message with the generated key pair.

workflow RSAEncryptDecrypt;

method main() {
	//Generate a key pair with the size 2048
    var keyPair = digitalsign->getKeyPairRSA(2048);
    //The key pair should be reused

	//Using the key pair encrypt and decrypt the message
	var encrypted = digitalsign->encryptRSA("Hello world", keyPair.publicKey);
    var decrypted = digitalsign->decryptRSA(encrypted, keyPair.privateKey);

    system->error(decrypted);
}

Methods #

createKeyPairRSA #

function createKeyPairRSA(keySize as int) as {
	publicKey as string,
	privateKey as string
}

Creates a new public-private key pair.

decryptPBKDF2 #

function decryptPBKDF2(encryptedMessage as string, salt as string, iv as string, password as string) as string

Decrypts the message using the password using the PBKDF2 algorithm. See the Wikipedia article for more details about the algorithm.

The encryptedMessage argument must be binary encoded as base64 string. The salt and iv arguments must be the same as the ones obtained when the message was encrypted.

Since 1.7.2

decryptRSA #

function decryptRSA(message as string, privateKey as string) as string

Decrypts the message using the public key. Returns the decrypted message.

Since 1.7.2

encryptPBKDF2 #

function encryptPBKDF2(message as string, password as string) as {
	encryptedMessage as string,
	salt as string,
	iv as string
}

Encrypts the message using the password using the PBKDF2 algorithm. See the Wikipedia article for more details about the algorithm.

The resulting encryptedMessage is binary encoded as base64 string. The resulting salt and iv must be stored alongside of the encrypted message.

Since 1.7.2

encryptRSA #

function encryptRSA(message as string, publicKey as string) as string

Encrypts the message using the private key. Returns the encrypted message.

Since 1.7.2

getSignatures #

function getSignatures(storageFileKey as int) as list of digitalsignature

Returns a list of PKCS #7 digital signatures associated to the specified storage file.

verify #

function verify(signature as digitalsignature, publicKeyStorageFileKey as int) as boolean

True if the digital signature corresponds to the public key.

Since 1.7.2

Encrypts the message using the password using the PBKDF2 algorithm. See the Wikipedia article for more details about the algorithm.

The resulting encryptedMessage is binary encoded as base64 string. The resulting salt and iv must be stored alongside of the encrypted message.

Since 1.7.2

decryptPBKDF2 #

function decryptPBKDF2(encryptedMessage as string, salt as string, iv as string, password as string) as string

Decrypts the message using the password using the PBKDF2 algorithm. See the Wikipedia article for more details about the algorithm.

The encryptedMessage argument must be binary encoded as base64 string. The salt and iv arguments must be the same as the ones obtained when the message was encrypted.

Since 1.7.2

Types #

digitalsignature #