Integration mit Jira Cloud - Amazon Quick

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Integration mit Jira Cloud

Connect Amazon Quick mit Ihrer Jira Cloud-Instanz, um Probleme, Projekte und andere Jira-Objekte zu verwalten. Sie können Jira-Inhalte erstellen, aktualisieren und abfragen, ohne Ihre Amazon Quick-Umgebung zu verlassen. Für diese Integration ist die Amazon Quick Pro-Stufe oder höher erforderlich.

Was Sie tun können

Mit der Jira Cloud-Integration können Sie Aktionen innerhalb Ihrer Jira-Instanzen über die Jira REST-API ausführen.

Action-Konnektor

Über die Jira-REST-API können Sie Jira-Probleme, Projekte und andere Objekte erstellen, aktualisieren und abfragen.

Anmerkung

Diese Integration unterstützt nur die Ausführung von Aktionen. Sie können damit keine Wissensdatenbanken erstellen oder für Suchzwecke auf Jira-Daten zugreifen.

Bevor Sie beginnen

Sie benötigen Folgendes, um die Jira-Integration einzurichten:

  • Jira Cloud-Instanz mit den entsprechenden Berechtigungen.

  • Jira-Benutzerkonto oder API-Token-Anmeldeinformationen.

  • Amazon Quick Author oder höher.

  • Administratorzugriff zur Konfiguration von OAuth Anwendungen (zur Benutzerauthentifizierung).

Erstellen Sie ein Jira-API-Token

Um die API-Schlüsselauthentifizierung zu verwenden, erstelle ein API-Token in deinem Atlassian-Konto.

  1. Gehe zu deinen Atlassian-Kontoeinstellungen und wähle Sicherheit aus.

  2. Erstellen Sie ein neues API-Token für die Amazon Quick-Integration.

  3. Kopieren Sie das generierte Token, um es in Ihrem Amazon Quick-Integrations-Setup zu verwenden.

  4. Notieren Sie sich die URL Ihrer Jira Cloud-Instanz und die Benutzer-E-Mail-Adresse. Die URL deiner Jira Cloud-Instanz ist ein besonderer Wert für API-Aufrufe, den du findest, indem du zu navigierst. https://your-domain.atlassian.net/_edge/tenant_info

Wichtig

Jira Cloud kann HTTP 200-Erfolgsantworten zurückgeben, selbst wenn API-Token gesperrt oder falsch konfiguriert wurden. Weitere Informationen finden Sie unter JARCLOUD-82932. Wenn Ihre Integration anscheinend erfolgreich eine Verbindung herstellt, Aktionen jedoch unerwartet fehlschlagen, überprüfen Sie, ob Ihr API-Token gültig ist und nicht gesperrt wurde.

Richten Sie die Jira-Integration ein

Gehen Sie wie folgt vor, um Amazon Quick mit Ihrer Jira Cloud-Instanz zu verbinden.

  1. Wählen Sie in der Amazon Quick-Konsole Integrationen aus.

  2. Klicken Sie auf Hinzufügen (mit dem Pluszeichen „+“).

  3. Vervollständigen Sie die Integrationsdetails:

    • Name — Geben Sie einen aussagekräftigen Namen für Ihre Jira-Integration ein.

    • Beschreibung (optional) — Beschreiben Sie den Zweck dieser Integration.

  4. Wählen Sie den Verbindungstyp (Benutzer- oder Dienstauthentifizierung).

  5. Vervollständigen Sie die Verbindungseinstellungen auf der Grundlage der Authentifizierungsmethode:

    • Für die Benutzerauthentifizierung (OAuth):

      • Basis-URL — Die URL Ihrer Jira Cloud-Instanz. Diese muss im folgenden Format bereitgestellt werden:https://api.atlassian.com/ex/jira/instanceid. Sie instanceid können gefunden werden, indem Sie zu https://your-domain.atlassian.net/_edge/tenant_info navigieren.

      • Client-ID — Deine Client-ID für die OAuth Atlassian-App.

      • Geheimer Kundenschlüssel — Dein geheimer Kundengeheimnis für die Atlassian-App OAuth .

      • Token-URL — Endpunkt des OAuth Atlassian-Tokens.

      • Auth-URL — OAuth Atlassian-Autorisierungsendpunkt.

      • Weiterleitungs-URL — OAuth Umleitungs-URI.

    • Für die Dienstauthentifizierung (API-Schlüssel):

      • Basis-URL — Die URL Ihrer Jira Cloud-Instanz.

      • API-Schlüssel — Ihr Jira-API-Token.

      • E-Mail — E-Mail-Adresse, die mit Ihrem Jira-Benutzerkonto verknüpft ist.

  6. Wählen Sie Erstellen aus und fahren Sie fort.

  7. Wählen Sie Benutzer aus, mit denen Sie die Integration teilen möchten.

  8. Klicken Sie auf Weiter.

