Readme.md aktualisiert

Readme.md

@@ -1,6 +1,26 @@
-Provider-Plugin neu kompilieren
+# Provider-Plugin neu kompilieren
 Ordner "sourcecode" herunterladen, ggf. Änderungen machen und mit Maven kompilieren:
-mvn clean install
+`mvn clean install`
 
-Ergebnis als .jar-Datei  im Verzeichnis sourcecode/target
+Ergebnis als `.jar`-Datei  im Verzeichnis `sourcecode/target`
 
+
+# Provider-Plugin in keycloak installieren
+- `.jar`-Datei in Ordner `/opt/keycloak/.../providers/` platzieren
+- Inhalt von Ordner "Theme" in Ordner `/opt/keycloak/.../themes/` platzieren
+- Theme "gmp" in Keycloak unter "Realm Settings" > "Themes" > "Login Theme" auswählen
+
+Keycloak neu starten: 
+```
+systemctl stop sso.test.gmpvintern.de.service
+systemctl start sso.test.gmpvintern.de.service
+```
+
+# Plugin nutzen
+- Benutzeraccount, bei welchem man sich mit einem Klick einloggen kann in keycloak-Admin-Interface bearbeiten
+- Zu Reiter "Attributes" wechseln
+- Attribute hinzufügen:
+  - key: `ipLogin` value: `1`
+  - key: `ipAddresses` value: `<ip>`
+Es können beliebig viele Attribute mit dem key `ipAddresses` hinzugefügt werden, da die Feldlänge für die value nur sehr begrenzt ist.
+value kann nur eine IP-Adresse (127.0.0.1) sein oder ein Bereich (127.0.0.1-127.0.0.10) oder mehrere Komma-Separiert (127.0.0.1,192.168.178.2)