Benutzer importieren, exportieren und Löschen per CSV-Liste
TightGate-Pro kann Benutzer aus vordefinierten Listen importieren oder Löschen. Den Benutzern können dabei verschiedene Merkmale übergeben werden. Die Importfunktion ist nur zur Datenübernahme für neue Benutzerkonten geeignet. Merkmale bestehender Benutzerkonten können über den Listenimport nicht verändert werden. Auch der Export von Benutzerkennungen nach vordefinieren Filtern in eine CSV-Datei ist möglich.
Import von Benutzern über eine Liste
- Spezifikationsgerechte Liste mit Benutzerangaben bereitstellen (vgl. Abschnitt Spezifikation der Liste für den Import)
- Hinterlegung der Liste per Dateischleuse mit dem Administrator config in das Verzeichnis /home/config/transfer. Bei CC-Systemen erfolgt die Übertragung als Benutzer transfer.
- Anmeldung an TightGate-Pro als Administrator maint und Auswahl von Benutzerverwaltung > Importiere Benutzer.
- Auswahl der CSV-Datei, aus der die Benutzerangaben importiert werden sollen. Die Benutzerangaben werden importiert. Dabei entstehen neue Benutzerkonten. Nach Abschluss des Imports erfolgt eine Zusammenfassung über importierte Benutzerdaten, nicht importierte Benutzerdaten und aufgetretene Fehler.
- Alle importierten Benutzer stehen fortan automatisch in einer neu erzeugten Gruppe bereit, um darüber einzelne Attribute ändern zu können. Der Name der Gruppe lautet: import[Datum in der Form JJJJMMDD][Uhrzeit in der Form SSMM]
Enthält die CSV-Datei ungültige Werte in den Attributen (z.B. Audio=2), so werden diese beim Import ignoriert und statt dessen die Systemvorgaben des Administrators config aus den Benutzer-Vorgaben verwendet.
Alle Änderungen sind nach dem Import sofort wirksam. Neue Benutzer können sich unmittelbar anmelden. Bei Cluster-Systemen kann eine Wartezeit bis zu 10 Minuten erforderlich sein, bis die Benutzerkonten auf alle Knoten verteilt wurden.
Spezifikation der Liste für den Import
Eine Liste für den Benutzerimport in TightGate-Pro muss folgende Anforderungen erfüllen:
- Die CSV-Datei muss die Endung .csv haben
- Trennzeichen der Felder in der CSV-Datei ist das Semikolon (;)
- Zeichenkette, z.B. Namen, in der CSV-Datei können durch Anführungszeichen ("") abgegrenzt werden, Zahlenwerte werden immer ohne Anführungszeichen angegeben
- Die CSV-Datei darf keine Tabellenüberschrift enthalten
- Wird in der Liste kein Passwort angegeben, so hat der neu angelegte Benutzer ein deaktiviertes Passwort.
- Es sind in der CSV-Datei keine Umlaute (öäüß), Sonderzeichen (,.-;:'`´) oder Leerzeichen erlaubt. Ausnahme bildet der Unterstrich "_". (Ergänzung: In Klarnamen (Spalte 2) sind Umlaute erlaubt, aber keine Sonder- oder Leerzeichen (s. o.). Wird ein ungültiges Zeichen verwendet, wird anstelle des Klarnamen der Benutzername (Spalte 1)verwendet.)
Die CSV-Datei hat folgenden schematischen Aufbau:
Benutzer- name | Klar- name | Passwort | Datei- transfer | Gefiltertes Web | Sound | Zwischen- ablage | Profil | Privilegiert | Max. Dateigröße | Auto- schleuse |
|
---|---|---|---|---|---|---|---|---|---|---|---|
leer lassen = deaktiviert | 0 = aus 1 = an | 0 = gefiltert 1 = ungefiltert | 0 = aus 1 = an | 0 = aus 1 = an | 0 = Standard 3 = Custom | 0 = nein 1 = Ja | 0 = nein 1 = Ja | 0 = bis 4GB 1 = unbegrenzt | 0 = aus 1 = an |
Eine Zeile aus einer CSV-Datei könnte demnach folgendermaßen aussehen:
- tgpro.csv
"eka1";"Erika Mustermann";"geheim";0;0;0;0;0;0;0;0;0
oder ohne Anführungszeichen
- tgpro.csv
eka1;Erika Mustermann;geheim;0;0;0;0;0;0;0;0;0
Alle Einstellungen bezüglich der Menü-Vorgaben werden aus den Voreinstellungen des Administrators Config automatisch übernommen. Eine Änderung ist nur nachträglich über die Benutzerverwaltung möglich.
Es werden nur neue Benutzer anhand des Benutzernamens importiert. Werte bestehender Benutzerkonten werden übersprungen und weder aktualisiert noch verändert. Nach dem Import wird eine Zusammenfassung mit Ergebnisbilanz auf dem Bildschirm angezeigt.
Löschen von Benutzern über eine Liste
So geht's:
- Spezifikationsgerechte Liste mit Benutzerangaben bereitstellen (vgl. Abschnitt Spezifikation der Liste für das Löschen)
- Hinterlegung der Liste per Dateischleuse mit dem Administrator config in das Verzeichnis /home/config/transfer. Bei CC-Systemen erfolgt die Übertragung als Benutzer transfer.
- Anmeldung an TightGate-Pro als Administrator maint und Auswahl von Benutzerverwaltung > Lösche Benutzer > CSV-Benutzer anzeigen.
- Auswahl der CSV-Datei, aus der die zu löschenden Benutzerkennungen gelesen werden sollen.
- Es wird eine Liste aller Kennungen angezeigt, welche in der CSV-Datei erkannt wurden und auf TightGate-Pro existieren.
- Es können nun einzelne oder alle Kennungen ausgewählt werden. Nach Auswahl und Bestätigung der zu löschenden Kennungen wird auf dem Bildschirm eine Zusammenfassung aller zu löschenden Kennungen angezeigt. Wird die Auswahl bestätigt, werden die Kennungen gelöscht.
Spezifikation der Liste für das Löschen
Eine Liste zum Löschen von Benutzerkennungen auf TightGate-Pro muss folgende Anforderungen erfüllen:
- Die CSV-Datei muss die Endung .csv haben
- Trennzeichen der Felder in der CSV-Datei ist das Semikolon (;)
- Es ist nur notwendig die erste Spalte auszufüllen.
- Die Zeichenkette in der CSV-Datei darf nicht durch Anführungszeichen („") abgegrenzt sein
- Die CSV-Datei darf keine Tabellenüberschrift enthalten
Eine CSV-Datei zum löschen der Benutzerkennungen eka1 und test2 würde demnach folgendermaßen aussehen:
- tgpro_delete.csv
eka1; test2;
Exportieren von Benutzern in eine CSV-Liste
So geht's:
- Anmeldung am TightGate-Pro als Administrator maint und Auswahl von Benutzerverwaltung > Exportiere Benutzer.
- Es werden vordefinierten Filter angezeigt, worüber eine Vorauswahl von Kennungen möglich ist. Wird keine Vorauswahl gewünscht ist der Filter Alle Benutzer exportieren auszuwählen.
- Eine Liste derjenigen Kennungen angezeigt, welche den Filterkriterien entsprechen. Die angezeigten Kennung können komplett ausgewählt werden oder es können einzelne Kennungen manuell ausgewählt werden. Die Auswahl erfolgt über die Leertaste.
- Ist die Auswahl abgeschlossen wird dies durch Drücken der ENTER-Taste bestätigt. Daraufhin werden die Kennungen in eine CSV-Liste exportiert. Die CSV-Liste wird in das Transfer-Verzeichnis des Administrators config abgelegt. Eine Hinweisfenster zeigt nochmal den Pfad und Namen der neu erzeugten CSV-Datei an.