OAuth Consumers Konfiguration für requisis Produkte
Wie werden OAuth Consumer-Schlüssel in der JTS-Anwendung der Jazz Platform angelegt, um die Kommunikation von requisis_MiX oder der requisis_Toolbox mit DNG/DNX zu ermöglichen.
Damit requisis_MiX oder die requisis_Toolbox mit DNG kommunizieren können, müssen Sie für jedes Tool einen OAuth-Consumer-Schlüssel und einen geheimen Schlüssel in der JTS-Anwendung der Jazz-Plattform einrichten.
Richten Sie den OAuth-Consumer-Schlüssel und den geheimen Schlüssel nicht in der RM-Anwendung (DNG/DNX) ein!
Falls Sie die JTS Anwendung noch nicht kennen: Diese könne Sie mithilfe ihrer DNG URL erreichen, entfernen Sie das /rm in der URL und ersetzen Sie dies durch /jts und drücken Enter.
Um die OAuth-Consumers einzurichten, klicken Sie oben links auf Server und dann im Menü links im Bereich Kommunikation auf Consumer (eingehend)

Es erscheint dann dieses Formular, um neue OAuth-Consumer anzulegen:

- Hier erscheint später der Consumer-Schlüssel.
Dieses Feld können Sie erst einmal ignorieren. - Legen Sie hier einen Nutzernamen für die Software fest, die diese OAuth Daten später verwenden soll.
- Geheim Consumer-Schlüssel festlegen: Wählen Sie einen Geheimschlüssel aus Groß- und Kleinbuchstaben und Zahlen. Sonderzeichen werden nicht unterstützt!
- Wiederholen Sie den Geheimschlüssel aus 3.
- Aktivieren Sie die Checkbox Vertrauenswürdig.
- Klicken Sie auf den Button Registrieren, um den Consumer-Schlüssel zu generieren und zu autorisieren. Dieser erscheint dann bei 1.
Für die Einrichtung ihres requisis Produkts benötigen Sie im weiteren Verlauf den Consumer-Schlüssel (1.) und den Geheimen Consumer-Schlüssel (3.). Folgen Sie nun den Anweisungen in der entsprechenden Spalte des Tools das konfiguriert werden soll:
| requisis_MiX | requisis_Toolbox (ReqIF-Manager) |
Öffnen Sie die Datei configuration.json mit einem Editor (z.B. Notepad++). Die Datei befindet sich im Unterordner /php/conf ihrer requisis_MiX Installation. |
Öffnen Sie die Datei mix-config.json mit einem Editor (z.B. Notepad++). Die Datei befindet sich im Unterordner /store/toolbox/config des initialen requisis_Toolbox Ordners. |
| In der Datei finden Sie den Bereich serverTargets. Hier werden die DNG Server konfiguriert, mit denen sich requisis_MiX verbinden darf. Dafür konfigurieren Sie mind. die folgenden drei Werte je Server. | In der Datei finden Sie den Bereich serverTargets. Hier werden die DNG Server konfiguriert, mit denen sich die requisis_Toolbox verbinden darf. Dafür konfigurieren Sie mind. die folgenden drei Werte je Server. |
"targetUrl": Ergänzen Sie den vorhandenen Platzhalter um die Domain des zu erreichenden Jazz Servers. Sie können diese aus der Adressleiste des Browsers kopieren, in dem Sie die OAuth Consumers konfiguriert haben. |
"targetUrl": Ergänzen Sie den vorhandenen Platzhalter um die Domain des zu erreichenden Jazz Servers. Sie können diese aus der Adressleiste des Browsers kopieren, in dem Sie die OAuth Consumers konfiguriert haben. |
Des Weiteren passen Sie die beiden folgenden Werte "oauth_clientId": "tbd" und "oauth_clientSecret": "tbd"an. |
Des Weiteren passen Sie die beiden folgenden Werte "oauth_clientId": "tbd" und "oauth_clientSecret": "tbd"an. |
| Ersetzten Sie das tbd bei oauth_clientID durch den Consumer-Schlüssel (1.) | Ersetzten Sie das tbd bei oauth_clientID durch den Consumer-Schlüssel (1.) |
| Ersetzen Sie das tbd bei oauth_clientSecret durch den Geheimen Consumer-Schlüssel (3.) | Ersetzen Sie das tbd bei oauth_clientSecret durch den Geheimen Consumer-Schlüssel (3.) |
| Speichern Sie die Datei ab. requisis_MiX kann sich jetzt mit dem DNG Server verbinden. | Speichern Sie die Datei ab. Die requisis_Toolbox kann sich jetzt mit dem DNG Server verbinden. |
| Weitere Informationen erhalten Sie in den Adminhandbuch Kapiteln 3.4 und 3.5 | Weitere Informationen erhalten Sie in den Adminhandbuch Kapiteln 4.1 und 4.2 |