Authentifizierung für eine Offline-App in Jitterbit App Builder konfigurieren

Einleitung

Die Authentifizierung für eine Offline-App erfordert Konfigurationsschritte in der Core-App und der Offline-App. Diese Seite beschreibt diese Schritte und wie man sie testet.

Core-App

Wenn sich ein Benutzer bei einer Offline-App anmeldet, wird er über die zugeordnete Core-App autorisiert und erhält Berechtigungen. Um dies zu ermöglichen, müssen Sie Folgendes in der Core-App konfigurieren:

Eine Sicherheitsanbietergruppe. Dies ermöglicht der Offline-App den Zugriff auf die Core-App über den Autorisierungsserver.
Ein Autorisierungssicherheitsanbieter.
Ein Client.

Sicherheitsanbietergruppe

Sie sollten eine Sicherheitsanbietergruppe in Ihrer Entwicklungsumgebung erstellen und diese dann mithilfe der üblichen Anwendungspaket-Verwaltungsmethode in Ihre QA- oder Produktionsumgebungen propagieren.

So erstellen Sie eine Sicherheitsanbietergruppe:

Öffnen Sie Ihre Core-App zur Bearbeitung.
Wählen Sie App Workbench aus dem Action Drawer oder Workbench aus dem Anwendungsmenü und klicken Sie auf Roles.
Klicken Sie auf die Schaltfläche Application Groups, um das Dialogfeld Group und Roles zu öffnen.
Klicken Sie unter Group auf die Schaltfläche Create.
Geben Sie einen Namen (z. B. Offline App Security Provider) und eine Beschreibung für die Gruppe ein und klicken Sie auf das Symbol , um es zu speichern.
Schließen Sie das Dialogfeld.

Tipp

Diese Gruppe stellt keine Berechtigungen bereit, sondern die Zuordnung der Gruppe zum Sicherheitsanbieter, die im nächsten Abschnitt erfolgt.

Autorisierungssicherheitsanbieter

Der Autorisierungssicherheitsanbieter ermöglicht OpenID-Authentifizierung für die Offline-App. Er muss in jeder Umgebung konfiguriert werden, mit der sich die Offline-App authentifizieren könnte.

So konfigurieren Sie einen Autorisierungssicherheitsanbieter:

Wählen Sie IDE > Security Providers.
Klicken Sie im Bereich Security Providers auf das Symbol am Ende der Zeile Authorization Server, um den Datensatz zu öffnen.
Klicken Sie unter Provider auf die Schaltfläche Edit und nehmen Sie alle erforderlichen Änderungen vor.
Wenn der Anbieter konfiguriert ist, klicken Sie auf Enabled, um ihn zu aktivieren, und klicken Sie dann auf die Schaltfläche Save.
Wählen Sie unter Provider More > Manage Groups.
Klicken Sie im Dialogfeld Groups auf die Schaltfläche Create.
Im Dialogfeld Provider Group stellen Sie die folgenden Werte ein:
- Name: Offline App Security Provider
- Identifier: Offline App Security Provider
- Group: Klicken Sie, um das Menü zu öffnen, und wählen Sie dann die Gruppe Offline App Security Provider.
Schließen Sie das Dialogfeld Provider Group und dann das Dialogfeld Groups.

Tipp

Der Sicherheitsgruppenbezeichner (Offline App Security Provider in diesem Beispiel) wird später zur Konfiguration des Offline-App-Sicherheitsanbieters verwendet.

Client

So erstellen Sie einen Client:

Wählen Sie IDE > User Management.
Wählen Sie die Registerkarte Clients.
Klicken Sie auf die Schaltfläche + Client.
Legen Sie im Dialogfeld die folgenden Werte unter Client: fest:
- Name: Offline App Client
- Description: Geben Sie eine Beschreibung ein.
Klicken Sie auf die Schaltfläche Save.
Klicken Sie unter Redirects auf die Schaltfläche + URL.
Geben Sie Folgendes in das Feld ein und klicken Sie auf das Symbol , um es zu speichern:
```
https://localhost:5001/signin-OpenID
```
- localhost: Dies ist eine wörtliche Zeichenkette; Sie müssen keinen Hostnamen oder keine IP-Adresse ersetzen.
- OpenID: Dieser Teil der URL kann unterschiedlich sein, muss aber genau dem Namen des OpenID-Sicherheitsanbieters (wird später festgelegt) entsprechen.
Wählen Sie unter Client More > Advanced.
Klicken Sie im Dialog Erweiterte Einstellungen darauf, um sowohl PKCE erforderlich als auch Öffentlich zu aktivieren, und schließen Sie dann den Dialog.
Kopieren Sie die Client-ID oder notieren Sie sie sich zur späteren Verwendung, und schließen Sie dann den Dialog.

Offline-App

Um die Offline-App zu konfigurieren, müssen Sie folgende Schritte durchführen:

Erstellen Sie Benutzergruppen.
Richten Sie einen OpenID-Sicherheitsanbieter ein.
Erstellen Sie eine Gruppenzuordnung für den Sicherheitsanbieter.
Konfigurieren Sie die Connector-Datenquellen der App.

Benutzergruppen

Wie bei jeder App Builder-App sollten Sie Benutzergruppen für die verschiedenen Benutzertypen erstellen, die die App verwenden sollen, oder mindestens die folgenden:

Eine Benutzer-Gruppe für allgemeine Benutzer der App.
Eine Administrator-Gruppe für Entwickler und Administratoren.

OpenID-Sicherheitsanbieter

Sie benötigen einen Sicherheitsanbieter, um die Authentifizierung auf Entwicklungs- (Off-Device-) Instanzen Ihrer Offline-App zu testen. Die Informationen dieses Sicherheitsanbieters können als JSON-Datei exportiert und verwendet werden, um den Anbieter auf Mobilgeräten automatisch einzurichten. Der Jitterbit-Support verwendet die JSON-Datei beim Erstellen von Builds der Offline-App für Ihre Mobilgeräte.

Führen Sie folgende Schritte aus, um einen OpenID-Sicherheitsanbieter einzurichten:

Wählen Sie IDE > Sicherheitsanbieter.
Klicken Sie auf die Schaltfläche + Sicherheitsanbieter.
Legen Sie unter Anbieter die folgenden Werte fest:
- Einstellungen
  - Name: OpenID
    
    Wichtig
    
    Dieser Wert muss genau mit dem Suffix der Client-Umleitungs-URL (zuvor festgelegt) in der Kern-App übereinstimmen.
  - Typ: Vinyl / OpenID Connect
  - Priorität: (Standard).
  - Aktiviert: Aktiviert.
- Token
  - Besitzer: Benutzer (Standard).
- Anmelden
  - Bei Herausforderung umleiten: Deaktiviert (Standard).
  - Im Anmeldeformular anzeigen: Aktiviert.
  - Standardseite: Leer (Standard).
  - Abmeldungsseite: Leer (Standard).
- Bereitstellung
  - Benutzerbereitstellung: Aktiviert.
  - Vorhandenen Benutzer abgleichen: Aktiviert.
  - Stellt Gruppenmitgliedschaft bereit: Aktiviert.
  - Namensformat: Leer (Standard).
  - Namensbezeichnerformat: Leer (Standard).
  - Identitätsanbieter-URL: Leer (Standard).
Klicken Sie auf die Schaltfläche Speichern, um den Anbieter zu speichern.
Klicken Sie unter Endpunkte auf die Schaltfläche + Endpunkt.
Legen Sie im Dialog Endpunkt Folgendes fest:
- Endpunkttyp: Klicken Sie, um das Menü zu öffnen, und wählen Sie dann OpenID Connect Issuer.
- URL: Geben Sie die URL des App Builder-Servers der Kern-App ein, mit dem sich die Offline-App authentifiziert.
Klicken Sie auf die Schaltfläche Speichern, und schließen Sie dann den Dialog Endpunkt.
Klicken Sie unter Anmeldedaten auf die Schaltfläche + Anmeldedaten.
Legen Sie im Dialog Anmeldedaten Folgendes fest:
- Typ: Klicken Sie, um das Menü zu öffnen, und wählen Sie dann Client.
- Benutzername: Geben Sie die Client-ID (zuvor notiert) ein.
Klicken Sie auf die Schaltfläche Speichern, und schließen Sie dann den Dialog Anmeldedaten.
Klicken Sie unter Eigenschaften auf die Schaltfläche + Eigenschaft.
Legen Sie im Dialog Eigenschaften Folgendes fest:
- Parameter: Klicken Sie, um das Menü zu öffnen, und wählen Sie dann Bereiche.
- Wert: openid profile email phone api groups
Klicken Sie auf die Schaltfläche Speichern, und schließen Sie dann den Dialog Eigenschaften.

Gruppenzuordnung

Der Offline-App wird der Zugriff über die auf der App Builder-Instanz der Kern-App eingerichtete Gruppenkennung des OpenID-Sicherheitsanbieters gewährt.

Führen Sie folgende Schritte aus, um die Gruppe mit dem Anbieter zu verknüpfen:

Wählen Sie IDE > Sicherheitsanbieter.
Klicken Sie im Panel Sicherheitsanbieter auf das Symbol am Ende der Zeile OpenID, um den Datensatz zu öffnen.
Wählen Sie unter Anbieter Mehr > Gruppen verwalten.
Klicken Sie im Dialog Groups auf die Schaltfläche Create.
Legen Sie im Dialog Provider Group die folgenden Werte fest:
- Name: Geben Sie einen Namen Ihrer Wahl ein.
- Identifier: Offline App Security Provider
- Group: Klicken Sie, um das Menü zu öffnen, und wählen Sie dann die Gruppe Offline App Security Provider aus.
Klicken Sie auf die Schaltfläche Save, und schließen Sie dann die Dialoge Provider Group und Groups.

Connector-Datenquellen

Alle Offline-App-App-Builder-Connector-Datenquellen, die auf die Core-App zugreifen, müssen den gerade erstellten OpenID-Sicherheitsanbieter verwenden.

Gehen Sie bei allen solchen Connectoren wie folgt vor:

Wählen Sie IDE > Data Servers aus.
Klicken Sie in der Tabelle Data Servers auf die Schaltfläche Details für die Datenquelle.
Vergewissern Sie sich im Dialog Server, dass die URL Ihre Core-App-App-Builder-Instanz ist, und klicken Sie dann auf die Schaltfläche Edit.
Erweitern Sie die Gruppe Security Settings.
Klicken Sie, um das Menü Security Provider zu öffnen, und wählen Sie dann OpenID (der zuvor erstellte Sicherheitsanbieter) aus.
Klicken Sie auf die Schaltfläche Save, und schließen Sie dann den Dialog Server.

Test

Nach Abschluss der Konfiguration wird auf dem Anmeldebildschirm der Offline-App eine Schaltfläche Sign in with OpenID angezeigt.

Das Folgende ist ein Beispiel für ein einfaches Testmuster:

Erstellen Sie in der Core-App-App-Builder-Instanz einen lokalen Benutzer mit einem Kennwort.
Melden Sie sich in der Offline-App-App-Builder-Instanz mit diesem Benutzer an.
Überprüfen Sie den Zugriff auf Ihre Offline-App, und überprüfen Sie die Funktionalität aller Seiten, die App-Builder-Connectoren verwenden.