Sage X3: 5. Anmeldung in der Cloud
Voraussetzungen
- Ein Sage-X3-Zugang mit Administrationsrechten
- Ein X3-Benutzer, unter dem der Sync laufen soll
In der Sage-Cloud melden sich Menschen über SageId an, in der Regel mit einem zweiten Faktor. Ein Dienst kann das nicht. Sage sieht dafür die verbundene Anwendung vor: Sie legen in Sage X3 eine Anwendung an, erhalten dafür eine Kennung und einen geheimen Schlüssel, und der Sync-Dienst weist sich damit bei jedem Aufruf aus. Ein Kennwort wird dabei nirgends übertragen.
Die verbundene Anwendung anlegen
Melden Sie sich in Sage X3 mit einem Administratorkonto an.
Öffnen Sie über das Kompass-Symbol das Navigationsmenü und wählen Sie den Bereich „Administration". Klicken Sie in der Spalte „Authentifizierung" auf „Verbundene Anwendungen". Findet sich der Eintrag nicht, tippen Sie „Verbundene" in die Menüsuche.
Klicken Sie auf „Neue verbundene Anwendung" und füllen Sie die Felder aus. Die Feldliste unten erklärt jedes einzeln.
Speichern Sie. Erzeugen Sie danach über die Aktion „Geheimen Schlüssel neu generieren" den Schlüssel und kopieren Sie ihn sofort an einen sicheren Ort.
Die Felder der verbundenen Anwendung
| Feld | Bedeutung |
|---|---|
| Client-ID* | Die Kennung der Anwendung. Diesen Wert tragen Sie später im Sync-Dienst ein. |
| Geheimer Schlüssel* | Der Schlüssel, mit dem der Sync-Dienst seine Anfragen unterschreibt. Er wird nie übertragen und nur einmal angezeigt. |
| Zulässiger Benutzer* | Der X3-Benutzer, unter dem die Aufrufe laufen. Seine Berechtigungen gelten für alles, was der Sync tut. Dieser Wert gehört im Sync-Dienst in das Feld „Benutzer" — ohne ihn weist Sage X3 jede Anmeldung ab. |
| Gültigkeit der Tokens* | Wie lange ein Ausweis gültig ist, in Sekunden. 300 hat sich bewährt. Der Sync-Dienst erneuert ihn selbstständig, bevor er abläuft. |
| Aktiv* | Muss gesetzt sein, sonst wird die Anwendung nicht anerkannt. |
| URL | Die Adresse der aufrufenden Anwendung. Reine Beschreibung, sie beeinflusst die Anmeldung nicht. |
* Pflichtfeld
Die Werte im Sync-Dienst hinterlegen
Öffnen Sie die Konfigurations-Oberfläche des Sync-Dienstes und wählen Sie Ihre Verbindung aus.
Stellen Sie „Bereitstellung" auf „SaaS" und den „Zugriffsweg" auf „GraphQL".
Tragen Sie unter „API-URL" die Adresse Ihrer Instanz ein — nur Adresse, ohne angehängten Pfad, zum Beispiel https://ihre-instanz.eu.sagex3.com
Wählen Sie als Anmeldung „Connected Application (Token)" und tragen Sie Client-ID, geheimen Schlüssel und unter „Benutzer" den zulässigen Benutzer der Anwendung ein.
Klicken Sie beim Feld „Endpoint" auf „Laden". Der Dienst holt die vorhandenen Endpoints aus Ihrer Installation. Wählen Sie den Ordner aus, mit dem Sie arbeiten.
Setzen Sie „Token-Gültigkeit" auf denselben Wert wie in der verbundenen Anwendung, höchstens jedoch darauf. Speichern Sie und klicken Sie auf „Verbindungen prüfen".