Seite „App-Registrierungen" in der Jitterbit Management Console

Übersicht

Einführung

Auf dieser Seite können Sie Anwendungen mit 3-beinigem OAuth 2.0 (3LO) von Drittanbietern zur Verwendung mit bestimmten Studio-Konnektoren registrieren. Nach der Registrierung der 3LO-Anwendung eines Drittanbieters hier können Sie eine Verbindung mit 3-beinigem OAuth 2.0 authentifizieren.

Weitere Informationen zur Authentifizierung einer Verbindung mit 3LO finden Sie unter 3LO-Authentifizierung.

Sie können Registrierungen anzeigen, erstellen, bearbeiten oder löschen und erweiterte Optionen für eine Registrierung anzeigen und bearbeiten. Ein Konnektor kann mehrmals registriert werden. Jede wird als eindeutige Konnektor-App betrachtet.

Anzeigen

Ohne Registrierungen enthält der Seitenkörper eine Symbolleiste und eine leere Tabelle:

Mit Registrierungen enthält der Seitenkörper eine Symbolleiste und eine Tabelle mit verfügbaren Registrierungen:

• Suche: Geben Sie Text ein, um passende Einträge zu finden.

• Neu erstellen: Erstellen Sie eine neue Registrierung.

• Aktionen: Bewegen Sie den Mauszeiger über eine Zeile, um die Aktionssymbole anzuzeigen:

  • Erweiterte Optionen: Zeigen Sie erweiterte Optionen für die Registrierung an.

  • Bearbeiten: Bearbeiten Sie die Registrierung.

  • Löschen: Löschen Sie die Registrierung.

Klicken Sie auf eine beliebige Spaltenüberschrift (außer Aktionen), um die Tabelle in aufsteigender Reihenfolge nach dieser Spalte zu sortieren. Klicken Sie erneut, um die Sortierreihenfolge umzukehren.

Erstellen

Führen Sie diese Schritte aus, um eine neue Konnektor-App-Registrierung zu erstellen:

1. Klicken Sie auf Neu erstellen. Eine neue Zeile wird in der Tabelle angezeigt:

   

2. Legen Sie Werte für die folgenden Felder fest:

   Im Abschnitt Neue App-Registrierung erstellen:

   • Name: Ein Name für die Registrierung, der für den Konnektor eindeutig ist.

   • Beschreibung: Eine Beschreibung für die Registrierung.

   • Konnektor: Klicken Sie, um das Menü zu öffnen, und wählen Sie dann einen der unterstützten Konnektoren aus. Derzeit unterstützen diese Konnektoren 3LO:

     • BMC Helix ITSM
     • Gmail
     • Google Docs
     • Google Drive
     • Google Sheets
     • HTTP v2
     • Jira
     • MCP Client
     • Shopify
     • Slack
     • Snowflake
     • ZoomInfo

3. Client-ID: Die vom OAuth-Provider zugewiesene Client-Kennung.

4. Client Secret: Das vom OAuth-Provider zugewiesene Client Secret.

5. Scope: Ein oder mehrere durch Leerzeichen getrennte OAuth 2.0 Scopes.

Im Bereich Konfiguration:

• Authentication URL: Die URL, an die eine Autorisierungsanfrage gesendet wird.

• Access token URL: Die URL, an die eine Access-Token-Anfrage gesendet wird.

• Refresh token URL: Die URL zum Anfordern eines neuen Access Tokens.

• Klicken Sie auf Speichern, um die Werte zu speichern, oder auf Abbrechen, um den Vorgang abzubrechen:

  

• Nach erfolgreichem Speichern wird die Registrierung als neuer Eintrag in der Tabelle angezeigt:

  

Bearbeiten

So bearbeiten Sie eine Registrierung:

1. Fahren Sie mit der Maus über eine Registrierung in der Tabelle, um die Aktionssymbole anzuzeigen, und klicken Sie auf Bearbeiten. Der Bereich App-Registrierung bearbeiten wird angezeigt:

   

