Enabling JADE Smart Thin Client Security Encryption

The [JadeAppServer] and [JadeThinClient] sections of the JADE initialization file contain the RPCEncryptionEnabled and RPCEncryptionHookDLL parameters.

• If the RPCEncryptionEnabled parameter in the [JadeAppServer] section is set to true, the defined encryption is enforced on all presentation clients attached to that application server.

• The RPCEncryptionHookDLL parameter identifies the JADE or user-supplied encryption library. The available types of encryption are:

  • RPCEncryptionHookDLL=Internal, which uses Windows-supplied 40 bit encryption.

  • RPCEncryptionHookDLL=SSL_TLS, which enables the SSL security feature. When SSL security is enabled, the parameters whose names start with SSL are used. For details, see "Secure Sockets Layer (SSL) Security", later in this chapter.

  • RPCEncryptionHookDLL=<name>, which calls a user-supplied DLL with the name specified in the <name> value.

  The RPC encryption DLL must be thread-safe; that is, it must be able to handle multiple threads calling this library simultaneously.

The settings of the RPCEncryptionEnabled and RPCEncryptionHookDLL parameters in the [JadeAppServer] section override any setting in the [JadeThinClient] section if the combination of these two parameters are not values listed in the following table, except that the connection fails if the RPCEncryptionEnabled parameter is not set to true on both the application server and the presentation client when the RPCEncryptionHookDLL parameter is set to SSL_TLS.

Application Server	Presentation Client
False	False, or True when RPCEncryptionHookDLL = <dll-name> or Internal
True, with RPCEncryptionHookDLL = Internal	True, with RPCEncryptionHookDLL = Internal
True, with RPCEncryptionHookDLL = SSL_TLS	True, with RPCEncryptionHookDLL = SSL_TLS
True, with RPCEncryptionHookDLL = <dll-name>	True, with RPCEncryptionHookDLL = <dll-name>

For more details, see "Application Server Section [JadeAppServer]" and "JADE Presentation Client Section [JadeThinClient]" under "JADE Thin Client Sections", in the JADE Initialization File Reference. See also "Network Message Encryption", earlier in this chapter, for details about encrypting network messages.