Confluence Token generieren

Um eine Verbindung zu einer Knowledge Hub Wissensdatenbank herzustellen, müssen Sie entweder Ihre Zugangsdaten an NiCE Professional Services übermitteln oder diese selbst in Knowledge Hub eingeben. Auf dieser Seite wird beschrieben, wie diese Anmeldeinformationen, auch OAuth-Token genannt, generiert werden. Sie sollten die OAuth-Tokens wie Passwörter behandeln. Achten Sie darauf, sie an einem sicheren Ort aufzubewahren. Wenn Sie sie verlieren, müssen Sie sie regenerieren.

Diese Methode ist eine Entwicklerleistung. Es erfordert Kenntnisse in Python und Atlassian-Administratorrechte.

Führen Sie jede dieser Aufgaben in der angegebenen Reihenfolge aus.

Python installieren

Erledigen Sie diese Aufgabe, falls Python noch nicht auf Ihrem Computer installiert ist.

  1. Installieren Sie Python Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft.

  2. Führen Sie das Installationsprogramm aus. Wählen Sie das Kästchen für python.exe zum PATH hinzufügen und klicken Sie dann auf Jetzt installieren.

Authentifizierung konfigurieren

Verwenden Sie diese Methode für die grundlegende Integration mit Confluence. Um ein API-Token zu erstellen, gehen Sie wie folgt vor:

  1. Navigieren Sie zur Seite Atlassian-Kontoeinstellungen Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft.

  2. Klicken Sie auf den Tab Sicherheit.

  3. Auf der Seite API-Token wählen Sie API-Token erstellen.

  4. Im Dialogfeld API-Token erstellen:

    • Geben Sie einen Namen für das Token ein.

    • Geben Sie die Gültigkeitsdauer des Tokens an.

    • Auswählen Erstellen.

    Das System generiert ein API-Token.

    Hinweis: API-Tokens können bis zu einem Jahr gültig sein. Achten Sie darauf, die Lizenzen vor Ablauf der Gültigkeit zu verlängern, um Unterbrechungen zu vermeiden.

  5. Kopieren Sie das Token und bewahren Sie es an einem sicheren Ort auf.

    Hinweis: Nach dem Schließen des Dialogfelds können Sie das Token nicht mehr anzeigen.

OAuth-Authentifizierung konfigurieren

Um die OAuth-Authentifizierung einzurichten, befolgen Sie diese Schritte, um einen sicheren und eingeschränkten Zugriff auf Confluence mithilfe einer sicheren Anmeldemethode namens OAuth 2.0 zu ermöglichen.

  1. Gehe zur Atlassian Developer Console Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft und melde dich mit deinem Atlassian-Konto an.

  2. Erstellen oder wählen Sie Ihre App aus:

    • Falls Sie noch keine App erstellt haben:

      • Auswählen Erstellen.

      • Wählen Sie im Dropdown-Menü OAuth 2.0 (3LO) als App-Typ aus.

      • Geben Sie einen Namen und eine Beschreibung für Ihre App ein.

      • Wählen Sie Erstellen, um den Vorgang abzuschließen.

    • Falls Sie bereits eine App haben:

      • Wählen Sie die App aus der Liste Meine Apps aus.

  3. Gehen Sie zur Übersicht-Seite der App und wählen Sie im linken Navigationsbereich Berechtigungenaus.

    • Unter Confluence APIwählen Sie Hinzufügenund anschließend Konfigurieren.

    • Aktivieren Sie die erforderlichen Bereiche:

      • Wählen Sie für Classic Bereiche Edit aus und aktivieren Sie alle Leseberechtigungen.

      • Wählen Sie für Granular Bereiche Edit aus und aktivieren Sie alle Leseberechtigungen.

    • Wählen Sie Speichern, um die Bereichseinstellungen anzuwenden.

  4. Im linken Navigationsbereich wählen Sie Authorizationaus.

    • Unter OAuth 2.0 (3LO)wählen Sie Add.

    • Geben Sie im Feld Callback-URL Folgendes ein:

      • https://us-west-2.console.aws.amazon.com/appflow/oauth

    • Wählen Sie Änderungen speichern.

  5. Im linken Navigationsbereich wählen Sie Einstellungen.

  6. Gehen Sie zum Abschnitt Authentifizierungsdetails und kopieren Sie die Client-ID und den Geheimen Schlüssel.

Benutzer- und Gruppenzugriff konfigurieren

