Embedding Care Team Portal in Epic Hyperspace via Hyperdrive

  • Release version: Zurich
  • Updated March 12, 2026
  • 1 minute to read
  • Configure the Care Team Portal by embedding it into Epic Hyperspace via Hyperdrive and enabling SMART on FHIR authentication.

    1. Configure iFrame embedding for Care Team Portal

      For the Care Team Portal to successfully launch in Hyperspace via Hyperdrive, the portal must be configured to work within an iFrame.

    2. Enable Multi-Provider SSO for your ServiceNow instance

      Ensure that Multiple Provider SSO is enabled and configured correctly for Care Team Portal to authenticate with Epic Hyperspace via Hyperdrive.

    3. Copy HCLS Script Includes to Global Scope

      Copy the MultiSSO_OIDC_CTO and OAuthUtilEpic script includes to the global scope so they are available for later configuration steps.

    4. In Epic: Build the FHIR App to Authenticate with ServiceNow

      Set up your FHIR app in Epic with the correct configurations to allow single sign-on for Epic users to access the Care Team Portal inside Epic Hyperspace via Hyperdrive.

    5. Create and Configure an Identity Provider in ServiceNow to Authenticate with Epic

      Set up and configure an Identity Provider in your ServiceNow instance to authenticate with Epic.

    6. In Epic: Configure Epic Hyperspace Integration

      Configure the Epic integration records (FDI, Activity, and Menu) so that a button in Epic launches the ServiceNow Care Team Portal.

    7. Capture Additional Data From Epic Within ServiceNow Record Producers

      Capture additional data from Epic within ServiceNow record producers by configuring variables that map to the Epic authorization token.