Using Okta to protect your hub
Okta, as a SAML 2.0 IDp service, can be connected to your StatusHub to help keep your hub private.
To configure this, you will need to follow these steps inside your Okta account:
- Log in to your Okta organization as a user with administrative privileges.
If you don’t have an Okta organization, you can create a free Okta Developer Edition organization here: https://www.okta.com/developer/signup/.
- Click on the “Admin” button.
3. Choose 'Applications' and click on 'Create App Integration.'
4. In the open dialogue, select the “SAML 2.0” option, then click 'Next'.
5. In Step 1, “General Settings,” enter “StatusHub” in the “App name” field, then click the “Next” button.
6. In Step 2, “Configure SAML.”
Paste the copied URL from your StatusHub account into the “Single sign-on URL” and “Audience URI (SP Entity ID)” fields.
Your distinct URL you will find under Hub Config - Restricted Access - Restrict access using SAML 2.0.
OKTA: Single sign-on URL = StatusHub: SSO URL
OKTA: Audience URI(SP Entity ID) = StatusHub: SP Issuer
Please note that the SSO URL and Issuer values can be the same or different.
- Click “Show Advanced Settings.”
- In the “Attribute Statements” section, add three attribute statements:
- “FirstName” set to “${user.firstName}”
- “LastName” set to “${user.lastName}”
- “Email” set to “${user.email}”
- Then click the “Next” button
7. In Step 3, “Feedback,” click the checkbox next to the text “I'm an Okta customer adding an internal app” then click the “Finish” button.
8. You will now see the “Sign-On” section of your newly created “StatusHub” application.
9. Keep this page open in a separate tab or browser window. You will need to return to this page later in this guide and paste the contents of the XML metadata
10. Locate the SAML 2.0 checkbox and click the link beneath it that says, "SAML 2.0 setup instructions for StatusHub."
11. The IDP metadata in block 4 contains the information and can be saved as an XML file (i.e., IDP.XML), which you can paste into the StatusHub configuration:
12. Scroll down to click 'Save changes'. After that, you should be able to see the green banner "Restricted access set successfully."
13. Now, you can upload all users to your Okta StatusHub application.
