Clustermarket Integration

Introduction

Clustermarket offers a laboratory equipment scheduling & management system. Using the eLab SDK, it is now easy
to integrate Clustermarket's solution into your eLab (on premise) instance.

This document describes how to setup the Clustermarket Integration on your on premise instance.

Setting up a new OAuth 2.0 application in Clustermarket

To connect eLabNext with Clustermarket

1. Go to https://app.clustermarket.com/oauth/applications/new
2. Fill in Name, Company Name, Website URL and your Company Logo
3. Select all Scopes
4. Check Confidential
5. Don't check Visible
6. Fill in the following Callback url: https://[your-elab-next-instance-host-url]/api/v1/oauth2/redirect
7. In CORS Domains make sure to add https://[your-elab-next-instance-host-url] (e.g. https://elab.yourorganisation.com)
8. Click Save
9. We need the values from Client ID and Client Secret in the next step
10. Contact Clustermarket in order to approve your oauth2 app.

Update Clustermarket OAuth 2.0 add-on in ELab

This step requires admin user access.

1. Go to https://[your-elab-next-instance-host-url]/admin/marketplace/addons/
2. Search for Clustermarket’s Equipment Scheduler
3. Click on the OAuth2.0 config icon
4. Check I understand and want to use my own settings.
5. Click Custom configuration
6. Add a Description
7. Fill https://app.clustermarket.com/oauth/authorize in Authorization URL
8. Fill https://app.clustermarket.com/oauth/token in Token request URL
9. Fill https://app.clustermarket.com/oauth/token in Refresh request URL
10. Fill read_user+read_accounts+read_equipment+read_bookings in Scope (use scoped you selected upon OAuth2.0 creation in Setting up a new OAuth 2.0 application in Clustermarket)
11. Paste the value ClientID from the app you created at Clustermarket
12. Paste the value from Client Secret from the app you created at Clustermarket
13. Uncheck Share configuration
14. Click Save

Use the updated configuration

1. Go to the marketplace and make sure the add-on Clustermarket’s Equipment Scheduler is installed.
2. Go to Configuration -> Equipment
3. Click on Connect to Clustermarket (this step requires the Administrator role for the current group)
4. Login to the Clustermarket account that you used in Setting up a new OAuth 2.0 application in Clustermarket
5. Select the lab that you want to connect and click Authorize