Bonusly cloud application

1. Sign in to your Google Admin console.

   Sign in using an account with super administrator privileges (does not end in @gmail.com).

2. From the Admin console Home page, go to AppsWeb and mobile apps.
3. Click Add appSearch for apps.
4. Enter Bonusly in the search field.
5. In the search results, hover over the Bonusly SAML app and click Select.
6. On the Google Identity Provider details page:
   • Copy and save the SSO URL and Entity ID.
   • Download the Certificate.

   Leave the Admin console open, you'll continue with the configuration wizard after performing the next step in the Bonusly application.

1. Open a new incognito browser window.
2. Sign in to Bonusly with your organization's Bonusly administrator account.
3. Click Admin at top right.
4. Click the Integrations tab.
5. In the Single Sign-On section, click SAML.
6. Copy and save the App ID. You'll need this value when you finish configuration in the Admin console in the next step.
7. Enter information in the following fields:
   • IdP Issuer (Entity ID): the Entity ID you copied in Step 1.
   • IdP SSO Target URL: the SSO URL you copied in Step 1.
   • x.509 Cert:  the certificate you downloaded in Step 1.
8. Click Save.
9. (Optional) If you want your users to sign in to Bonusly only through SSO, also do the following:
   1. Click the Admin tab.
   2. At the bottom of the Configure Company page, click Show advanced settings.
   3. Next to Login Methods, check Restrict to Single Sign On.

1. On the Google Identity Provider details page, click Continue.
2. On the Service provider details page, edit the default ACS URL, replacing {your_subdomain} with the App ID you copied from Bonusly in Step 2.
3. Click Continue.

   Note: Attribute mapping is not required for Bonusly.

4. On the Attribute mapping page, click Finish.

1. Sign in to your Google Admin console.

   Sign in using an account with super administrator privileges (does not end in @gmail.com).

2. From the Admin console Home page, go to AppsWeb and mobile apps.
3. Select Bonusly.
4. Click User access.

5. To turn on or off a service for everyone in your organization, click On for everyone or Off for everyone, and then click Save.

6. (Optional) To turn a service on or off for an organizational unit:

   1. At the left, select the organizational unit.
   2. Select On or Off.
   3. Click Override to keep your setting if the service for the parent organizational unit is changed.
   4. If Overridden is already set for the organizational unit, choose an option:
      • Inherit—Reverts to the same setting as its parent.
      • Save—Saves your new setting (even if the parent setting changes).

   Learn more about organizational structure.

7. (Optional) Turn on the service for a group of users.
   Use access groups to turn on a service for specific users within or across your organizational units. Learn more

8. Ensure that your Bonusly user account email IDs match those in your Google domain.

Bonusly supports both Identity Provider (IdP) initiated and Service Provider (SP) initiated SSO. Follow these steps to verify SSO in either mode:

IdP-initiated

1. Sign in to your Google Admin console.

   Sign in using an account with super administrator privileges (does not end in @gmail.com).

2. From the Admin console Home page, go to AppsWeb and mobile apps.
3. Select Bonusly.
4. At the top left, click Test SAML login. 

   Bonusly should open in a separate tab. If it doesn’t, use the information in the resulting SAML error messages to update your IdP and SP settings as needed, then retest SAML login.

SP-initiated

1. Close all browser windows.
2. Open https://bonus.ly/users/sign_in_start and attempt to sign in. You should be automatically redirected to the Google sign in page.
3. Enter your sign in credentials.
4. After your sign in credentials are authenticated, you are automatically redirected back to Bonusly.

As a super administrator, you can automatically provision users in the Bonusly application.