Home
How to use Redox
Manage your Redox setup
Set up an SSO destination

Set up an SSO destination

Last updated: Jul 14, 2026
HEALTH TECH VENDOR
IMPLEMENTATION

This article is specific to SSO destinations, or SSO configs as they’re referred to in the Redox dashboard. A health tech vendor needs an SSO destination to launch an app from an EHR system. Learn more about handling app launch (SSO).

Prerequisites

  • A user must be assigned to an engineer role to manage destinations. Learn about user roles.
  • Decide on and configure your supported authentication standard (e.g., SMART on FHIR®, SAML Web Browser Profile) to handle app launch.

Create an SSO destination

  1. Log in to the Redox dashboard.
  2. From the navigation menu, click the Developer page.
  3. By default, the Sources tab opens. Click the Destinations tab.
  4. Any configured destinations display. Click the New button > New SSO config option to create an SSO destination.
  5. A new modal opens with a field for the name. Enter the name and click the Add button. 
    A user enters the name of a new SSO config, or destination, and the Add button is highlighted to complete setup.
    Add a new SSO destination
  6. The Settings page for the new destination opens. The Name field displays the name you entered previously. 
  7. Click the Edit button to enter the SSO settings:
    1. SSO URL: Enter the URL that will receive POST requests. The URL should use SSL/TLS encryption, which means it needs to start with https://.
    2. SSO error URL: Enter the URL where the requestor should be redirected in the event of an error message. We recommend a static error page separate from the SSO service.
      A user clicks the Edit button to make the SSO URL and SSO error URL fields editable.
      Enter SSO URLs
  8. Under the Authentication section, click the Edit button.
  9. In the SSO secret field, click the Reset secret button.
  10. A confirmation modal appears. Click the Reset button.
    A confirmation modal requires a user to confirm whether they want to change the SSO secret.
    Set an SSO secret
  11. The new secret value displays only once. Click the Copy icon to copy the new secret value, then store it securely.
    The new secret secret value appears only once for a user to copy and store.
    New SSO secret value
     
  12. Click the Save button to finish the SSO destination setup.
    A user resets the secret. After copying and storing the secret, the user clicks the Save button.
    Configure the secret value

Delete an SSO destination

  1. Log in to the Redox dashboard.
  2. From the navigation menu, click the Developer page.
  3. By default, the Sources tab opens. Click the Destinations tab.
  4. In the table, click the SSO destination row you want to delete.
  5. The Details page opens. Click the Delete button in the top-right corner.
  6. A confirmation modal appears. Click the Delete button to proceed.
    The Delete button appears under the Delete configuration section of the destination settings.
    Delete an SSO destination
  7. The SSO destination is deleted.

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.