CLM:Authentik:Token

	In diesem Artikel wird beschrieben, wie man ein Token in Authentik generiert. Für die Verwendung von Diensten auf der Web-Seite chessleaguemanager.org haben wir einen Single-Sign-On-Dienst implementiert. Dieser Dienst (Authentik) erlaubt es, an einen Anwender verschiedene Rechte zu binden. Beispielsweise kann ein Anwender Zugriff auf die Haupt-Webseite haben, gleichzeitig aber auch dieses Wiki um Beiträge erweitern, sofern die Berechtigung hierzu erteilt wurde. Alle Berechtigungen können angefordert werden, jeder ist aufgerufen, die Dokumentation des ChessLeagueManagers zu verbessern. Für die automatische Nutzung von Diensten durch Programme wird ein anderer Weg der Anmeldung gewählt (mit einem API-Token). Dazu meldet man sich mit seinem Benutzer im Front-End des Authentik-Systems an https://authentik.chessleaguemanager.org:7743. Dabei kann der gleiche Benutzername und das gleiche Passwort verwendet werden, wie es auch auf der Web-Seite genutzt wird. Hat man noch keine Kennung erstellt, so muss man sich einmalig registrieren. Dazu einfach auf den Link am unteren Ende des Anmeldebildschirms klicken und den Anweisungen folgen. Hierdurch erhält man automatisch den Zugriff zur Web-Seite. Die Freigabe der besonderen Berechtigungen (siehe weiter unten) erfolgt nur über das CLM-Kernteam. Diese Berechtigung muss beantragt werden. Sie ist für die erfolgreiche Nutzung eines CLM-Dienstes unabdingbar. Dafür bitte folgende Email-Adresse benutzen: mailto:dienste@chessleaguemanager.org Folgende Berechtigungen/Dienste stehen aktuell zur Auswahl: * Pairing - für CH-System-Auslosung Einzelturniere * Spielerdatenbank - für Aktualisierung Spieler- und Vereinsdaten über den CLM-Server * Mediwiki - für Bearbeitung und Erweiterung der Anleitungen zum CLM-System (wird nur einem begrenzten Nutzerkreis zur Verfügung gestellt). Mit einem Token können mehrere Dienste im CLM genutzt werden. Empfehlung lt. Datensicherheitsrichtlinien ist zwar, für jeden Dienst einen separaten Nutzer mit einem anderen Token zu nutzen. Wie es der Nutzer mit seinen Installationen hält, legen er bzw. die Richtlinien seiner Organisation selber fest.
	Wenn man angemeldet ist, klickt man auf das "Zahnrad" (= Einstellungen). Im Bild links ist dieses pink eingefärbt.
	Es öffnet sich ein Menue auf der linken Seite, hier klickt man auf Anmeldedaten. Im rechten Fenster dann im Bereich "Tokens und App Passwörter" mit einem Klick auf die Schaltfläche [New Token] gelangt man zu einem neuen Eingabefeld.
	Im Feld für die Kennung dürfen nur Buchstaben und Ziffern, sowie der Unterstrich, aber kein Leerzeichen verwendet werden. In die Beschreibung darf man jedes beliebige Zeichen eintragen. Anschließend auf die Schaltfläche [Token erstellen] klicken.
	Unter dem Feld "Aktionen" kann man entweder die Token bearbeiten oder in die Zwischenablage kopieren. Jetzt also den Token in die Zwischenablage kopieren. Den Wert aus der Zwischenablage können wir z.B. in den ChessLeagueManager-Einstellungen in das gewünschte Feld mittels der Tastenkombination <Strg> + v einfügen.