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-Anforderung. 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:

1. Laden Sie das Plugin herunter und fügen Sie es hinzu
2. Verknüpfen Sie das Plugin mit einer Agentengruppe
3. Plugin zuweisen Das Plugin kann einem 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
4. Globale Variablen für das Plugin festlegen
5. Operation abschließen

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 derzeit 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 Sie es zugewiesen haben, 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 der 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:

1. Melden Sie sich beim Harmony-Portal an und gehen Sie zur Management Console. Navigieren Sie dann über das Menü oben links zu Anpassungen > Plug-ins.
2. 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 Agentengruppe zuordnen aus.
3. Wählen Sie im Popup eine private Agentengruppe aus und klicken Sie auf Speichern.

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

So weisen Sie dieses Plugin im Design Studio zu:

1. Erstellen Sie einen Webservice-Aufruf Operation.
2. 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 „OASIS Web Service Security“ aus und klicken Sie auf Zuweisen. Klicken Sie dann auf OK.

Um dieses Plugin zuzuweisen in Integration Studio:

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

Festlegen globaler Variablen für das Plugin

Damit ein einem Webservice-Aufruf 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 in der Operation vor dem Webservice-Aufruf oder der SOAP Aktivität platziert werden sollte, damit die Variablen initialisiert werden können.

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

<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>

Vollständige Operation

Der Plugin-Teil der Einrichtung des 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.

Um die Einrichtung des Operation abzuschließen, konfigurieren Sie die Transformations für Webdienstanforderung und -antwort sowie etwaige zusätzliche Quellen oder Ziele für den Operation.

Eine vollständige Operation im Design Studio:

Eine komplette Operation in Integration Studio: