OASIS Web Service Security-Plugin (veraltet) für Jitterbit-Cloud und private Agentengruppen

Einführung

Das OASIS Web Service Security-Plugin von Jitterbit wird verwendet, um ein OASIS Web Services Security (WSS) anzuhängen Header an eine Webservice-Anfrage. Der Header enthält einen UserNameToken Element. Optional kann der Header ein Timestamp Element.

Auf dieser Seite werden die Schritte zur Verwendung des OASIS Web Service Security Plugin detailliert beschrieben:

Laden Sie das Plugin herunter und fügen Sie es hinzu
Verknüpfen Sie das Plugin mit einer Agentengruppe
Plugin zuweisen Das Plugin kann jedem dieser Design Studio zugewiesen werden Projektelemente oder Integration Studio Projektkomponenten:
- Design Studio Webdienstaufruf mithilfe einer Webdienstmethode
- Design Studio Webdienstaufruf mithilfe eines Workday Endpoint
- Integration Studio SOAP -Aktivität
Globale Variablen für das Plugin festlegen
Operation abschließen

Wichtig

Die von Jitterbit bereitgestellten Plugins sind veraltet.

Versionen und Upgrades

Es sind drei Versionen dieses Plugin verfügbar:

OASIS Web Service Security 1.0.0.0
Diese Version ist veraltet und sollte nicht verwendet werden.
OASIS Web Service Security 1.2.0.0
Diese Version enthält grundlegende Funktionen, unterstützt jedoch keine Web Services Addressing.
OASIS Web Service Security 1.3.0.0
Diese Version enthält die gleiche Funktionalität wie Version 1.2.0.0 und beinhaltet außerdem teilweise Unterstützung für Web Services Addressing, mit dem Zusatz dieser globalen Variablen: WSA.Action, WSA.To, Und WSA.ToMustUnderstand. Dies ist die aktuell empfohlene Version.

Wenn Sie aktuell eine niedrigere Plugin Version verwenden und auf eine höhere Version aktualisieren möchten, erfolgt der Aktualisierungsvorgang manuell. Das heißt, Sie müssen das ältere Plugin von allen Projektelementen entfernen, denen es zugewiesen ist, und dann das neuere Plugin zuweisen. Jede Plugin Version ist unabhängig.

Laden Sie das Plugin herunter und fügen Sie es hinzu

Das OASIS Web Service Security-Plugin muss unter dem unten angegebenen Link heruntergeladen und der Organisation hinzugefügt werden.

OASIS Web Service Security 1.3.0.0 (ZIP)

Verknüpfen Sie das Plugin mit einer Agentengruppe

Wenn Sie eine Cloud-Agentengruppe verwenden, können Sie diesen Schritt überspringen, da alle Versionen des OASIS Web Service Security Plugin standardmäßig bereits mit den Cloud-Agentengruppen von Jitterbit verknüpft sind. Wir empfehlen die Verwendung von Version 1.3.0.0.

Wenn Sie eine private Agentengruppe verwenden, müssen Sie dieses von Jitterbit bereitgestellte Plugin einer privaten Agentengruppe zuordnen. Dadurch wird das Plugin auf allen privaten Agenten innerhalb der privaten Agentengruppe verfügbar. So ordnen Sie das Plugin zu:

Melden Sie sich beim Harmony Portal an und gehen Sie zur Management Console. Navigieren Sie anschließend über das Menü oben links zu Anpassungen > Plugins.
Suchen Sie in der Tabelle die Zeile „OASIS Web Service Security“ und achten Sie dabei auf die Versionsnummer. Die höchste Version wird empfohlen. Wählen Sie ganz rechts im Dropdown-Menü Aktion die Option Agentengruppe zuordnen aus.
Wählen Sie im Popup eine private Agentengruppe aus und klicken Sie auf Speichern.

Tipp

Eine ausführliche Dokumentation zur Plugin-Verknüpfung finden Sie unter Anpassungen > Plugins.

Zuweisen des Plugin

Dieses Plugin kann jedem dieser Design Studio zugewiesen werden Projektelemente oder Integration Studio Projektkomponenten:

Design Studio Webdienstaufruf mithilfe einer Webdienstmethode
Design Studio Webdienstaufruf mithilfe eines Workday Endpoint
Integration Studio SOAP -Aktivität

Notiz

Beim Verbinden mit Workday wird das OASIS- Plugin unter Verwendung des Design Studio Workday Connectors benötigt nur. Der Integration Studio Workday Connector verfügt über eine integrierte Funktion für OASIS-Header unter Verwendung des Benutzernamens und des Kennworts, die während der Konfiguration der Verbindung angegeben wurden.

So weisen Sie dieses Plugin in Design Studio zu:

Erstellen Sie einen Webdienstaufruf Operation.
Klicken Sie innerhalb des Operation mit der rechten Maustaste auf den Webdienstaufruf und wählen Sie Plugin. Wählen Sie im Popup unter Verfügbare Plugins die Option "OASIS Web Service Security" aus und klicken Sie auf Zuweisen. Klicken Sie anschließend auf OK.

So weisen Sie dieses Plugin in Integration Studio zu:

Fügen Sie eine SOAP -Aktivität zu einer Operation.
Konfigurieren Sie die SOAP Aktivität. Klicken Sie im letzten Konfigurationsschritt unterhalb der Datenschemata auf Plugin(s) hinzufügen, um diesen Bereich zu erweitern, und aktivieren Sie das Kontrollkästchen neben „OASIS Web Service Security“. Klicken Sie anschließend auf Fertig.

Tipp

Eine ausführliche Dokumentation zum Zuweisen von Plugins finden Sie unter Pipeline-Plugins anwenden (Design Studio) oder Plugins, die einer Aktivität hinzugefügt wurden (Integration Studio).

