Seite „App-Registrierungen“ in der Jitterbit Management Console

Einführung

Auf der Seite „App-Registrierungen“ können Administratoren von Harmony-Organisationen 3-Legged-OAuth-2.0-Anwendungen (3LO) von Drittpartei für die Verwendung mit bestimmten Integration Studio Konnektoren registrieren. Sobald die 3LO-Anwendung von Drittpartei auf der Seite „App-Registrierungen“ registriert ist, können Sie eine Verbindung mit 3-Legged-OAuth 2.0 authentifizieren.

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

Notiz

Wenn Sie eine Cloud-Anwendung (von Jitterbit bereitgestellt) verwenden, ist zum Konfigurieren einer Verbindung keine App-Registrierung erforderlich.

Auf der Seite App-Registrierungen können Organisationsadministratoren private Anwendungen mit 3LO-fähigen Konnektoren registrieren, die Details des OAuth-Anbieters festlegen und das Verhalten der Aktualisierungstoken definieren. Um die Seite zu öffnen, wählen Sie Management Console > Anpassungen > App-Registrierungen im Harmony Portalmenü:

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

Sicht

Wenn keine Registrierungen vorliegen, enthält der Hauptteil der Seite eine Symbolleiste und eine leere Tabelle:

Bei Registrierungen enthält der Hauptteil der Seite eine Symbolleiste und eine Tabelle mit verfügbaren Registrierungen:

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

• Neu erstellen: Neue Registrierung erstellen.

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

  • Erweiterte Optionen: Erweiterte Optionen anzeigen für die Registrierung.

  • Bearbeiten: Registrierung bearbeiten.

  • Löschen: Registrierung löschen.

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

Erstellen

So erstellen Sie eine neue Connector-App-Registrierung:

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

   

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

   Im Abschnitt Neue App-Registrierung erstellen:

   • Name: Ein für den Connector eindeutiger Name für die Registrierung.

   • Beschreibung: Eine Beschreibung für die Registrierung.

   • Konnektor: Klicken Sie hier, 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
     • HTTP v2
     • Jira
     • Slack

   • Client-ID: Die vom OAuth-Anbieter zugewiesene Client-ID.

   • Client-Geheimnis: Das vom OAuth-Anbieter zugewiesene Client-Geheimnis.

   • Geltungsbereich: Ein oder mehrere durch Leerzeichen getrennte OAuth 2.0 scopes.

   Im Abschnitt Konfiguration:

   • Authentifizierungs URL: Die URL, an die eine Autorisierungsanfrage gesendet werden soll.

   • URL des Zugriffstokens: Die URL, an die eine Zugriffstokenanforderung gesendet werden soll.

   • URL des Aktualisierungstokens: Die URL zum Anfordern eines neuen Zugriffstokens.

3. Klicken Sie auf Speichern, um die Werte zu speichern, oder Abbrechen zum Abbrechen:

   

4. Nach erfolgreichem Speichern erscheint die Registrierung als neuer Eintrag in der Tabelle:

   

Bearbeiten

So bearbeiten Sie eine Registrierung:

1. Bewegen Sie den Mauszeiger über eine Registrierung in der Tabelle, um die Aktionssymbole anzuzeigen. Klicken Sie anschließend auf Bearbeiten. Der Bereich App-Registrierung bearbeiten wird angezeigt:

   

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

   Hinweis

   Der Connector einer Registrierung kann vom ursprünglichen Wert nicht geändert werden.

3. Lesen Sie die Benachrichtigung oben rechts im Fenster. Um die Benachrichtigung zu schließen, klicken Sie auf das Schließen-Symbol.

Löschen

So löschen Sie eine Registrierung:

1. Bewegen Sie den Mauszeiger über eine Registrierung in der Tabelle, um die Aktionssymbole anzuzeigen. Klicken Sie anschließend auf Löschen.

2. Der Dialog App-Registrierung löschen wird geöffnet:

   

3. Geben Sie den Text LÖSCHEN ein und klicken Sie anschließend auf Löschen oder auf Abbrechen, um den Vorgang abzubrechen.

