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).
- 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.
- Log in to the Redox dashboard.
- From the navigation menu, click the Developer page.
- By default, the Sources tab opens. Click the Destinations tab.
- Any existing destinations display. Click the New SSO config button to create an SSO destination.
- 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.]( "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 - The Settings page for the new destination opens. The Name field displays the name you entered previously. Enter the SSO settings:
- 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://.
- 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.
- In the SSO secret field, click the New secret button.
- A modal appears, which allows you to set a new secret. Click the Yes, change it button.
![A confirmation modal requires a user to confirm whether they want to change the SSO secret.]( "A confirmation modal requires a user to confirm whether they want to change the SSO secret.")
Set an SSO secret - The new secret value displays only once. Click the Copy button 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.]( "The new secret secret value appears only once for a user to copy and store.")
New SSO secret value - Close the modal, then click the Save button to finish the SSO destination setup.
- Log in to the Redox dashboard.
- From the navigation menu, click the Developer page.
- By default, the Sources tab opens. Click the Destinations tab.
- Find the SSO destination you want to delete. Click the Edit button.
- The Settings page opens. Under the Delete Configuration section, click the Delete button.
![The Delete button appears under the Delete configuration section of the destination settings.]( "The Delete button appears under the Delete configuration section of the destination settings.")
Delete an SSO destination - A confirmation modal appears. Click the Delete button to proceed.
![Confirm the deletion]( "Confirm the deletion")
Confirm the deletion - The SSO destination is deleted.
