Configuring sites: Brokering

Configuring a broker

Once you have configured a broker in Lens, this broker then needs to be associated with a site. This is because a single broker can be responsible for multiple sites. Or each site may need its own broker. It completely depends on the environment and the configuration of the Lens platform.

To set up a broker for the site:

1. Login to the application

2. In the left sidebar, select Configuration then click the Settings option

3. Select the Manage site item from the Sites and Collectors section

4. Select the site you would like to edit from the dropdown menu

5. Click the Brokering tab

6. Scroll down to the Broker section

7. In the Use broker configuration field, select the broker configuration you created previously. See this article for more.

8. Scroll to the bottom of the page

9. Click the Save button

Leostream specific options

Webhooks

Webhooks help make the Lens application smarter. As Lens is not a connection broker, we do not always know when certain events happen. If the broker supports it, then it’s highly recommended to configure webhooks.

Set the session start webhook

1. In the General tab

2. Check the Send HTTP GET request at start of session option

3. In the URL to call at start of session field, enter the webhook from the Infrastructure healthcheck webhook button in Lens. Leave the Timeout in seconds field at 5.
   

Set the session start webhook

1. In the General tab

2. Click the :3_dot_menu: button next to the pool you want to configure, and then select Edit from the menu

3. In the modal, scroll down to the When User is Assigned to Desktop section

4. Check the Send HTTP GET request option

5. In the URL to call at assignment time field, enter the webhook from the Session start webhook button in Lens. Leave the Timeout in seconds field at 5.

Set the session end webhook

1. Login to the Leostream UI

2. In the left sidebar, go to Configuration and then select Release Plans

3. Find the plan you want to edit, and click the Edit link

4. Scroll to the When User Disconnects from Desktop section

5. In the URL to call field, enter the webhook from the Session end webhook button

6. Click the Save button

Importing broker desktops

This will show all desktops that are present in Leostream, even if they are not found in another supported platform. This can be useful for displaying workstations in Lens that are supported by Leostream but not supported natively by Lens. To enable this feature:

1. Login to the application

2. In the left sidebar, select Configuration then click the Settings option

3. Select the Manage site item from the Sites and Collectors section

4. Select the site you would like to edit from the dropdown menu

5. Click the Brokering tab

6. Scroll down to the Workstations section

7. Enable the Import workstations from broker when not found via other platforms toggle

8. Scroll to the bottom of the page

9. Click the Save button