IPWorks Encrypt 2020 Python Edition

Questions / Feedback?

encrypt Method

Encrypts the XML.

Syntax

def encrypt() -> None: ...

Remarks

This method encrypts the specified XML.

To begin first specify a XML document by setting input_file, or input_xml.

The EncryptedDataDetail* properties specify the XML element to encrypt. By default the entire XML document is encrypted.

The symmetric_key property specifies the key which will be used to encrypt the data.

If the RecipientCert* properties are set, then the symmetric_key will be encrypted and included in the encrypted data. This allows for the recipient to decrypt the key, with their certificate. Encrypting the symmetric key is also referred to as using a session key. The benefit of using certificate to encrypt and decrypt a session key (symmetric_key) is that knowledge of the key value is not needed ahead of time to process the encrypted data. Note that if specified, recipient_cert MUST have a RSA key, not a DSA key.

If the RecipientCert* properties are not set, then the recipient must know the value of symmetric_key before decrypting the XML. The KeyName setting may be set to provide a key identifier to the recipient.

Optionally set encrypting_algorithm, and then call on_encrypt to encrypt the XML.

The following properties are applicable when calling this method:

Input and Output Properties

The class will determine the source and destination of the input and output based on which properties are set.

The order in which the input properties are checked is as follows:

When a valid source is found the search stops. The order in which the output properties are checked is as follows:

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Encrypt 2020 Python Edition - Version 20.0 [Build 8155]