Encryption settings specify how Epic encrypts information sent in URL query strings. You must configure these settings if any OnBase application will receive Epic authentication information through a URL query string. Possible applications include (but are not limited to) DocPop OnBase Patient Window, and OnBase Web Viewer.
To configure encryption settings:
-
In the OnBase Configuration module, select Utils | External Systems. The External System Configuration dialog box is displayed.
- Select Epic.
-
Click Values. The External System Parameter Configuration dialog box is displayed.
-
Configure the keys described in the following table. For each key, enter the appropriate value, and click Add.
Note:
Key names are case sensitive and must be entered exactly as shown in this table.
Key
Value Description
Epic Encryption Key
The value Epic uses to encrypt the URL query string. This value should match the Cryptkey value configured in the Epic application.
Note:Beginning in Epic 2015, the Cryptkey attribute has been renamed to DEPRECATED_CRYPTKEY. Although the name has changed, you should still use the DEPRECATED_CRYPTKEY setting to configure encryption with OnBase integrations.
Depending on the Epic Encryption Key Size, the Epic Encyption Key must use the following types of values:
-
When using an AES 256 Epic Encryption Key Size, the Epic Encryption Key must be a 32-byte Base64-encoded value.
-
When using an AES 128 Epic Encryption Key Size, the Epic Encryption Key must be a SHA1 hash of a plain-text value.
Epic Encryption Key Size
The key size for the AES encryption. Valid values are 128 and 256.
-
- Click Save to save the configuration.