Wiki-Quellcode von Server-Administration
Version 2.1 von MACH ProForms GmbH am 26.02.2020
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | Mit Hilfe der Server-Administrationsoberfläche können bestehende API-Keys ausgelesen werden und auch nachgepflegt werden. Genauso können neue Schlüssel angelegt werden und mit Zertifikaten nach dem X509-Standard zertifiziert werden. Neben den Zertifikaten ist es auch möglich eine Remote-IP zur Authentifizierung zu hinterlegen. |
| 2 | |||
| 3 | Einem Benutzer stehen, je nach definierten [[Benutzerrechten|Main.07_Einstellungen-Fachadministration.02_Benutzer.01_Benutzerrollen]], die Funktion/der Menüpunkt „Server-Administration“ zur Verfügung. Der Menüpunkte befindet sich in dem Hauptmenüpunkt „Einstellungen“ in der „[[Hauptnavigationsleiste|Main.03_Hauptnavigationsleiste]]“ und beinhalten weitere Menüpunkte/Funktionen. | ||
| 4 | |||
| 5 | ***Hinweis: Bitte beachten Sie, diese Funktion steht nur Serveradministratoren zur Verfügung.*** | ||
| 6 | |||
| 7 | ![[Ansicht des Hauptmenüpunkts „Server-Administration“|@ServerAdministrationHauptmenüpunkt.jpg]] | ||
| 8 | ___ | ||
| 9 | |||
| 10 | # Übersicht | ||
| 11 | |||
| 12 | Nach dem Betätigen des Menüpunkts „Server-Administration“ gelangt man auf eine Übersichtsseite. Dieser Bereich befindet sich derzeit noch im Aufbau und wird in Kürze weitere Funktionen beinhalten. | ||
| 13 | |||
| 14 | ![[Ansicht der Übersicht „Server-Administration“|@ServerAdministrationÜbersicht.jpg]] | ||
| 15 | |||
| 16 | ___ | ||
| 17 | |||
| 18 | # API-Keys | ||
| 19 | |||
| 20 | Unter dem Menüpunkt „API-Keys“ gelangt man in die Verwaltung der API-Keys. Hier können neue sowie bereits angelegte API-Keys verwaltet werden. | ||
| 21 | |||
| 22 | ![[Ansicht der „API-Key-Übersicht“|@ServerAdministrationAPIKEY.jpg]] | ||
| 23 | |||
| 24 | ## Filter in der API-Keys-Übersicht | ||
| 25 | |||
| 26 | Über die Filter in der API-Keys-Übersicht kann nach einem/mehreren API-Keys gesucht werden. Folgende Filtermöglichkeiten stehen hierzu zur Verfügung: | ||
| 27 | |||
| 28 | - **Kundennummer**<br /> | ||
| 29 | Hierüber kann nach der Kundennummer gesucht werden. Diese Nummer ist immer eine 12-stellige Nummer, die sich beispielsweise wie folgt aufgliedert 33333333-3333. | ||
| 30 | <br /> | ||
| 31 | |||
| 32 | - **API-Keys**<br /> | ||
| 33 | Hierüber kann nach dem einzigartigen API-Key gesucht werden. | ||
| 34 | <br /> | ||
| 35 | |||
| 36 | - **Zertifiziert**<br /> | ||
| 37 | Hierüber kann nach der Zertifizierung gesucht werden. | ||
| 38 | <br /> | ||
| 39 | |||
| 40 | - **Remote-IP**<br /> | ||
| 41 | Hierüber kann nach der hinterlegtem Remote-IP gesucht werden. | ||
| 42 | <br /> | ||
| 43 | |||
| 44 | - **Gültig von**<br /> | ||
| 45 | Hierüber kann nach dem Gültigkeitsdatum (von) des API-Keys gesucht werden. | ||
| 46 | <br /> | ||
| 47 | |||
| 48 | - **Gültig bis**<br /> | ||
| 49 | Hierüber kann nach dem Gültigkeitsdatum (bis) des API-Keys gesucht werden. | ||
| 50 | <br /> | ||
| 51 | |||
| 52 | - **Beschreibung**<br /> | ||
| 53 | Hierüber kann nach einem Wort in den Notizen gesucht werden. | ||
| 54 | |||
| 55 | ![[Ansicht der Filter|@ApiKeyFilter.jpg]] | ||
| 56 | |||
| 57 | ## Neuer API-Key anlegen ![[Schaltfläche „Neuer API-Key anlegen“|@ApiKeyNeueHinzufügen.jpg]] | ||
| 58 | |||
| 59 | Neue API-Keys können über die Schaltfläche „Hinzufügen“ in der API-Key-Übersicht angelegt werden. Daraufhin öffnet sich die Eingabemaske „API-Key anlegen“, in der die Daten zum API-Key hinterlegt werden können. Folgende Daten müssen angegeben werden: | ||
| 60 | |||
| 61 | - **API-Key** <br /> | ||
| 62 | Hier wird ein entsprechender API-Key beim Anlegen generiert. Da dieser Wert nicht verändert werden darf, ist das Feld schreibgeschützt. | ||
| 63 | <br /> | ||
| 64 | |||
| 65 | - **Kundennummer** <br /> | ||
| 66 | Hier muss die exakte [[Kundennummer|Main.07_Einstellungen-Fachadministration.01_Mandanten]] angegeben werden, sodass der API-Key dem Mandanten entsprechend zugeordnet wird. | ||
| 67 | <br /> | ||
| 68 | |||
| 69 | - **Erstellt**<br /> | ||
| 70 | Hier wird das entsprechende Gültigkeitsdatum angegeben, ab wann das Zertifikat gültig ist. | ||
| 71 | <br /> | ||
| 72 | |||
| 73 | - **Gültig bis**<br /> | ||
| 74 | Hier kann das entsprechende Gültigkeitsdatum angegeben werden, ab wann das Zertifikat nicht mehr gültig ist. Das hier angegebene Datum muss immer beim Anlegen mindestens drei Tage nach dem Datum "Gültig von" liegen. | ||
| 75 | <br /> | ||
| 76 | |||
| 77 | - **Remote-IP**<br /> | ||
| 78 | Hier kann eine Remote-Ip hinterlegt werden. | ||
| 79 | <br /> | ||
| 80 | |||
| 81 | - **Beschreibung**<br /> | ||
| 82 | Hier können interne Notizen hinterlegt werden. Diese haben keinerlei Auswirkungen. | ||
| 83 | <br /> | ||
| 84 | |||
| 85 | - **Zertifikatsdatei**<br /> | ||
| 86 | Hier kann die entsprechende Datei, welche als Zertifikat verwendet werden soll, hochladen werden. Es sind Formate nach dem Standard X.509 zugelassen. | ||
| 87 | |||
| 88 | Nach der Eingabe aller erforderlichen Daten kann der API-Key über die Schaltfläche „Speichern“ gespeichert werden. Der Ersteller wird daraufhin wieder in die „API-Key-Übersicht“ weitergeleitet in der ein neuer Eintrag erstellt wurde. | ||
| 89 | |||
| 90 | ![[Ansicht der Eingabemaske "Neuer API-Key anlegen"|@ApiKeyAnlegen.jpg]] | ||
| 91 | |||
| 92 | ## API-Key bearbeiten ![[Schaltfläche „API-Key bearbeiten“|@ApiKeyBearbeiten.jpg]] | ||
| 93 | |||
| 94 | Müssen die Daten zu einem API-Key geändert werden, so kann dies ein Benutzer, der das entsprechende Recht hat. Hierzu steht die Schaltfläche „Bearbeiten“ in der API-Key-Übersicht direkt am entsprechenden API-Key zur Verfügung. Nach dem Öffnen gelangt man direkt in die Eingabemaske „API-Key bearbeiten“, in der die Daten zum API-Key hinterlegt sind. Nach der Eingabe der geänderten Daten und dem Hochladen eines gültigen Zertifikats muss über die Schaltfläche „Speichern“ der API-Key gespeichert werden. | ||
| 95 | |||
| 96 | ## API-Key löschen ![[Schaltfläche „API-Key löschen“|@ApiKeyLöschen.jpg]] | ||
| 97 | |||
| 98 | Muss ein API-Key gelöscht werden, kann das ein Benutzer, mit dem entsprechenden Recht, in der API-Key-Übersicht. Hierzu steht neben jedem API-Key die Schaltfläche „Löschen“ zur Verfügung. | ||
| 99 | |||
| 100 | |||
| 101 | |||
| 102 |