The goal of these instructions is to enable amberSearch to access the D.velop environment. For that amberSearch needs a d.velop account and an API key. Furthermore, amberSearch needs a connection to d.velop via an OpenID protocol to enable the Single Sign On. In the following, the necessary steps are visually described.
Step 1. Create a new d.velop account for amberSearch
1.1 Go to the Configuration (Konfiguration), then Administration (Verwaltung) and then Users and groups (Benutzer und Gruppen)
1.2 Create a new user
1.3 Grant read permissions to all (relevant) files
Step 2. Create an API Key
2.1 Go to Configuration (Konfiguration), then go to Infrastructure and security (Infrastruktur und Sicherheit) and then Login options (Anmeldeoptionen)
2.2 Click on the fingerprint Icon as shown in the screenshot below 2.3 Create a new API key 2.4 Select the amberSearch user account
2.5 Go back to the previous page and select the newly created API key
2.6 Copy the API key
2.7 Provide the copied value to the amberSearch Team via the following form. If the form doesn't load, you can also access it here.
Step 3. Create an OpenID connection
3.1 Go to Configuration (Konfiguration), then Infrastructure and security (Infrastruktur und Sicherheit) and then Setting OpenID-provider (Einstellung des OpenID-Providers)
3.2 Click on the + button to create a new connection
3.3 Configure the OpenID connection. The name should be
amberSearch, Redirect-URL (Weiterleitungs-URL) will be provided to you by the amberSearch Team. Then save.
3.4 A dialog window will pop up. Copy the Client-ID and Client Secret (Clientschlüssel) and provide them to the amberSearch team. To do so, please use the form below the screenshot. If the form doesn't load, you can also access it here.
Note: For security reasons we do not ask you for the value of the client secret via form. Instead, we kindly ask you to send it to us via message in Teams or via phone+49 176 6655 6538 (Mobile number of amberSearch's IT-department). If you choose to send the information via phone please include your name/company name so we know who to link with that number.
3.5 At the overview page of the available OpenID connections copy the endpoint URLs and provide them to the amberSearch team
Add the amberSearch account to d.velop
Provide the credentials of the amberSearch account to the amberSearch Team
Provide the API key to the amberSearch Team
Provide the Client-ID and Client secret to the amberSearch Team
Provide the OpenID endpoints URLs to the amberSearch Team
If you need assistance please reach out to us via IT@ambersearch.de