JWE Configuration
The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.JWE Configuration Settings
CompressionAlgorithm:
The compression algorithm to use.This setting specifies the compression algorithm to use (if any). If set the
content will be compressed using the specified algorithm. Possible values are:
| |
PartyUInfo:
Information about the producer of the message.This setting may optionally be set when Algorithm is set to an ECDH algorithm before calling Encrypt.
When calling Decrypt this setting is populated and also accessible from within the RecipientInfo event.
The value may be any string. To specify a base64url encoded value directly prefix the string with [b64].
For instance the following lines both set the same value:
jwe.Config("PartyUInfo=Alice");
jwe.Config("PartyUInfo=[b64]QWxpY2U="); //Equivalent to above line
| |
PartyVInfo:
Information about the recipient of the message.This setting may optionally be set when Algorithm is set to an ECDH algorithm before calling Encrypt.
When calling Decrypt this setting is populated and also accessible from within the RecipientInfo event.
The value may be any string. To specify a base64url encoded value directly prefix the string with [b64].
For instance the following lines both set the same value:
jwe.Config("PartyUInfo=Bob");
jwe.Config("PartyUInfo=[b64]Qm9i"); //Equivalent to above line
| |
| PBES2Count:
The PBKDF2 iteration count.This setting specifies the PBDKF2 iteration count. A minimum value of 1000 is recommended. The default value is 1000.
This setting is only applicable when EncryptionAlgorithm is set to a PBES algorithm. | |
| PBES2SaltLength:
The salt input value length.This setting specifies the length in bytes of the salt input value, which is used as part of the PBKDF2 salt value.
The default value is 16.
This setting is only applicable when EncryptionAlgorithm is set to a PBES algorithm. | |
| RawHeader:
Holds the raw JOSE header.This setting may be queried after calling Encrypt or Decrypt to obtain the raw JOSE header. This returns a JSON
string like:
{"alg":"A128GCMKW","enc":"A256CBC-HS512","iv":"oSqGqGiA48O1uD9b","tag":"0WNBx27Z5aL5uvsd01d1Tw"} | |
| StrictValidation:
Requires specific algorithm when decrypting.If set to True the component will validate the that algorithms used in the JWE message match the values
specified in EncryptionAlgorithm and ContentEncryptionAlgorithm. If either algorithms do not match
the component raises an exception.
By default this setting is False and the algorithms are read automatically from the encrypted JWE message. |
Base Configuration Settings
| BuildInfo: Information about the product's build.When queried, this setting will return a string containing information about the product's build. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| CodePage:
The system code page used for Unicode to Multibyte translations.The default code page is Unicode UTF-8 (65001).
The following is a list of valid code page identifiers:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LicenseInfo:
Information about the current license.When queried, this setting will return a string containing information about the license this instance of a component is using. It will return the following information:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| UseInternalSecurityAPI: Tells the component whether or not to use the system security libraries or an internal implementation. By default the component will use the system security libraries to perform cryptographic functions. Setting this to True tells the component to use the internal implementation instead of using the system's security API. |