Identity Provider

Im Modus Identity Provider melden Sie sich in der App mit Ihrem Organisationskonto an, so wie Sie es von anderen Unternehmensanwendungen kennen. Die App erhält dabei ein zeitlich begrenztes Zugangs-Token und verwendet es automatisch als Kennwort gegenüber dem MQTT-Broker. Ein Broker-Kennwort muss also weder eingegeben noch auf dem Gerät gespeichert werden, und die Benutzerverwaltung bleibt zentral beim Identity Provider. Die Verbindung ist dabei immer verschlüsselt; das Serverzertifikat des Brokers wird gegen den Zertifikatspeicher des Geräts geprüft, sodass keine manuelle Zertifikatskonfiguration nötig ist.

Voraussetzungen

Der MQTT-Broker muss die Anmeldung per JSON Web Token (JWT) des verwendeten Identity Providers akzeptieren und ein Serverzertifikat verwenden, dem das Endgerät vertraut. Außerdem muss der Identity Provider aus dem Netzwerk des Endgeräts erreichbar sein. Am Identity Provider richtet der Administrator einmalig einen Client für die App ein. Die App verwendet den standardisierten OpenID Connect Authorization Code Flow mit PKCE, der Client wird daher als öffentlicher Client ohne Client Secret angelegt. Als Redirect URI ist tciot://auth/callback einzutragen, als Scopes openid, profile und offline_access. Der Scope offline_access sorgt dafür, dass die App die Anmeldung im Hintergrund verlängern kann und sich der Benutzer nicht bei jeder Verwendung neu anmelden muss.

Verbindungseinrichtung

  1. Wählen Sie in den Verbindungseinstellungen den Modus Identity Provider.
  2. Tragen Sie die Broker-Daten ein: Adresse, Port, Client-ID und Topic.
  3. Tragen Sie die Daten des Identity Providers ein: die Issuer-URL, die Client-ID des eingerichteten Clients und einen frei wählbaren optionalen Profilnamen.
  4. Tippen Sie auf Sign In. Die App öffnet den Systembrowser mit der Anmeldeseite Ihres Identity Providers. Nach erfolgreicher Anmeldung kehren Sie automatisch zur App zurück.
  5. Stellen Sie die Verbindung her.

Die Anmeldung wird anschließend im geschützten Speicher des Betriebssystems abgelegt und bleibt daher auch nach einem Neustart der App erhalten. Primär- und Fallback-Verbindung besitzen jeweils eine eigene Anmeldung. Alternativ lassen sich die Verbindungsdaten per QR-Code bereitstellen.

Identity Provider 1:

Einstellungen

Einstellung

Bedeutung

Broker Address

IP-Adresse oder Hostname des Message Brokers.

Port

Der Port der Message Brokers. Für gewöhnlich 1883 (MQTT) oder 8883 (MQTT TLS).

Timeout

Diese Einstellung gibt die Zeit an, nach der die Verbindung zum Message Broker in einen Timeout läuft. Nach dieser Zeit wird bei einer aktiven Fallback Connection die Verbindung zu dem zweiten Message Broker probiert.

Client Id

Die Client-ID der App, mit der die Verbindung zum Message Broker hergestellt wird. Wenn kein benutzerdefinierter Wert eingetragen wird, wird die eindeutige Gerätekennung des mobilen Gerätes verwendet.

Topic

Haupt-Topic, über das die Nachrichten aus dem zugehörigen SPS-Programm kommuniziert werden.

Issuer URL

Der Endpoint des Identity Providers, über den eine Verbindung hergestellt werden kann.

Client ID

Die Client ID, die der App im Identity Provider zugewiesen ist.

Profile Name (optional)

Optionaler Profilname.

Gültigkeit der Anmeldung

Solange die App geöffnet ist, erneuert sie das Zugangs-Token automatisch im Hintergrund. Wie lange die Anmeldung insgesamt gültig bleibt, legt ausschließlich der Identity Provider fest; die App verwendet keine eigene Zeitbegrenzung. Läuft die Sitzung dort ab, meldet die App, dass eine erneute Anmeldung erforderlich ist – ein Tippen auf Sign In genügt dann. Soll dieser Zeitraum verlängert oder verkürzt werden, passt der Administrator die Sitzungsdauer am Identity Provider an (bei Keycloak sind das bspw. Offline Session Idle und Offline Session Max). Über Sign Out wird die gespeicherte Anmeldung vollständig vom Gerät entfernt.