JWT Token generieren Aktivität

Einführung

Eine JWT Token generieren Aktivität, die ihre JWT-Verbindung verwendet, generiert ein JSON Web Token (JWT) und ist dazu gedacht, als Ziel zum Konsumieren von Daten in einem Vorgang verwendet zu werden.

Erstellen einer JWT Token generieren Aktivität

Eine Instanz einer JWT Token generieren Aktivität wird aus einer JWT-Verbindung unter Verwendung des Aktivitätstyps Token generieren erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsgrafik oder kopieren Sie den Aktivitätstyp und fügen Sie ihn in die Entwurfsgrafik ein. Für weitere Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene JWT Token generieren Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Entwurfsgrafik (siehe Komponentenaktionsmenü in Entwurfsgrafik).
• Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).

Konfigurieren einer JWT Token generieren Aktivität

Befolgen Sie diese Schritte, um eine JWT Token generieren Aktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen
  Geben Sie einen Namen für die Aktivität ein und spezifizieren Sie den JWT-Typ, die vom JWT-Typ abhängigen Einstellungen und optionale Einstellungen.

• Schritt 2: Überprüfen Sie die Datenschemas
  Alle Anfrage- oder Antwortschemas werden angezeigt.

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität an und spezifizieren den JWT-Typ, die vom JWT-Typ abhängigen Einstellungen und optionale Einstellungen. Jedes Benutzeroberflächenelement dieses Schrittes wird unten beschrieben.

• Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede JWT Generate Token-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

• JWT-Typ: Wählen Sie zwischen der Signierung des JWT mit einer JSON Web Signature (JWS) oder der Verschlüsselung mit JSON Web Encryption (JWE).

  Wichtig

  Wenn Signaturen oder Verschlüsselungen nicht erforderlich sind, wählen Sie den JWS JWT-Typ und den None Signaturtyp.

  • JWE: Wenn Sie den JWE JWT-Typ verwenden:

    • Typ des Schlüsselmanagementalgorithmus: Einer von Asymmetrisch oder Symmetrisch.

      • Asymmetrisch: Wenn Sie den Asymmetrisch Schlüsselmanagementalgorithmus verwenden:

        

        • Asymmetrische Schlüsselmanagementalgorithmen: Einer von RSA1_5, RSA_OAEP oder RSA_OAEP_256.
        • Öffentlicher Verschlüsselungsschlüssel: Geben Sie einen öffentlichen Schlüssel ein.

      • Symmetrisch: Wenn Sie den Symmetrisch Schlüsselmanagementalgorithmus verwenden:

        

        • Symmetrische Schlüsselverwaltungsalgorithmen: Einer von A128KW, A192KW oder A256KW.
        • Verschlüsselungsgeheimschlüssel: Geben Sie einen geheimen Schlüssel ein.
        • Base64-kodiert: Wählen Sie aus, ob eine Base64-Kodierung erforderlich ist.

    • Inhaltsverschlüsselungsalgorithmen: Einer von A128CBC_HS256, A128GCM, A192CBC_HS384, A192GCM, A256CBC_HS512 oder A256GCM.

  • JWS: Wenn der JWS JWT-Typ verwendet wird:

    • Signaturtyp: Einer von Asymmetrisch, Symmetrisch oder Keine.

      • Asymmetrisch: Wenn der Asymmetrische Signaturtyp verwendet wird:

        

        • Signaturalgorithmen: Einer von ES256, ES384, ES512, PS256, PS384, PS512, RS256, RS384 oder RS512.

        • Privater Schlüssel: Geben Sie einen privaten Schlüssel ein.

          Vorsicht

          Ein privater Schlüssel, der Leerzeichen wie Zeilenumbrüche (\n) enthält, kann den folgenden Fehler verursachen, wenn er aus einer Transformation bereitgestellt wird:

          Fehlercode: Fehler beim Ausführen der generateToken-Aktivität. Die Ausnahme lautet: Schlüssel enthält Leerzeichen. Bitte geben Sie einen gültigen Schlüssel ohne Leerzeichen an.,
          Fehlerbeschreibung: Fehler beim Ausführen der generateToken-Aktivität. Die Ausnahme lautet: Schlüssel enthält Leerzeichen. Bitte geben Sie einen gültigen Schlüssel ohne Leerzeichen an.,
          Stack-Trace: org.jitterbit.connector.sdk.exceptions.ActivityExecutionException: Fehler beim Ausführen der generateToken-Aktivität. Die Ausnahme lautet: Schlüssel enthält Leerzeichen. Bitte geben Sie einen gültigen Schlüssel ohne Leerzeichen an.
          

          Um dies zu verhindern, entfernen Sie die Leerzeichen aus dem Schlüssel oder ziehen Sie in Betracht, die CreateJwtToken-Funktion zu verwenden, wenn Ihr Anwendungsfall dies zulässt.

      • Symmetrisch: Wenn der Symmetrisch Signaturtyp verwendet wird:

        

        • Signaturalgorithmen: Einer von HS256, HS384 oder HS512.
        • Geheimer Schlüssel: Geben Sie einen geheimen Schlüssel ein.
        • Base64-kodiert: Wählen Sie aus, ob eine Base64-Kodierung erforderlich ist.

      • Keine: Wenn der Keine Signaturtyp verwendet wird, erscheinen keine zusätzlichen Felder.

• Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

  

  • Payload-Eigenschaften: Die JWT-Nutzlast.
  • Header-Eigenschaften: Metadaten, die für die JWT-Nutzlast relevant sind.

  Wie oben gezeigt, hat jede Definition von Nutzlast und Header die folgenden Eigenschaften:

  • Schlüssel: Der Name oder Schlüssel des Nutzlast- oder Headerobjekts. Zum Beispiel alg, typ, cty oder kid für Headerobjekte.
  • Wert: Die mit dem Schlüssel verbundene Daten für ein Nutzlast- oder Headerobjekt.
  • Datentyp: Der Datentyp, der den Wert eines Nutzlast- oder Headerobjekts darstellt. Der Datentyp muss einer von boolean, decimal, number oder string sein.

  Für weitere Informationen zu JWT-Nutzlasten und -Headern siehe IETF RFC 7519: JSON Web Token (JWT).

• Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

• Datenschemas: Diese Datenschemas werden von benachbarten Transformationen übernommen und während der Transformationszuordnung erneut angezeigt.

  Hinweis

  Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

  Die Felder key, value und dataType der Payload- und Header-Knoten entsprechen den Eigenschaften, die unter Optionale Einstellungen in Schritt 1 beschrieben sind.

  Der JWT-Connector verwendet die Java JWT-Bibliothek. Die Schema-Knoten und -Felder basieren auf den in Schritt 1 getroffenen Auswahlentscheidungen. Weitere Informationen zur JWT-Spezifikation finden Sie in IETF RFC 7519: JSON Web Token (JWT).

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom JWT-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie z. B. in einer benachbarten Transformation.

• Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine JWT Token generieren Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Tools als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen, die sich in denselben oder unterschiedlichen Workflows befinden, miteinander zu verketten.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktionsmenü der Aktivität in Connector-Grundlagen.

JWT Token generieren-Aktivitäten können als Ziel mit diesen Betriebsmustern verwendet werden:

• Transformationsmuster
• Zwei-Transformationsmuster (als erstes oder zweites Ziel)

Um die Aktivität mit Skriptfunktionen zu verwenden, schreibe die Daten an einen temporären Ort und verwende dann diesen temporären Ort in der Skriptfunktion.

Wenn du bereit bist, implementiere und führe die Operation aus und validiere das Verhalten, indem du die Betriebsprotokolle überprüfst.