Voraussetzungen

  • Sie benötigen Administrator-Zugriff auf Ihre XWiki-Instanz.

1. amberconnector Benutzer in XWiki erstellen

Wichtig: Der amberconnector-Benutzer muss nur innerhalb von XWiki selbst (Standard XWiki Authenticator) auf globaler Ebene erstellt werden. Sie müssen diesen Benutzer nicht in Ihrem Active Directory, LDAP oder SSO-System anlegen, falls Sie eine externe Authentifizierung konfiguriert haben.

  1. Melden Sie sich als Administrator bei Ihrer XWiki-Instanz an.

  2. Navigieren Sie zu Globale AdministrationBenutzer & GruppenBenutzer.

    • Sie erreichen dies typischerweise über die URL: https://<ihre-xwiki-domain>/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Users

  3. Füllen Sie das Formular Neuen Benutzer hinzufügen mit den folgenden Details aus:

    • Vorname: Amber

    • Nachname: Connector

    • Benutzername: amberconnector

    • Kennwort: Wählen Sie ein starkes, sicheres Passwort.

  4. Wichtig: Stellen Sie sicher, dass Sie einen globalen Benutzer erstellen, keinen lokalen (wiki-spezifischen).

  5. Klicken Sie auf Erstellen, um den Benutzer anzulegen.

2. Benutzer zur XWikiAdminGroup hinzufügen

Der amberconnector-Benutzer muss der XWikiAdminGroup hinzugefügt werden, um sicherzustellen, dass er Zugriff auf alle Inhalte, Benutzerprofile und Gruppenmitgliedschaften hat, ohne dass explizite Ansichtsberechtigungen für einzelne Seiten erforderlich sind.

  1. Navigieren Sie zu Globale AdministrationBenutzer & GruppenGruppen.

    • Sie erreichen dies typischerweise über die URL: https://<ihre-xwiki-domain>/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Groups

  2. Suchen Sie die Gruppe mit dem Namen XWikiAdminGroup.

  3. Bearbeiten Sie die Gruppe.

    • Beispiel für Direktlink: https://<ihre-xwiki-domain>/bin/edit/XWiki/XWikiAdminGroup

  4. Im Bereich Benutzer zu Gruppe hinzufügen:

    • Wählen Sie den gerade erstellten amberconnector-Benutzer aus oder suchen Sie danach.

  5. Klicken Sie auf Hinzufügen, um den Benutzer zur Gruppe hinzuzufügen.

Warum dies erforderlich ist: Ohne Mitgliedschaft in der Administrator-Gruppe kann der Benutzer nicht alle Inhalte, Benutzer und Gruppen sehen, bei denen er nicht explizit Mitglied ist oder keine expliziten Ansichtsrechte erhalten hat. Die XWikiAdminGroup-Mitgliedschaft bietet den umfassenden Zugriff, der für eine vollständige Indexierung und Benutzerauthentifizierung erforderlich ist.

3. Zugangsdaten teilen

Sobald der Benutzer erstellt und der XWikiAdminGroup zugewiesen wurde, teilen Sie bitte folgende Informationen sicher mit dem Amber-Support-Team:

  1. URL Ihrer XWiki-Instanz.

  2. Benutzername (amberconnector)

  3. Kennwort

Die Englische Version für das Set Up von XWiki ist hier zu finden.