2. Bearbeiten Sie im Bereich App-Registrierung bearbeiten die Felder, und klicken Sie auf Speichern, um die Änderungen zu speichern, oder auf Abbrechen, um den Vorgang abzubrechen.

   Hinweis

   Der Connector einer Registrierung kann nicht von seinem Anfangswert geändert werden.

3. Lesen Sie die Benachrichtigungsmeldung, die oben rechts im Fenster angezeigt wird. Klicken Sie auf das Symbol Schließen, um die Benachrichtigung zu schließen.

Löschen

So löschen Sie eine Registrierung:

1. Fahren Sie mit der Maus über eine Registrierung in der Tabelle, um die Aktionssymbole anzuzeigen, und klicken Sie auf Löschen.

2. Ein Dialogfeld App-Registrierung löschen wird geöffnet:

   Dialogtext

   App-Registrierung löschen
   Möchten Sie die App-Registrierung appRegistrationName wirklich löschen? Diese Aktion kann nicht rückgängig gemacht werden.

   Geben Sie „DELETE" ein, um zu bestätigen.

3. Geben Sie den Text DELETE ein, und klicken Sie auf Löschen, oder klicken Sie auf Abbrechen, um den Vorgang abzubrechen.

Erweiterte Optionen

Die Schublade Erweiterte Optionen enthält die vom OAuth-Provider bereitgestellten Standardeinstellungen für das Token jeder Registrierung sowie für die Authentifizierungs-, Token- und Aktualisierungsanfragen.

Um sie zu öffnen, fahren Sie mit der Maus über eine Registrierung in der Tabelle, und klicken Sie auf Erweiterte Optionen. Die Schublade wird unten auf der Seite angezeigt:

Die Schublade enthält diese Registerkarten:

• Token-Richtlinie

• Authentifizierungsanfrage

• Token-Anfrage

• Aktualisierungsanfrage

Token-Richtlinie

Die Registerkarte Token-Richtlinie enthält Einstellungen für das Token:

Die folgenden Einstellungen sind verfügbar:

• Token-Ablauf aktivieren: Wenn diese Option aktiviert und in Kombination mit den Einstellungen Ablaufbenachrichtigung empfangen und Tage für Ablaufbenachrichtigung einer Verbindung verwendet wird, erhalten Sie E-Mail-Benachrichtigungen und ein Benachrichtigungsbanner im gesamten Harmony-Portal, das Sie daran erinnert, ein neues Refresh Token zu erhalten, wenn das aktuelle abgelaufen ist oder sich dem Ablauf nähert. Wenn ein Refresh Token abläuft, schlagen alle abhängigen Operationen zur Laufzeit fehl.

  Wenn diese Einstellung aktiviert ist, wird die E-Mail-Benachrichtigung an die Harmony-Organisationsadministratoren gesendet (Mitglieder einer Rolle mit der Berechtigung Admin und der Benutzer, der das Projekt zuletzt bereitgestellt hat).

  Um den Ablaufzeitraum festzulegen, geben Sie eine ganze Zahl größer als Null ein, klicken Sie auf das Menü, und wählen Sie eine der Optionen Sekunden, Stunden oder Tage:

• Inaktivitätsablauf für Refresh-Token aktivieren: Wenn diese Option aktiviert ist, werden Refresh-Tokens, die für den angegebenen Zeitraum inaktiv waren, in der Harmony-Plattform als abgelaufen markiert. Verwenden Sie das Feld Ablauf nach, um das Intervall anzugeben, nach dem ein inaktives Refresh-Token als abgelaufen markiert wird.

  Wichtig

  Verwenden Sie diese Einstellung in Abstimmung mit der Inaktivitätseinstellung des OAuth-Providers. Wenn diese Einstellung aktiviert wird, während der OAuth-Provider keine Inaktivitätseinstellung definiert hat, werden gültige Refresh-Tokens in der Harmony-Plattform fälschlicherweise als abgelaufen betrachtet. Umgekehrt gilt: Wenn der OAuth-Provider diese Einstellung definiert hat, sie aber hier im Harmony-Portal nicht aktiviert und angegeben ist, könnte der Endpunkt ein veraltetes Refresh-Token verwenden, was möglicherweise zu Problemen basierend auf den Refresh-Token-Regeln des OAuth-Providers führt.

  • Ablauf nach: Um den Ablaufzeitraum festzulegen, geben Sie eine ganze Zahl größer als Null ein, klicken Sie auf das Menü und wählen Sie eine der Optionen Sekunden, Stunden oder Tage:

    

  Tipp

  Die empfohlene Einstellung für diesen Wert sollte der im OAuth-Provider selbst verwendeten Einstellung entsprechen. Wenn beispielsweise die Inaktivitätsablaufzeit für Refresh-Tokens eines OAuth-Providers 90 Tage beträgt, stellen Sie den Wert Ablauf nach auf 90 Tage ein.

