myMedax unterstützt unterschiedliche Benutzerrechte und hat dazu eine integrierte Benutzerverwaltung.
Um den myMedax Client und andere externe Schnittstellen nutzen zu können kann für jeden Benutzer ein “Token” erstellt werden.
1. Benutzeranlage
Zur Anlage eines neuen Benutzers öffnen Sie in der myMedax Verwaltungsoberfläche den Hauptmenüpunkt Benutzer - Neu anlegen.
2. Benutzer verwalten / Berechtigungen setzen
Um bestehende Benutzer zu verwalten oder die Berechtigungen zu verändern öffnen Sie in der myMedax Verwaltungsoberfläche den Hauptmenüpunkt Benutzer - Liste.
3. Token erstellen
Um einen Token, eine Art universellen Schlüssel mit dem technische Dienste ohne Kenntnis des Bentuzernamens und des zugehörigen Kennworts auf myMedax zugreifen können, erstellen zu können benötigen Sie 3 Angaben:
ihren Benutzernamen, in der Regel in Form eine Mailadresse
das zugehörige Kennwort
das UMS Shared Secret
Benutzername und Kennwort ist den Benutzern in der Regel bekannt.
Da Token ein sehr mächtiger und sicherheitssensitiver Schlüssel zum System sind wird als weiterer Faktor noch das “UMS Shared Secret” benötigt. Dies kennt in der Regel nur der Administrator oder mit der Administration betraute Personen.
Wenn Sie alle 3 Angaben haben öffnen Sie in der myMedax Verwaltungsoberfläche, sofern Sie das Recht zur Benutzerverwaltung haben, den Menüpunkt “Auth Token”.
Geben Sie dort alle 3 Komponenten ein und klicken auf “Token erstellen”:
Wenn die Angaben zueinander passen erhalten Sie den Token:
Bitte kopieren sie den Token und notieren den an einem separaten Ort. Ein Token ist nicht wieder herstellbar, sollte er verloren gehen müssen sie ihn neu erstellen. (Das können Sie erkennen, jedes Mal wenn sie auf Token erstellen klicken verändert sich der Wert unten).
Wichtig: Tokengültigkeit
Wenn Sie den Token ändern / neu erstellen verlieren alle bisherigen Token, die mit diesem Benutzernamen erzeugt wurden, ihre Gültigkeit.
Wenn sie das Passwort des Benutzers ändern verlieren alle damit erzeugten Token ihre Gültigkeit
Wenn sie (als Administrator) das UMS Shared Secret ändern verlieren alle damit erzeugten Token ihre Gültigkeit
Das bedeutet dass Sie an allen Stellen, an denen Sie dieses Token verwendet haben, das dann neu erzeugte Token nochmal manuell neu eintragen müssen (z.B. im myMedax-Client an allen betroffenen Arbeitsplätzen, z.b. bei der Benutzung der RestAPI, etc.).