Legen Sie globale Variablen für das Plugin fest

Damit ein einem Webdienstaufruf oder einer SOAP Aktivität zugewiesenes Plugin funktioniert, müssen alle vom Plugin benötigten globalen Variablen gesetzt werden. Diese Variablen werden in einem Script gesetzt, das vor dem Webdienstaufruf oder der SOAP Aktivität im Operation platziert werden sollte, damit die Variablen initialisiert werden können.

Tipp

Weitere Informationen finden Sie auf diesen Seiten:

Script als Projektelement in Erstellen eines Script (Design Studio)
Globale Variablen (Design Studio)
Script als Projektkomponente in Script und -erstellung (Integration Studio)
Globale Variablen (Integration Studio)

Unten finden Sie eine Script, gefolgt von einer Dokumentation zu den Variablen, die mit diesem Plugin verwendet werden können:

Script

<trans>
$WSS.User = "user@example.com";
$WSS.Password = "mypassword";
$WSS.IncludeTimestamp = true;
$WSS.TimeToLive = 10;
$WSS.UsePasswordDigest = true;
$WSS.IncludeNonce = false;
$WSS.IncludeCreated = false;
$WSS.UseMilliSecondPrecision = false;
$WSS.MustUnderstand = false;
$WSA.Action = "http://example.com/examples-apply/ExampleRequest";
$WSA.To = "http://www.example.com/sys2/example-apply-v2-0";
$WSA.ToMustUnderstand = false;
</trans>

Name	Typ	Erforderlich	Beschreibung
`WSS.User`	Zeichenfolge	Erforderlich	Der Benutzername, der den Zugriff auf den Webdienst ermöglicht.
`WSS.Password`	Zeichenfolge	Erforderlich	Das mit dem Benutzernamen verknüpfte Kennwort, das den Zugriff auf den Webdienst ermöglicht.
`WSS.IncludeTimestamp`	Boolesch	Erforderlich	Wenn gesetzt auf `true` oder nicht gesetzt ist, enthält der erstellte Header eine `wsu:Timestamp` Element. Wenn auf `false`, Die `Timestamp` Element wird nicht eingeschlossen.
`WSS.TimeToLive`	Ganzzahl	Erforderlich	Die Lebensdauer der Anfrage in Sekunden. Dieser Wert wird ignoriert, wenn `IncludeTimestamp` Element ist `false`.
`WSS.UsePasswordDigest`	Boolesch	Erforderlich	Wenn gesetzt auf `false` oder nicht gesetzt, `#PasswordText`wird als Wert des `Type` Attribut im `Password` Element standardmäßig. Eingestellt auf `true` zu verwenden `#PasswordDigest`.
`WSS.IncludeNonce`	Boolesch	Optional	Wenn gesetzt auf `true` oder nicht gesetzt, `UserNameToken` Element enthält eine `Nonce` Element standardmäßig. Eingestellt auf `false` zu unterdrücken, `Nonce` Element.
`WSS.IncludeCreated`	Boolesch	Optional	Wenn gesetzt auf `true` oder nicht gesetzt ist, `UserNameToken` Element enthält eine `Created` Element standardmäßig. Eingestellt auf `false` zu unterdrücken, `Created` Element.
`WSS.UseMilliSecondPrecision`	Boolesch	Optional	Wenn gesetzt auf `false` oder nicht gesetzt, der generierte Zeitstempel in der `Created` Element verwendet eine Genauigkeit von 10^-2 (0,01) Sekunden. Eingestellt auf `true` um eine Genauigkeit im Millisekundenbereich zu verwenden (einige Webdienstimplementierungen akzeptieren dies nicht.).
`WSS.MustUnderstand`	Boolesch	Optional	Wenn gesetzt auf `true` oder nicht gesetzt ist, wird der Wert des `mustUnderstand` Attribut im WSS- Header, der in den SOAP Umschlag eingefügt wird, ist auf `true`. Eingestellt auf `false` um dieses Element zu unterdrücken.
`WSA.Action`	Zeichenfolge	Optional	Die `wsa:Action` Elementwert im Header. Hinweis Diese Variable wird nur in der Plugin Version 1.3.0.0 oder höher unterstützt.
`WSA.To`	Zeichenfolge	Optional	Die `wsa:To` Elementwert im Header. Hinweis Diese Variable wird nur in der Plugin Version 1.3.0.0 oder höher unterstützt.
`WSA.ToMustUnderstand`	Boolesch	Optional	Wenn gesetzt auf `false` oder nicht gesetzt ist, wird der Wert des `wsa:To` Element `mustUnderstand` Attribut im Header, der in den SOAP Umschlag eingefügt wird, ist auf `false`. Eingestellt auf `true` den Empfänger zur Verarbeitung der `wsa:To` Header Eintrag. Hinweis Diese Variable wird nur in der Plugin Version 1.3.0.0 oder höher unterstützt.

Vollständige Operation

Der Plugin Teil der Operation ist abgeschlossen, nachdem Sie (1) das Script haben, das die mit dem Plugin zu verwendenden Variablen definiert, und (2) das Plugin einem Webdienstaufruf (Design Studio) oder einer SOAP Aktivität (Integration Studio) im Operation zugewiesen haben.

Um die Einrichtung des Operation abzuschließen, konfigurieren Sie die Transformations für Webdienstanforderungen und -antworten sowie alle zusätzlichen Quellen oder Ziele für den Operation.

Eine vollständige Operation im Design Studio:

Operation Studio-Vorgang

Eine vollständige Operation im Integration Studio:

Integration Studio - Operation

Tipp

Einzelheiten zum Abschließen des Operation finden Sie unter Operation erstellen (Design Studio) oder Operationserstellung und -konfiguration (Integration Studio).