Konfigurieren Sie die Authentifizierung

Die Jira Cloud-Integration unterstützt zwei Authentifizierungsmethoden. Wählen Sie die Methode, die für Ihr Unternehmen am besten geeignet ist.

Benutzerauthentifizierung (OAuth)

Verwenden Sie diese Option, OAuth wenn Aktionen unter individuellen Benutzeridentitäten ausgeführt werden sollen. Konfigurieren Sie diese Felder:

  • Basis-URL — Die URL deiner Jira Cloud-Instanz.

  • Client-ID — Deine Client-ID für die OAuth Atlassian-App.

  • Geheimer Kundenschlüssel — Dein geheimer Kundengeheimnis für die Atlassian-App OAuth .

  • Token-URL — Endpunkt des OAuth Atlassian-Tokens.

  • Auth-URL — OAuth Atlassian-Autorisierungsendpunkt.

  • Weiterleitungs-URL — OAuth Umleitungs-URI.

Erforderliche OAuth Bereiche:

  • read:jira-user- Benutzerinformationen lesen.

  • read:jira-work- Lesen Sie Probleme, Projekte und Arbeitselemente.

  • write:jira-work- Probleme und Arbeitselemente erstellen und ändern.

  • manage:jira-project- Projekteinstellungen verwalten.

  • manage:jira-configuration- Jira-Konfiguration verwalten.

  • manage:jira-webhook- Webhooks verwalten.

  • read:sprint:jira-software- Lesen Sie die Sprint-Informationen.

  • write:sprint:jira-software- Sprints erstellen und ändern.

  • delete:sprint:jira-software- Sprints löschen.

  • write:board-scope:jira-software- Platinenkonfigurationen verwalten.

Dienstauthentifizierung (API-Schlüssel)

Verwenden Sie die API-Schlüsselauthentifizierung für service-to-service Verbindungen. Konfigurieren Sie diese Felder:

  • Basis-URL — Die URL deiner Jira Cloud-Instanz.

  • API-Schlüssel — Ihr Jira-API-Token.

  • E-Mail — E-Mail-Adresse, die mit Ihrem Jira-Benutzerkonto verknüpft ist.

Anmerkung

Aufgrund eines bekannten Verhaltens von Jira Cloud kann es vorkommen, dass die Integration selbst bei widerrufenen oder ungültigen API-Token erfolgreich eine Verbindung hergestellt hat. Wenn Aktionen nach der Einrichtung unerwartet fehlschlagen, überprüfe in deinen Atlassian-Kontoeinstellungen, ob dein API-Token noch gültig ist.

Verfügbare Aktionen

Nachdem du deine Jira-Integration erstellt hast, kannst du diese Aktionen verwenden, um mit Jira Cloud zu interagieren:

  • Jira-Probleme erstellen, lesen, aktualisieren und löschen.

  • Verwalte Problemübergänge und Workflows.

  • Fragen Sie Probleme mit JQL (Jira Query Language) ab.

  • Verwalten Sie Projekte, Komponenten und Versionen.

  • Fügen Sie Kommentare und Anlagen zu Problemen hinzu.

  • Benutzerzuweisungen und Beobachter verwalten.

  • Greifen Sie auf Projekt- und Problemmetadaten zu.

Anmerkung

Die Aktionen, die Sie verwenden können, hängen von den in Ihrer Jira Cloud-Instanz konfigurierten Berechtigungen und Ihrer Authentifizierungsmethode ab.

Integrationen teilen

Sie können Ihren Jira Action Connector mit anderen Benutzern in Ihrer Organisation teilen.

  1. Nachdem Sie die Integration erstellt haben, wählen Sie Integration teilen aus.

  2. Wählen Sie die Benutzer oder Gruppen aus, mit denen Sie die Integration teilen möchten.

  3. Legen Sie die entsprechenden Berechtigungen für den gemeinsamen Zugriff fest.

  4. Bestätigen Sie Ihre Freigabeeinstellungen.

Verwalte Jira-Integrationen

Sie können diese Verwaltungsaufgaben für Ihre Jira-Integrationen ausführen:

  • Integrationseinstellungen bearbeiten — Aktualisieren Sie die Authentifizierungseinstellungen oder die Konfiguration der Jira-Instanz.

  • Integrationszugriff teilen — Stellen Sie die Integration anderen Benutzern in Ihrer Organisation zur Verfügung.

  • Nutzungsmetriken überwachen — Sehen Sie sich Metriken zur Integrationsaktivität und zur API-Nutzung an.

  • Verfügbare Aktionen überprüfen — Sehen Sie sich die vollständige Liste der verfügbaren Jira-Aktionen an.

  • Integration löschen — Entferne die Integration und widerrufe die zugehörige Authentifizierung.