In diesem Abschnitt wird erklärt, wie Sie Benutzer hinzufügen, Produktzugriffe zuweisen und Gruppenmitgliedschaften in der Atlassian Admin Console verwalten, um einen ordnungsgemäßen Zugriff auf Confluencezu gewährleisten.

  1. So fügen Sie Benutzer hinzu:

    • Gehen Sie zur Atlassian Admin Console Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft.

    • Wählen Sie im linken Navigationsbereich Verzeichnisund anschließend Benutzer.

    • Wählen Sie Benutzer einladen.

    • Geben Sie die E-Mail-Adressen der Benutzer ein, die Sie einladen möchten.

    • Unter Produktzugriffwählen Sie Confluence aus, um den Zugriff auf die Website zu gewähren.

    • Wählen Sie Einladung senden.

    Hinweis: Benutzer müssen die Einladung annehmen, um ihre Konten zu aktivieren.

  2. Nachdem Benutzer hinzugefügt wurden, weisen Sie ihnen die entsprechenden Produktrollen zu, um deren Zugriffsrechte zu steuern. So weisen Sie den Produktzugriff zu:

    • Wählen Sie in der Liste Users den Namen des Benutzers aus.

    • Auf der Benutzerprofilseite wählen Sie die Registerkarte Produktzugriff aus.
      Hinweis: Stellen Sie sicher, dass Confluence ausgewählt ist.

    • Weisen Sie dem Benutzer die passende Rolle entsprechend seinen Verantwortlichkeiten zu. Zum Beispiel Benutzer, Administrator usw.

  3. Um Benutzer zu Gruppen hinzuzufügen

    • Wählen Sie im linken Navigationsbereich Verzeichnisund anschließend Gruppen.

    • Wählen Sie die die Gruppe aus, die Sie verwalten möchten.

    • Select Add members.

    • Suche nach Benutzern anhand des Namens oder der E-Mail-Adresse.

    • Wählen Sie die Benutzer aus und bestätigen Sie das Hinzufügen.

    Gruppenbasierter Zugriff vereinfacht die Berechtigungsverwaltung über mehrere Bereiche und Produkte hinweg.

  4. Gruppenmitgliedschaften helfen dabei, Berechtigungen und Zugriffsebenen effizient zu verwalten. Folgende Gruppen werden empfohlen:

    GRUPPENNAME

    ZWECK
    confluence-admins-servion11 Administratorzugriff
    confluence-user-access-admins-servion11 Benutzerzugriff verwalten

    confluence-users-servion11

    		Allgemeiner Benutzerzugriff
    org-admins Administratoren auf Organisationsebene

Generiere OAuth Tokens mit Python

Verwenden Sie das Python-Skript aus dieser TXT-Datei, um Authentifizierungstoken für den Zugriff auf die API zu generieren. Bevor Sie das Skript ausführen, ersetzen Sie bitte die Platzhalterwerte für client_id und client_secret durch Ihre tatsächlichen Anmeldeinformationen.

Hinweis: Stellen Sie sicher, dass die Umleitungs-URIs mit den in der Entwicklerkonsole konfigurierten übereinstimmen.

Konfigurieren von Berechtigungen auf Bereichsebene in Confluence

Mit den Berechtigungen auf Bereichsebene in Confluence können Sie steuern, wer Inhalte innerhalb eines bestimmten Bereichs anzeigen, bearbeiten oder verwalten darf. Führen Sie die folgenden Schritte aus, um die Berechtigungen für einen Bereich zu konfigurieren:

  1. Melden Sie sich in Ihrem Confluence-Bereich mit Ihren Zugangsdatenan.

  2. Suchen Sie im linken Navigationsbereich den Bereich, den Sie verwalten möchten, und klicken Sie darauf.

  3. Klicken Sie innerhalb des Bereichs auf Bereichseinstellungen.

  4. Scrollen Sie zum Abschnitt Space Access und klicken Sie auf Users. Dadurch öffnet sich die Benutzeroberfläche, über die Sie Berechtigungen für einen Benutzer oder eine Benutzergruppe hinzufügen oder entfernen können.

  5. Klicken Sie auf Bearbeiten und aktivieren Sie den Zugriff auf Anzeigen.

  6. Nachdem Sie die entsprechenden Berechtigungen zugewiesen haben, klicken Sie auf Speichern.

Ablauf des Zugriffstokens

Wenn Ihr Zugriffstoken abgelaufen ist, können Sie keine API-Aufrufe mehr durchführen. Um dies zu beheben, gehen Sie zur AtlassianDeveloper Console Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft und generieren Sie ein neues Token.