Configuring Encryption Settings for URL Integrations - Configuring Encryption Settings for URL Integrations - OnBase - Integration for Epic - OnBase/Integration-for-Epic/Foundation-23.1/Integration-for-Epic/Configuration/General-Configuration/Authentication-Configuration/Configuring-Encryption-Settings-for-URL-Integrations - Foundation 23.1 - Foundation 23.1

Integration for Epic
Platform
OnBase
Product
Integration for Epic
Release
Foundation 23.1
License
Premier
Standard
Essential
ft:lastPublication
2026-04-02T22:52:56.865000
ft:locale
en-US

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:

  1. In the OnBase Configuration module, select Utils | External Systems. The External System Configuration dialog box is displayed.
  2. Select Epic.
  3. Click Values. The External System Parameter Configuration dialog box is displayed.
  4. 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.
  5. Click Save to save the configuration.