> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation. # Bonusly Bonusly is an employee recognition and rewards program. See . note This procedure 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, use this procedure as a starting point for integrating Bonusly. In the event of other issues, contact for assistance. To integrate Bonusly with Identity as a Service you must do the following: Before you begin, open two browser windows: one for Bonusly and one for IDaaS. ## 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 ## 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 Menu icon **>** **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. 1. Click Plus icon next to **Application Logo**. The **Upload Logo** dialog box appears. 2. Click Upload icon to select an image file to upload. 3. Browse to select your file and click **Open**. The **Upload Logo** dialog box reappears showing your selected image. 4. If required, resize your image. 5. 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,s**elect **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 See [Create resource rules](/docs/authentication-and-security/create-and-manage-resource-rules.md). ## Step 4: Copy the Public Endpoint from Identity as a Service ## 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 Menu icon **>** **Security > Applications**. The **Applications List** page appears. 2. Do one of the following: - Click Cloud Download icon next to the application you are integrating with Identity as a Service. - Alternatively, click Ellipsis Vertical icon next to the application you are integrating with Identity as a Service and select **SAML IDP Metadata**. 3. The **SAML Application Metadata** dialog box appears. 4. **Select the certificate to include in the SAML IDP Metadata file** from the drop-down list. 5. If applicable, **Select the domain to include in the SAML IDP Metadata** file from the drop-down list. 6. Enter the **Lifetime, in days, for the SAML IDP Metadata file**. The value must be between 2 and 730. 7. Do one of the following, as required: - Copy the **Public Endpoint** to paste into your SAML application being used Identity Provider authentication. - 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. ## Step 5: Copy the Entity ID from Identity as a Service ## Step 5: Copy the Entity ID from Identity as a Service Copy the SAML Configuration from Identity as a Service 1. Log into your Identity as a Service administrator account. 2. Click Menu icon **>** **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 Menu icon **>** **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**. ## Step 9: Test the integration ## Step 9: Test the integration Testing Service Provider Login 1. Go to (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.