Jira-Wissenskonnektor

Einführung

Verbinden Sie Jira, damit der KI-Assistent und die Agenten ausgewählte Projekte durchsuchen können, sobald ein Benutzer eine Frage stellt.

Dies ist ein Live-Konnektor. Es werden keine Inhalte aus Jira in Docebo kopiert, indiziert oder gespeichert. Wenn ein Benutzer eine Frage stellt, durchsucht Docebo die von Ihnen verfügbaren Projekte zu diesem Zeitpunkt unter Verwendung des eigenen Jira-Kontos des Benutzers.

So funktionieren die Berechtigungen für Jira: Jeder Kollege verbindet sein eigenes Jira-Konto, sobald dies zum ersten Mal erforderlich ist. Jede Suche wird anschließend als dieser Benutzer ausgeführt. Dadurch wendet Jira seine eigenen Zugriffsregeln an, und die Benutzer sehen nur Inhalte, die sie auch selbst in Jira öffnen könnten. Das Konto, das Sie während der Einrichtung verwenden, wird ausschließlich zum Einrichten der Verbindung verwendet.

1. Voraussetzungen im Quellsystem

Erforderliche Einrichtung

Dieser Konnektor unterstützt nur Jira Cloud.

Erforderliche Rolle

Sie benötigen einen Administrator der Atlassian-Organisation, um die OAuth-App zu erstellen und den Konnektor zu autorisieren.

Erforderliche Einstellungen

Wenn Ihre Organisation eine App-Zulassungsliste verwendet, fügen Sie die neue OAuth-App hinzu, bevor Sie die Autorisierung durchführen.

2. Vorbereitung im Quellsystem

Jira verwendet denselben App-Typ wie der Confluence-Konnektor: eine OAuth-2.0-App (3LO) in der Atlassian Developer Console. Wenn Sie bereits eine App für Confluence erstellt haben, können Sie diese wiederverwenden. Öffnen Sie sie und fahren Sie dann mit Add permissions fort. Bereits erteilte Confluence-Bereiche bleiben bestehen.

App erstellen

Überspringen Sie diesen Schritt, wenn Sie Ihre Confluence-App wiederverwenden.

1. Öffnen Sie die Atlassian Developer Console und erstellen Sie eine neue OAuth-2.0-Integration.
2. Geben Sie einen Namen ein (zum Beispiel „Docebo Knowledge Connector“) und belassen Sie Access type auf Account-level (Standard).

Erstellen Sie eine neue OAuth-2.0-(3LO-)Integration mit der Auswahl des Zugriffstyps.

Berechtigungen hinzufügen

1. Öffnen Sie in der App Permissions. Wählen Sie unter Jira API Add, falls der Eintrag noch nicht aufgeführt ist, und anschließend Configure.
2. Bleiben Sie auf der Registerkarte Classic scopes, wählen Sie Edit Scopes und aktivieren Sie View Jira issue data und View user profiles.
3. Öffnen Sie User identity API und stellen Sie sicher, dass View active user profile aktiviert ist. Wenn die App für Confluence verwendet wird, ist dies bereits der Fall.

Callback-URL hinzufügen

Stellen Sie unter Authorization sicher, dass die unten angegebene Callback-URL unter Callback URLs aufgeführt ist. Wenn dies nicht der Fall ist, fügen Sie sie hinzu und wählen Sie Save changes. Sie folgt immer diesem Muster: https://[IHRE-DOCEBO-PLATTFORM-URL]/knowledge/v1/integrations/connections/callback, zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.

Es handelt sich um dieselbe URL, die der Confluence-Konnektor verwendet. Eine mit Confluence geteilte App enthält sie daher bereits.

Registerkarte Authorization mit dem Feld Callback URL und dem Generator für die Autorisierungs-URL.

Verteilung definieren

Überspringen Sie diesen Schritt, wenn Sie eine App wiederverwenden, die bereits für Confluence eingerichtet ist.

1. Öffnen Sie Distribution und setzen Sie Distribution status auf Sharing.
2. Füllen Sie die erforderlichen Felder mit Ihren eigenen Angaben aus: Anbietername, URL der Datenschutzrichtlinie, URL der Nutzungsbedingungen, Kontakt des Kundensupports und Erklärung zu personenbezogenen Daten.
3. Wählen Sie Save changes.

Verteilungseinstellungen bearbeiten, wobei „Freigabe“ ausgewählt und die Anbieterangaben ausgefüllt sind.

Client-ID und Client-Secret abrufen

Öffnen Sie Settings und kopieren Sie die Client-ID und das Secret aus den Authentication details. Sie fügen diese anschließend in Docebo ein.

3. Erforderliche Aktionen in Docebo

Konnektor autorisieren

1. Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → Jira. Dieses Menü ist nur für Superadmins sichtbar.

2. Geben Sie auf der Registerkarte Authorize die Client-ID und das Client-Secret Ihrer Atlassian-App ein und wählen Sie anschließend Authenticate.

   

3. Prüfen Sie im Atlassian-Popup die angeforderten Zugriffsrechte und wählen Sie Accept. Der Konnektor wird anschließend als verbunden angezeigt. Es wird keine Synchronisierung gestartet, da nichts kopiert wird.

   

4. Wählen Sie aus, welche Projekte durchsucht werden können, und speichern Sie anschließend Ihre Auswahl.