Zugriffsschlüssel; Zugriffsschlüssel Über Eine Externe Anwendung Erstellen; Zugriffsschlüssel Über Weboberfläche Erstellen - TQ Energy Manager EM420 Benutzerhandbuch

App „JSON-Schnittstelle"
15.6 Zugriffsschlüssel
15.6.1 Zugriffsschlüssel über eine externe Anwendung erstellen
Im ersten Schritt stellt die Anwendung eine Authentisierungs-Anfrage an den Energy
Manager. Die Anfrage erfolgt mittels einer HTTP-POST-Nachricht an einen definierten
API-Endpunkt:
-----------------------------------------------------------------
POST /api/access-token/token HTTP/1.1
Host: <energy manager>
Content-Type: application/json
{
„name":"a-unique-device-name",
„expires_at":""
}
-----------------------------------------------------------------
Die Nachricht enthält den Namen der Anwendung oder des Geräts, das die JSON-
Schnittstelle verwenden soll. Der Energy Manager beantwortet die Anfrage mit
einem Zugriffsschlüssel:
-----------------------------------------------------------------
HTTP/1.1 200 OK
Content-Type: application/json
„eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9[..]"
-----------------------------------------------------------------
Mit Hilfe dieses Zugriffsschlüssels identifiziert sich eine Anwendung gegenüber dem
Energy Manager während einer API-Anfrage. Dieser Zugriffsschlüssel ist mit einem
Passwort vergleichbar und sollte dementsprechend behandelt werden. Dieser Zu-
griffsschlüssel kann nicht noch einmal erhalten oder angezeigt werden und sollte
nach Erhalt sicher abgespeichert werden.
15.6.2 Zugriffsschlüssel über Weboberfläche erstellen
Alternativ kann ein neuer Zugriffsschlüssel auch über die Weboberfläche erzeugt
werden.
Die Funktionalität zum Erstellen und Verwalten von Zugriffsschlüsseln ist über die
Funktion „Profil" im Kopf der Anwendung erreichbar. Ein Klick auf „Profil" öffnet ein
Drop-Down-Menü, das unter anderem die Option „Zugriffsschlüssel" enthält. Durch
Auswahl der Option „Zugriffsschlüssel" öffnet sich die Ansicht zur Verwaltung von
Zugriffsschlüsseln.
Durch einen Klick auf „HINZUFÜGEN" öffnet sich ein Fenster, in dem Name und Ab-
laufdatum des Zugriffsschlüssels festgelegt werden können. Nach dem Erstellen wird
der Zugriffsschlüssel einmalig angezeigt. Es kann nicht noch einmal erhalten oder
angezeigt werden und sollte daher kopiert und sicher abgespeichert werden.
58 Rev0100 DE | EM420-Softwareversion 3.0.0
Energy Manager EM420
Benutzerhandbuch