• Rotierendes Refresh-Token aktivieren: Klicken Sie, um die Token-Rotation zu aktivieren:

  

Klicken Sie auf Speichern, um die Änderungen zu speichern, oder auf Abbrechen, um sie zu verwerfen.

Authentifizierungsanfrage

Die Registerkarte Authentifizierungsanfrage enthält Einstellungen für die Token-Authentifizierungsanfrage:

• Authentifizierungs-URL: Die URL, an die eine Autorisierungsanfrage gesendet wird.

• Parameter: Um Parameter für die Anfrage hinzuzufügen, führen Sie diese Schritte aus:

  1. Geben Sie Werte für Schlüssel und Wert ein.

  2. Um die Methode zum Senden von Parametern auszuwählen, klicken Sie auf das Menü Senden in und wählen Sie eine der Optionen Anfrage-URL oder Anfrage-Header.

  3. Klicken Sie auf Hinzufügen. Der Parameter wird als neue Zeile in der Tabelle angezeigt.

  4. Wiederholen Sie die drei vorherigen Schritte für alle Parameter.

Klicken Sie auf Speichern, um die Änderungen zu speichern, oder auf Abbrechen, um sie zu verwerfen.

Token-Anfrage

Die Registerkarte Token-Anfrage enthält Einstellungen für die Token-Anfrage:

• Access-Token-URL: Die URL, an die eine Access-Token-Anfrage gesendet wird.

• Parameter: Um Parameter für die Anfrage hinzuzufügen, führen Sie diese Schritte aus:

  1. Geben Sie Werte für Schlüssel und Wert ein.

  2. Um die Methode zum Senden von Parametern auszuwählen, klicken Sie auf das Menü Senden in und wählen Sie eine der Optionen Anfrage-URL, Anfrage-Header oder Anfrage-Text.

  3. Klicken Sie auf Hinzufügen. Der Parameter wird als neue Zeile in der Tabelle angezeigt.

  4. Wiederholen Sie die drei vorherigen Schritte für alle Parameter.

Klicken Sie auf Speichern, um die Änderungen zu speichern, oder auf Abbrechen, um sie zu verwerfen.

Aktualisierungsanfrage

Die Registerkarte Aktualisierungsanfrage enthält Einstellungen für die Token-Aktualisierungsanfrage:

• Refresh-Token-URL: Die URL zum Anfordern eines neuen Access-Tokens.

• Parameter: Um Parameter für die Anfrage hinzuzufügen, gehen Sie wie folgt vor:

  1. Geben Sie Werte für Schlüssel und Wert ein.

  2. Um die Methode zum Senden von Parametern auszuwählen, klicken Sie auf das Menü Senden in und wählen Sie eine der Optionen Anfrage-URL, Anfrage-Header oder Anfrage-Text.

  3. Klicken Sie auf Hinzufügen. Der Parameter wird als neue Zeile in der Tabelle angezeigt.

  4. Wiederholen Sie die drei vorherigen Schritte für alle Parameter.

Klicken Sie auf Speichern, um die Änderungen zu speichern, oder auf Abbrechen, um sie zu verwerfen.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im Harmony-Leitfaden zur Fehlerbehebung:

• OAuth-Aktualisierungstoken-Ablauf führt zum Fehlschlag verbundener Operationen