Integrate Bonusly

Note: This guide was tested using Identity as a Service 5.37 and Bonusly. Other versions of Bonusly may require integration and configuration steps that differ from those documented in this procedure. For newer versions of Bonusly, this integration guide can be used as an initial approach for integrating Bonusly. In the event of other issues, contact support@entrust.com for assistance.

To integrate Bonusly with Identity as a Service you must do the following:

Step 1: Copy the Consumer URL and App ID file from Bonusly

1. Log into your Bonusly administrator account. The Bonusly Home page appears.

2. Click Manage plan. The Plans & Billing page appears.

3. In the left-pane, click Integrations. The Integrations page appears.

4. Scroll to Single sign-on and click SAML. The SAML Integration page appears.

5. Open a text editor, such as Notepad, and copy and paste the following:

● Consumer URL

● App ID

6. Leave this window open to return to later in this procedure.

Step 2: Add Bonusly to Identity as a Service

Add Box application to Identity as a Service

1. Log into your Identity as a Service administrator account.

2. Click > Security > Applications. The Applications Lists page appears.

3. Click Add. The Select an Application Template page appears.

4. Do one of the following:

● Select SAML Cloud Integrations from the search drop-down list and scroll to find the application you want to add to IDaaS.

- or -

● In the Search bar, enter a search option to filter for the application you want to add to IDaaS.

5. Click Bonusly. The Add Bonusly page appears.

6. Enter an Application Name.

7. Enter an Application Description.

8. Optional. Add a custom application logo.

a. Click next to Application Logo. The Upload Logo dialog box appears.

b. Click to select an image file to upload.

c. Browse to select your file and click Open. The Upload Logo dialog box reappears showing your selected image.

d. If required, resize your image.

e. Click OK.

9. Select the Authentication Flow that appears to users during login.

10. Click Next. The General page appears.

11. In the Default Consumer Service URL field, enter the Consumer URL you copied in Step 1: Copy the Consumer Service URL and App ID from Bonusly.

12. In the Service Provider Entity ID (Issuer) field, enter the Consumer URL you copied in Step 1: Copy the Consumer Service URL and App ID from Bonusly.

13. From the SAML NameID Attribute drop-down list,select Email.

14. Select the SAML Signing Certificate from the drop-down list.

15. Leave the remaining settings at the default values.

16. Click Submit.

Step 3: Add a resource rule

Step 4: Copy the Public Endpoint from Identity as a Service

Download the Metadata file from Identity as a Service

1. In Identity as a Service, click > Security > Applications. The Applications List page appears.

2. Do one of the following:

● Click next to the application you are integrating with Identity as a Service.

–or–

● Click next to the application you are integrating with Identity as a Service and select SAML IDP Metadata.

The SAML Application Metadata dialog box appears.

3. Select the certificate to include in the SAML IDP Metadata file from the drop-down list.

4. If applicable, Select the domain to include in the SAML IDP Metadata file from the drop-down list.

5. Enter the Lifetime, in days, for the SAML IDP Metadata file. The value must be between 2 and 730.

6. Do one of the following, as required:

a. Copy the Public Endpoint to paste into your SAML application being used Identity Provider authentication.

b. Click Download.

Note: If you are using multiple domains, you must download each domain's metadata file separately because the values in the metadata file vary for each domain.

Copy the SAML Configuration from Identity as a Service

1. Log into your Identity as a Service administrator account.

2. Click > Security > Applications. The Applications Lists page appears.

3. Under SAML Cloud Integrations, click SAML Configuration. The SAML Configuration dialog box appears.

This dialog box contains information you need to configure your SAML application for Identity as a Service authentication.

4. Do one of the following:

● Leave this dialog box open to reference later in this procedure.

● Copy the Entity ID, Single Sign-on URL, and Single Logout URL to a text file and save it to reference later in this procedure.

Note: Depending on the integration you are performing, you may not need all three of these SAML configuration values.

Step 6: Configure Bonusly for IDaaS authentication

1. Return to the SAML Integration browser window you left open in Step 1: Copy the Consumer URL and App ID from Bonusly.

2. In the IdP Metadata URL, paste the Entity ID you copied in Step 4: Copy the Public Endpoint from Identity as a Service.

3. In the Idp Issuer (Entity ID) field, paste the Entity ID you copied in Step 5: Copy the Entity ID from Identity as a Service.

4. Click Save. The SAML Integration information page appears.

5. Open a test editor, such as Notepad and copy and paste SP Issuer ID.

6. Leave this window open to return to later in this procedure.

Step 7: Paste the Bonusly SP Issuer ID into IDaaS

1. Click > Security > Applications. The Applications List page appears.

2. In the Application List under SAML Cloud Integrations, click Bonusly (or the name you assigned to the application is you used something different). The Edit Application page appears.

3. Click Next.

4. In the Service Provider Entity ID (Issuer) field, replace current value with the SP Issuer ID you copied in Step 6: Configure Bonusly for IDaaS authentication.

5. Click Submit.

Step 8: Accept an invitation from Bonusly

1. Return to the window you left open in Step 6: Configure Bonusly for IDaaS authentication.

2. In the left pane, click Go to Home. The Home page appears.

3. Click Invite at the top of the page. The Invite to Bonusly dialog box appears.

4. In the Who would you like to invite? field, enter your IDaaS admin email address.

5. Under Account permissions, select Admin access.

6. Click Send Invite.

7. Go to your email application and click Accept Invite.

8. Create and confirm a password.

9. Click Next.

Testing Service Provider Login

1. Go to https://bonus.ly/saml/ADP_ID/index (where App ID is the App ID you copied in Step 1: Copy the Consumer URL and the App ID from Bonusly.

2. Enter your Identity as a Service User ID and click Next.

3. Respond to the second-factor authentication challenge. If you respond successfully, you are logged in to the Bonusly.

Testing Identity as a Service redirect log in

1. Log in to your Identity as a Service account.

2. Go to your My Profile page if you are not already there.

3. Under Applications, click Bonusly.

4. Respond to the second-factor authentication challenge. If you respond successfully, you are logged in to Bonusly.