Overview
This article is about configuring the SAML method of SSO authentication in Birdview when using the OKTA provider.
One of the SSO authentication methods in Birdview is SAML. Below are the instructions on how configure SAML authentication using the OKTA provider.
In this article
Steps
- In your OKTA account, open the Admin console and Applications. Click Create App Integration.
- In the dialog window that opens, select SAML 2.0.
- On General Settings, type in a name, upload an icon (optionally), and click Next.
- Open your Birdview account. Click your avatar in the left bottom corner and choose Company settings.
- Choose Account settings > Single sign-on options.
- Toggle Enable single sign-on on and choose SAML.
- Copy Assertion Consumer Service (ACS) in the Service Provider metadata section. — Switch to OKTA. Paste the value in the Single sign-on URL field.
- Switch back to Birdview: Copy Entity ID in the Service Provider metadata section — Switch to OKTA. Paste the Entity ID value in the Audience URI (SP Entity ID) field.
- (In OKTA) Click Next.
- On Step 3, select I'm an OKTA customer adding an internal app and click Finish.
- OKTA will redirect you to your created integration > Sign On tab. In the Sign on methods section, copy the Metadata URL.
- Switch back to Birdview. In the section Identity Provider metadata, paste the URL into Fetch from URL field.
- Click Apply.
- Switch to OKTA — For your application, open the Assignments tab and click Assign.
- Set up desired users or groups.
- You are now all set. A user can now click the button Sign in with Active Directory on the Birdview login page to login with OKTA SAML.
- The inscription on the button can be customized using the Customize SSO login button text field found in another section on the same page (Company Settings > Account Settings > Single sign-in options > Session management).
Button Inscription Example
The button now bears a new inscription: