Parameter für das Muster Resource handler

Worklight
Musterparameter Standard Beispiel
Worklight-Version Worklight-Version 5.0

Gibt die Zielversion von Worklight für den generierten Benachrichtigungsadapter an. Dieses Muster unterstützt nur Worklight V5.0.

Adapterbeschreibung Adapter für die Worklight-Integration

Zusätzliche Informationen zum Adapter, der in der Worklight-Konsole angezeigt wird.

Maximale Anzahl der gleichzeitig bestehenden Verbindungen 99

Die maximale Anzahl der gleichzeitigen Anforderungen, die im Service ausgeführt werden können.

Prüfung aktivieren Ausgewählt

Definiert, ob Aufrufe an die Prozedur im Worklight-Prüfprotokoll protokolliert werden sollen. Die Protokolldatei lautet /server/log/audit/audit.log und beginnt im Worklight-Stammverzeichnis.

Servicekonfiguration
Musterparameter Standard Beispiel
Ressourcenname

Name der Ressource, die aus dieser Musterinstanz aufgerufen wird - beispielsweise Car, Person und InventoryItem. Mit diesem Namen werden die Prozedurnamen erstellt, die von der mobilen Anwendung aufgerufen werden, z. B. createCar und readInventoryItem.

Ressourcenoperationen Uneingeschränkter Zugriff (CRUD)

Wählen Sie die Kombination aus Ressourcenoperationen für diese Musterinstanz aus. Es werden drei allgemeine Auswahlmöglichkeiten bereitgestellt: Read only (R) (Lesezugriff), Full control (CRUD) (Uneingeschränkter Zugriff) und Read and update (RU) (Lese- und Aktualisierungszugriff).

Read only ist das einfachste Szenario, in dem für eine Gruppe von Ressourcen keine Aktualisierungsmechanismen bereitgestellt werden.

Mit Full control wird der mobilen Anwendung die vollständige Steuerung über den Lebenszyklus der Ressourcen ermöglicht.

Read and update ist für Szenarios hilfreich, in denen der Lebenszyklus der Ressourcen (insbesondere das Erstellen und Löschen) außerhalb der Musterinstanz bearbeitet wird. In diesem Fall kann das Erstellen und Löschen von Ressourcen durch direkte Aktualisierungen in der Back-End-Anwendung und nicht über die mobile Anwendung ausgeführt werden.

Cache-Ergebnisse Nicht ausgewählt

Wenn dieses Feld ausgewählt ist, wird jede Instanz der Ressource beim Lesen in einen Cache gestellt. Alle nachfolgenden Lesevorgänge geben die Ressource zurück, ohne den untergeordneten Nachrichtenfluss der Steuerroutine aufzurufen. Wenn eine Aktualisierungs- oder Löschoperation für eine Ressource im Cache aufgerufen wird, wird diese aus dem Cache entfernt.

Serveradresse http://localhost:7080 Dieser Musterparameter definiert die Serveradresse, die als HTTP-Adresselement im generierten Adapter verwendet wird. Setzen Sie den Parameter auf die aktuelle HTTP-URL, unter der der Service implementiert werden soll. Diese Adresse wird zu Testzwecken oft auf http://localhost:7080 gesetzt.
Sicherheit (LDAP)
Musterparameter Standard Beispiel
Sicherheit erforderlich Nicht ausgewählt

Dieser Musterparameter bestimmt, ob die Ressourcen über einen LDAP-Server geschützt sind.

Wenn die Sicherheit aktiviert ist, muss die mobile Anwendung eine Benutzer-ID und ein Kennwort bereitstellen. Der LDAP-Server wird geprüft, um sicherzustellen, dass das Kennwort korrekt ist (Authentifizierung) und sich der Benutzer in einer geeigneten Gruppe für den Zugriff auf die Zielressource befindet (Autorisierung). Möglicherweise gibt es unterschiedliche Gruppen zum Lesen und Schreiben (Aktualisieren, Erstellen und Löschen) von Ressourcen.

Verbindungsdetails ldap://localhost:389

Legen Sie die Zeichenfolge für die LDAP-Verbindung mithilfe der folgenden Syntax fest:

ldap[s]://Server[:Port]

ldap:
(Erforderlich) Festgelege Protokollzeichenfolge.
s:
(Optional) Gibt an, ob SSL verwendet werden soll. Standardmäßig wird SSL nicht verwendet.
Server:
(Erforderlich) Der Name oder die IP-Adresse des LDAP-Servers, zu dem eine Verbindung hergestellt werden soll.
Port:
(Optional) Der Port, zu dem eine Verbindung hergestellt werden soll. Standardmäßig ist dies 389 (kein SSL). Für LDAP-Server mit aktiviertem SSL wird in der Regel Port 636 verwendet.

Es wird empfohlen, während der Implementierung eine LDAP-Benutzer-ID und ein LDAP-Kennwort mithilfe von mqsisetdbparms festzulegen. Message Broker meldet sich mit diesen Berechtigungsnachweisen im LDAP-Server an, um die Authentifizierung durchzuführen. Wenn keine Benutzer-ID und kein Kennwort konfiguriert sind, stellt Message Broker eine anonyme Verbindung zum LDAP-Server her.

Authentifizieren Sie Benutzer, indem Sie diese in dieser Position der Verzeichnisbaumstruktur suchen (definierter Name) ou=users,o=ibm.com

Dieser Musterparameter ermittelt eine Position in der LDAP-Verzeichnisbaumstruktur. Mit der Position werden Anforderungen aus Worklight an WebSphere Message Broker authentifiziert.

Die mobile Anwendung stellt beim Ausgeben einer Ressourcenanforderung (CRUD) an Worklight eine Benutzer-ID und ein Kennwort bereit. Der durch dieses Muster generierte Worklight-Adapter fügt eine Anforderung für die HTTP-Basisauthentifizierung an Message Broker hinzu. Message Broker sucht in der Verzeichnisbaumstruktur die bereitgestellte Benutzer-ID und beginnt dabei an dieser Position. Wenn die Benutzer-ID im Verzeichnis gefunden wird, wurde die Anforderung erfolgreich authentifiziert und die Ressourcenanforderung wird fortgesetzt. Wenn der Benutzer nicht gefunden wird, schlägt die Authentifizierung fehl und die Anforderung wird mit einer Fehlernachricht an Worklight zurückgegeben.

Wenn Benutzer in unterschiedlichen untergeordneten Baumstrukturen des Verzeichnisses vorhanden sind, geben Sie eine einheitliche übergeordnete Position an, in der bei einer Suche alle relevanten Benutzer-IDs gefunden werden können, und aktivieren Sie den Musterparameter für den Suchbereich, um untergeordnete Baumstrukturen zu durchsuchen.

Suchbereich im Verzeichnis für die Authentifizierung Durchsuchen der untergeordneten Baumstrukturen des Verzeichnisses erlauben

Definiert, ob untergeordnete Baumstrukturen durchsucht werden können, um Benutzer für die Authentifizierung zu finden. Das Durchsuchen einer untergeordneten Baumstruktur ist erforderlich, wenn sich Benutzer in untergeordneten Verzeichnissen der Authentifizierungsposition in der Verzeichnisbaumstruktur befinden. Beschränken Sie die Suche auf die angegebene Verzeichnisposition, wenn sich Benutzer immer in der Baumstrukturposition des Authentifizierungsverzeichnisses befinden.

Benutzer-IDs durch Abgleich mit diesem LDAP-Attribut authentifizieren Eindeutige ID (Unique Identifier, UID)

Der Name des Attributs im LDAP-Verzeichniseintrag, der mit der von der mobilen Anwendung bereitgestellten Benutzer-ID übereinstimmt. Es werden drei Optionen bereitgestellt, die mit den allgemeinen Anwendungsfällen beim Abgleich mit der eindeutigen ID (uid), E-Mail-Adresse (mail) und dem allgemeinen Namen (cn) übereinstimmen.

Leser durch die Überprüfung der Mitglieder dieser Gruppe (dn) autorisieren cn=readers,ou=groups,o=ibm.com

Der definierte Name der Gruppe, zu der Benutzer gehören müssen, um eine Zugriffsberechtigung zur Leseprozedur zu erhalten. Die untergeordneten Baumstrukturen dieses Verzeichniseintrags werden nicht durchsucht.

Autoren durch die Überprüfung der Mitglieder dieser Gruppe (dn) autorisieren cn=writers,ou=groups,o=ibm.com

Der definierte Name der Gruppe, zu der Benutzer gehören müssen, um eine Zugriffsberechtigung zu Erstellungs-, Aktualisierungs- oder Löschprozeduren zu erhalten. Die untergeordneten Baumstrukturen dieses Verzeichniseintrags werden nicht durchsucht.

Protokollierung
Musterparameter Standard Beispiel
Protokollierung erforderlich Nicht ausgewählt Dieser Musterparameter bestimmt, ob die Musterinstanz den untergeordneten Nachrichtenfluss für die Protokollierung enthält.

Wenn dieser Musterparameter gelöscht wird, ist der Protokollierungs-Unterablauf nicht enthalten.

Wenn dieser Musterparameter ausgewählt ist, müssen Sie Werte für Protokoll-WS-Manager und Protokollwarteschlange festlegen.

Protokoll-WS-Manager Dieser Musterparameter definiert den Warteschlangenmanager, der zur Protokollierung verwendet wird. Sie können diesen Parameter leer lassen, wenn der Warteschlangenmanager des Brokers für die Protokollierung verwendet wird.

Dieser Musterparameter ist nur erforderlich, wenn Protokollierung erforderlich ausgewählt ist.

Protokollwarteschlange PROTOKOLL Dieser Musterparameter definiert die Warteschlange, die zur Protokollierung verwendet wird.

Dieser Musterparameter ist nur erforderlich, wenn Protokollierung erforderlich ausgewählt ist.

Fehlerbehandlung
Musterparameter Standard Beispiel
Fehlernachricht erforderlich Ausgewählt Dieser Musterparameter bestimmt, ob die Musterinstanz Code für das Einreihen von Fehlernachrichten in eine Warteschlange enthält.

Wenn dieser Musterparameter aktiviert ist, müssen für Fehler-WS-Manager und Fehlerwarteschlange Werte eingegeben werden.

Fehler-WS-Manager Dieser Musterparameter definiert den Warteschlangenmanager, der zur Fehlerprotokollierung verwendet wird.

Dieser Musterparameter ist nur erforderlich, wenn Fehlernachricht erforderlich ausgewählt ist.

Fehlerwarteschlange ERROR Dieser Musterparameter definiert die Warteschlange, die für Fehlernachrichten verwendet wird.

Dieser Musterparameter ist nur erforderlich, wenn Fehlernachricht erforderlich ausgewählt ist.

Allgemein
Musterparameter Standard Beispiel
Flusspräfix Dieser Musterparameter definiert das Präfix, das am Beginn aller Nachrichtenflussnamen hinzugefügt wird.
Flusssuffix Dieser Musterparameter definiert das Suffix, das am Ende aller Nachrichtenflussnamen hinzugefügt wird.
Warteschlangenpräfix Dieser Musterparameter definiert das Präfix, das am Beginn aller Warteschlangennamen hinzugefügt wird.

Wenn Standardwarteschlangennamen verwendet werden, müssen das Präfix und/oder das Suffix verwendet werden, um Warteschlangennamen für die einzelnen Musterinstanzen zu identifizieren.

Warteschlangensuffix Dieser Musterparameter definiert das Suffix, das am Ende aller Warteschlangennamen hinzugefügt wird.

Wenn Standardwarteschlangennamen verwendet werden, müssen das Präfix und/oder das Suffix verwendet werden, um Warteschlangennamen für die einzelnen Musterinstanzen zu identifizieren.

Kurzbeschreibung Dieser Musterparameter definiert die Beschreibung, die zur Eigenschaft Kurzbeschreibung aller generierten Nachrichtenflüsse hinzugefügt wird.
Langbeschreibung Dieser Musterparameter definiert die Beschreibung, die zur Eigenschaft Langbeschreibung aller generierten Nachrichtenflüsse hinzugefügt wird.

Zu allen Musterparametern sind die Standardwerte angegeben. Wenn kein Standardwert angegeben ist, ist der Standardwert eine leere Zeichenfolge.

Zurück zur Spezifikation des Musters 'Resource handler'