Set up an SSO destination

Last updated: Feb 21, 2025
HEALTH TECH VENDOR
IMPLEMENTATION

This article is specific to SSO destinations. For all other destination types, learn how to set up a destination with the destination wizard instead.

Create an SSO destination

  1. Log in to the Redox dashboard.
  2. From the navigation menu, click the Developer page.
  3. By default, the API Keys tab displays. From the tab options, click the Destinations tab.
  4. Any existing destinations display. Click the New SSO config button.
  5. A new modal opens with a field for the name. Enter the name and click the Add button. 
    Add a new SSO destination
    Add a new SSO destination
  6. The Settings page for the new destination opens. The Name field displays the name you entered previously. 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.
  7. In the SSO secret field, click the New secret button.
  8. A modal appears, which allows you to set a new secret. Click the Yes, change it button.
    Set an SSO secret
    Set an SSO secret
  9. Copy the secret value, which verifies that the response is legitimate. Treat it like a password. The secret value only appears once, so store it somewhere secure.
    New SSO secret value
    New SSO secret value
     
  10. Exit out of the modal, then click the Save button to finish the SSO destination setup.

Delete an SSO destination

  1. Log in to the Redox dashboard.
  2. From the navigation menu, click the Developer page.
  3. By default, the API Keys tab displays. From the tab options, click the Destinations tab.
  4. Find the SSO destination you want to delete. Click the Edit button.
  5. The Settings page opens. Under the Delete Configuration section, click the Delete button.
    Delete an SSO destination
    Delete an SSO destination
  6. A confirmation modal appears. Click the Delete button to proceed.
    Confirm the deletion
    Confirm the deletion
  7. The SSO destination is deleted.