Team Owner

How To Set up SSO

 

SSO (Single Sign-On) authentication allows your team members to securely log into the Teams by Swivl app or web platform with ease and simplicity. Teachers, coaches, and students use their institutional login and password to access their Swivl Team account. It is a time-saving, convenient, and secure process of logging in and using Swivl Solution.

 

We support all SSO providers which can act as a SAML Identity Provider

To set up SSO please forward this article to your IT department

Information we need from you as the Identity Provider

  1. Identity Provider Name (example: TTU)
  2. Email domain (example: ttu.edu)
  3. Entity ID (example: https://idp.shibboleth.ttu.edu/idp/shibboleth)
  4. URL to metadata.xml (example: https://idp.shibboleth.ttu.edu/idp/shibboleth)
  5. Email this information to your primary Swivl contact or to support@swivl.com

What needs to be configured on your side

Create a new Service Provider profile with the following settings:

  1. Service Provider Name: Swivl Cloud
  2. Entity ID: https://cloud.swivl.com/sso
  3. ACS URL: https://cloud.swivl.com/sso/login_check
  4. Metadata: http://cloud.swivl.com/sso/metadata.xml
  5. Required user profile attributes:
    1. John Smith
    2. Smith John
    3. Smith, John
    1. First name
    2. Last name
    3. Full name - in one of the following formats:
    4. Email address (attribute name: uid)

How to test the SSO connection

  1. Visit page https://cloud.swivl.com/sso/login
  2. Enter Email address in your domain and press the “Sign in” button
  3. You should be redirected to your IdP sign in page
  4. Sign in on IdP using your credentials
  5. You should then be redirected back to Swivl Teams
  6. Notify us about successful SSO connection test and we will setup attribute mapping on our side
  7. Sign in with SSO again and you should see the correct First and Last name.

 

MS Azure SSO integration with Swivl Teams

  • To configure Azure AD integration, you must be an administrator in Azure and have the Admin account (not Co-Admin) in AlertSite.

    To create an application  in Azure AD, follow the next steps:

    1. Log in to the your Azure portal as an administrator: https://portal.azure.com/

    2. Go to Azure Active Directory:

    02.png 

    3. Select Enterprise Applications:

    03.png

    4. Click New application.

    04.png

    5. On the Add an application page, choose Non-gallery application.

    6. In the Name field enter Swivl Teams. Click Add or Create.

    06.png

    7. Select Single sign on and select SAML.

    07.png

    8. On the Single sign-on page, click the edit button at the top right of the Basic SAML Configuration section. 

    08.png

    9. Under basic SAML configuration section, perform the following steps:

    09.png

    10. Click the edit button next to User Attributes & Claims and configure the Claims for the application:

    10.png

    11. Check and update the Claims if needed:

     

    givenname

     

    surname

     

    email address

    11.png

     

    12. Download the Federation Metadata XML file and keep it handy. You'll need this in the next step.

    12.png

    Setup SSO connection with Swivl Platform

    Information we need from you as the Identity Provider:

    1. Identity Provider Name (example: TTU)
    2. Email domain (example: ttu.edu)
    3. Send us URL to metadata.xml file downloaded on the step 12(example: https://idp.shibboleth.ttu.edu/idp/shibboleth)
    4. Email this information to your primary Swivl contact or to support@swivl.com

     

    How to test the SSO connection:

    1. Visit page https://cloud.swivl.com/sso/login
    2. Enter Email address in your domain and press the “Sign in” button
    3. You should be redirected to your IdP sign in page
    4. Sign in on IdP using your credentials
    5. You should then be redirected back to Swivl Teams
    6. Notify us about successful SSO connection test and we will setup attribute mapping on our side
    7. Sign in with SSO again and you should see the correct First and Last name.

     

 

For additional help, email support@swivl.com

Updated

Was this article helpful?

3 out of 6 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.