Setup iMIS Single Sign-On (SSO) with your Video Library

Configure iMIS SSO Application with your video library

The first steps walks through configuring your webcastcloud video library as an application for Single Sign-On within iMIS:

1. Browse to iMIS Settings >Contacts >Client Applications
   
   For prior versions of iMIS, this can be found under RiSE >Maintenance >Client Applications
   
   
2. Add Client Application
   • Client ID: webcastcloud
   • Client Secret: create a unique cryptic password.
   • Refresh Token: between 1 and 60.
   • Return URL: https://<hostname>/iMIS/SSO
     
     
     
     
3. Save

Further information on SSO can be found here: 

iMIS Cloud SSO: 

https://help.imis.com/professional/Features/Settings/Contacts/Single_Sign_On__SSO_.htm#Testing_the_Single_Sign-On_connection 

iMIS 2017 SSO: https://help.imis.com/imis2017/Features/RiSE/Maintenance/Single_Sign_On.htm 

Create the iMIS SSO Redirect Page 

1. Go to RiSE > Page Builder > Manage content
2. Create a new content record (New > Website Content)
3. Title:  Give the content record a Title. ie. webcastcloud-sso
4. From a content record, select Add content
5. Open the Contact folder, then select the Single Sign-On content item created in the step above
   
   
6. Select webcastcloud from the Client application list
7. Click OK
8. Select Properties tab
9. Turn on Content is Secure
10. Enable Content requires user to login
11. Click Save & Publish
12. Select Generate Full URL
13. Copy the URL
14. You now want to use this URL in two locations:
    1. Add the redirect link to any location in your iMIS website. When the link is clicked, the contact will remain logged in with their same iMIS credentials.
    2. Follow the steps below to add the URL to webcastcloud Admin as your Login URL 

Add iMIS Login URL to webcastcloud

• Using the  SSO Login URL above, In webcastcloud Admin, browse to Video Library > Registrations
• Under Local Authentication Settings, ensure the following are set:
  1. Local Registration - Off
  2. Local Login - Off
  3. Email is username - Off
     
     
• Open Integration Authentication Settings from the collapsible menu
• Turn On 'Integration Provider Login Button'
• Login URL: Paste the iMIS SSO Login URL from the steps above
• Logout URL:  Your iMIS site should already have a logout url which you cad add here
• Login Button Text:  set the text that will appear on your login button. ie. Member Login, Login, Join, etc.
• Save
  
  
  When you browse to your video library as an anonymous user, you should now see your Login button and will be redirect to iMIS Login page for Single Sign-On.

Create or Modify IQAs

IQAs are required to pull retrieve additional membership details and member groups.  

We require as a minimum the Membership Details IQA to complete the Member Profile creation in webcastcloud.  

Please work with webcastcloud support and your iMIS Administrator to connect the correct IQAs to webcastcloud.

Add iMIS Integration Settings to webcastcloud

Once iMIS is setup, copy the client applications and IQAs to the following location:

1. In webcastcloud Admin, browse to Settings >Integration 
2. Edit iMIS
   
   
   
3. Provider Name: Add your company name or application.  This is not used in the configuration.
4. REST Client: https://<yourwebsite.org>/asi.scheduler_AAPA
5. Member Detail IQA: This is your IQA endpoint where we retrieve membership information. 
   example only: $/EventManagement/DefaultSystem/Queries/ContactByEmail
6. Membership Groups IQA: THis is your IQA endpoint where we retrieve member groups
   example only: $/EventManagement/DefaultSystem/Queries/membergroups
7. Client ID & Client Secret:  paste the details create in iMIS SSO Application
8. Save

Your webcastcloud and iMIS SSO and Advanced Configuration should now be complete.