Set Up d.velop Client (Cloud Variante d.velop)

Das Ziel dieser Anleitung ist es, amberSearch den Zugriff auf die D.velop-Umgebung zu ermöglichen. Dazu benötigt amberSearch ein d.velop-Konto und einen API-Schlüssel. Darüber hinaus benötigt amberSearch eine Verbindung zu d.velop über ein OpenID-Protokoll, um Single Sign On zu ermöglichen. Im Folgenden werden die erforderlichen Schritte visuell beschrieben.

Schritt 1. Erstellen Sie ein neues d.velop-Konto für amberSearch.

1.1 Gehen Sie zu „Konfiguration“, dann zu „Verwaltung“ und anschließend zu „Benutzer und Gruppen“.

1.2 Neuen Benutzer erstellen

1.3 Lesezugriff für alle (relevanten) Dateien gewähren

1.4 Gewähren Sie dem erstellten Benutzer Administratorberechtigungen (dies ist erforderlich, um die notwendigen Informationen aus der Dvelop-API abzurufen und die Daten zu indexieren).

Schritt 2. Erstellen Sie einen API-Schlüssel

2.1 Gehen Sie zu „Konfiguration“, dann zu „Infrastruktur und Sicherheit“ und anschließend zu „Anmeldeoptionen“.

2.2 Klicken Sie auf das Fingerabdruck-Symbol, wie im Screenshot unten gezeigt.

2.3 Erstellen Sie einen neuen API-Schlüssel.

2.4 Wählen Sie das Benutzerkonto „amberSearch“ aus.

2.5 Gehen Sie zurück zur vorherigen Seite und wählen Sie den neu erstellten API-Schlüssel aus.

2.6 Kopieren Sie den API-Schlüssel.

2.7 Geben Sie den kopierten Wert über das folgende Formular an das amberSearch-Team weiter. Wenn das Formular nicht geladen wird, können Sie es auch hier aufrufen.

Schritt 3. Erstellen Sie eine OpenID-Verbindung.

3.1 Gehen Sie zu „Konfiguration“, dann zu „Infrastruktur und Sicherheit“ und anschließend zu „Einstellung des OpenID-Providers“.

3.2 Klicken Sie auf die Schaltfläche „+“, um eine neue Verbindung zu erstellen.

3.3 Konfigurieren Sie die OpenID-Verbindung. Der Name sollteamberSearch lauten. Die Weiterleitungs-URL wird Ihnen vom amberSearch-Team zur Verfügung gestellt. Anschließend speichern.

3.4 Es öffnet sich ein Dialogfenster. Kopieren Sie die Client-ID und den Client-Secret (Clientschlüssel) und geben Sie diese an das amberSearch-Team weiter. Verwenden Sie dazu bitte das Formular unterhalb des Screenshots. Sollte das Formular nicht geladen werden, können Sie es auch hier aufrufen.

Hinweis: Aus Sicherheitsgründen fragen wir Sie nicht über das Formular nach dem Wert des Client-Secret. Stattdessen bitten wir Sie, uns diesen per Nachricht an Teams oder per Telefon+49 176 6655 6538 (Handynummer der IT-Abteilung von amberSearch). Wenn Sie die Informationen per Telefon übermitteln möchten, geben Sie bitte Ihren Namen/Firmennamen an, damit wir wissen, wem diese Nummer zuzuordnen ist.

3.5 Kopieren Sie auf der Übersichtsseite der verfügbaren OpenID-Verbindungen die Endpunkt-URLs und geben Sie diese an das amberSearch-Team weiter.

Abschließende Checkliste

Fügen Sie das amberSearch-Konto zu d.velop hinzu.

Geben Sie die Anmeldedaten des amberSearch-Kontos an das amberSearch-Team weiter.

Geben Sie den API-Schlüssel an das amberSearch-Team weiter.

Geben Sie die Client-ID und den geheimen Client-Schlüssel an das amberSearch-Team weiter.

Stellen Sie dem amberSearch-Team die URLs der OpenID-Endpunkte zur Verfügung.

Wenn Sie Hilfe benötigen, wenden Sie sich bitte an uns über IT@ambersearch.de

Die Englische Version für das Set Up des d.velop Client ist hier zu finden.