Erweiterte Optionen

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

Um sie zu öffnen, bewegen Sie den Mauszeiger über eine Registrierung in der Tabelle und klicken Sie dann auf Erweiterte Optionen. Die Leiste erscheint unten auf der Seite:

Die Registerkarte enthält folgende Registerkarten:

• Token-Richtlinie

• Authentifizierungsanfrage

• Token-Anfrage

• Anfrage aktualisieren

Tipp

Wenn eine Tab ungültige Einstellungen hat, wird die Schaltfläche Speichern inaktiv und ein Fehlersymbol wird neben der Registerkartenbeschriftung angezeigt.

Token-Richtlinie

Die Tab Tokenrichtlinie enthält Einstellungen für das Token:

Wichtig

Aktivieren Sie die Einstellungen der Tab Token-Richtlinie nur, wenn sie auch im OAuth-Anbieter aktiviert sind.

Folgende Einstellungen stehen zur Verfügung:

• Ablauf des Aktualisierungstokens aktivieren: Klicken Sie hier, um den Ablauf des auf dieser Seite generierten Aktualisierungstokens zu aktivieren. In Kombination mit der Einstellung Ablaufbenachrichtigung erhalten einer Verbindung wird der im entsprechenden Feld Tage für Ablaufbenachrichtigung der Verbindung konfigurierte Wert verwendet, um Sie die konfigurierte Anzahl von Tagen vor dem hier konfigurierten Ablauf des Aktualisierungstokens zu benachrichtigen. Wenn diese Option aktiviert ist, werden Sie per Anwendungsbanner und Email benachrichtigt, wenn Token ablaufen oder bereits abgelaufen sind. Beide Benachrichtigungsarten informieren Sie jeweils über das zu tunde Vorgehen.

  Wenn diese Einstellung aktiviert ist, wird die Email Benachrichtigung an die Administratoren der Harmony-Organisation (Mitglieder einer Rolle) gesendet mit Administratorberechtigung und dem 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:

  

  Tipp

  Die empfohlene Einstellung für diesen Wert sollte der des OAuth-Anbieters entsprechen. Wenn beispielsweise das Ablaufdatum des Aktualisierungstokens eines OAuth-Anbieters ein Jahr beträgt, setzen Sie den Wert Ablauf nach auf ein Jahr.

• Ablauf des Aktualisierungstokens bei Inaktivität aktivieren: Klicken Sie hier, um den Ablauf des Tokens bei Inaktivität zu aktivieren. 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 des OAuth-Anbieters entsprechen. Wenn beispielsweise die Ablaufzeit des Aktualisierungstokens eines OAuth-Anbieters 90 Tage beträgt, setzen Sie den Wert Ablauf nach auf 90 Tage.

• Rotierendes Aktualisierungstoken aktivieren: Klicken Sie hier, um die Tokenrotation zu aktivieren:

  

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

Authentifizierungsanfrage

Die Tab Authentifizierungsanforderung enthält Einstellungen für die Token-Authentifizierungsanforderung:

• Authentifizierungs URL: Die URL, an die eine Autorisierungsanfrage gesendet werden soll.

• 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 der Parameter auszuwählen, klicken Sie auf das Menü Senden in und wählen Sie dann eine der Optionen Anforderungs URL oder Anforderungsheader aus.

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

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

Die Tab Tokenanforderung enthält Einstellungen für die Tokenanforderung:

• URL des Zugriffstokens: Die URL, an die eine Zugriffstokenanforderung gesendet werden soll.

• 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 dann eine der Optionen Anforderungs URL, Anforderungsheader oder Anforderungstext aus.

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

  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.

Aktualisierungsanforderung

Die Tab Aktualisierungsanforderung enthält Einstellungen für die Token-Aktualisierungsanforderung:

• URL des Aktualisierungstokens: Die URL zum Anfordern eines neuen Zugriffstokens.

• 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 dann eine der Optionen Anforderungs URL, Anforderungsheader oder Anforderungstext aus.

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

  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.