HYPE Boards

Here you can find a brief guide on how to set up Okta single sign-on for Viima.

For a more comprehensive look at the setup, please refer to <a href="https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Viima.html?baseAdminUrl=https://viima-admin.okta.com&amp;app=viima&amp;instanceId=0oauvtob45JjVGTJn356" rel="nofollow noopener noreferrer" target="_blank">the dedicated Okta guide for Viima setup</a>.

Login to the Viima admin portal at <a href="https://app.viima.com/admin/" rel="nofollow noopener noreferrer" target="_blank">https://app.viima.com/admin/</a>

 Select the board to which you want to enable the Okta login from the board dropdown at the  top left corner

 Navigate to Settings (link icon at topbar) &gt; Access Rights (tab on the opening page) &gt; Access restrictions (link on the opening tab

1. Login URL e.g. <a href="https://viima.okta.com/app/slack/exkmciaqouXFDDIh9356/sso/saml" rel="nofollow noopener noreferrer" target="_blank">https://viima.okta.com/app/slack/exkmciaqouXFDDIh9356/sso/saml</a>
2. Entity ID
3. e.g. <a href="http://www.okta.com/exkmciaqouXFDDIh9356" rel="nofollow noopener noreferrer" target="_blank">http://www.okta.com/exkmciaqouXFDDIh9356</a>
4. Certificate fingerprint (SHA1) e.g. d364cb89a9c6853f43f970131101545b387df0823432b5083e990e98b32a85af Do NOT input the whole certificate but the SHA1 fingerprint
5. Click "Connect"
6. Click the "Save" button at the top right corner of the "Access Restrictions" section

1. Login to the Viima admin portal at <a href="https://app.viima.com/admin/" rel="nofollow noopener noreferrer" target="_blank">https://app.viima.com/admin/</a>
2. Select the board to which you want to enable the Okta login from the board dropdown at the top left corner
3. Navigate to Settings (link icon at topbar) &gt; Access Rights (tab on the opening page) &gt; Access restrictions (link on the opening tab
4. Select SAML 2.0 from the login options
5. Click "Connect to a SAML service"
6. Enter the following: 
 1. Login URL e.g. <a href="https://viima.okta.com/app/slack/exkmciaqouXFDDIh9356/sso/saml" rel="nofollow noopener noreferrer" target="_blank">https://viima.okta.com/app/slack/exkmciaqouXFDDIh9356/sso/saml</a>
 2. Entity ID
 3. e.g. <a href="http://www.okta.com/exkmciaqouXFDDIh9356" rel="nofollow noopener noreferrer" target="_blank">http://www.okta.com/exkmciaqouXFDDIh9356</a>
 4. Certificate fingerprint (SHA1) e.g. d364cb89a9c6853f43f970131101545b387df0823432b5083e990e98b32a85af Do NOT input the whole certificate but the SHA1 fingerprint
 5. Click "Connect"
 6. Click the "Save" button at the top right corner of the "Access Restrictions" section

Open the user dropdown at the top right corner and click the link "Board view"

From the opening board view, open the user dropdown at the top right corner and click the link "Log out"

From the opening login screen, click the Okta login button (named "Log in with your work account" by default)

The test succeeded if you were redirected to the board view

1. Open the user dropdown at the top right corner and click the link "Board view"
2. From the opening board view, open the user dropdown at the top right corner and click the link "Log out"
3. From the opening login screen, click the Okta login button (named "Log in with your work account" by default)
4. Type in your Okta credentials
5. The test succeeded if you were redirected to the board view

Configuration Steps

Test the integration