Active Directory Auth¶
Einleitung¶
Die Active Directory Auth Erweiterung erlaubt die Authentizität eines Benutzer des Raptor Clients mit einem existierenden Active Directory Servers zu überprüfen. Dabei wird das vom Benutzer eingegebene Passwort mit dem Active Directory System verifiziert.
Fakten¶
Name |
Active Directory Auth |
Bezeichner |
|
Version |
3.1 |
Funktionen |
Authentifizierung |
Konfiguration¶
Das Konfigurationsschema¶
Die Liste Servers¶
Mit der Liste Servers definierst du einen oder mehrere Server welche für die
Der Wert Prefixes¶
Mit dem optionalen Wert Prefixes kannst du eine Leerzeichen-getrennte Liste von Präfixen konfigurieren, für die dieser Server für die Authentifizierung ausgewählt wird. Ein Präfix entspricht bei der Authentifizierung zu einem Active Directory Server dem Domainnamen.
Meldet sich ein Benutzer mit dem Benutzernamen example\john am Raptor System an, entspricht example dem Präfix und john dem Benutzernamen.
Lässt du diesen Wert weg, wird kein Präfix für die Verbindung verwendet.
1<Module name="ActiveDirectoryAuth">
2 <List name="Servers">
3 <ListEntry>
4 <Value name="Prefixes">example</Value>
5 <Value name="Host">example01</Value>
6 <Value name="UserName">administrator</Value>
7 <Value name="Password">[...]</Value>
8 </ListEntry>
9 </List>
10</Module>
Der Wert Host¶
Der erforderliche Wert Host dient dazu, den Hostnamen oder die IP-Adresse des Active Directory Servers anzugeben. Dieser Wert muss konfiguriert und nicht leer sein.
Stelle sicher, dass der Hostname oder die IP-Adresse korrekt und erreichbar ist, damit die Authentifizierung über den Active Directory Server erfolgreich durchgeführt werden kann.
1<Module name="ActiveDirectoryAuth">
2 <List name="Servers">
3 <ListEntry>
4 <Value name="Prefixes">example</Value>
5 <Value name="Host">example01</Value>
6 <Value name="UserName">administrator</Value>
7 <Value name="Password">[...]</Value>
8 </ListEntry>
9 </List>
10</Module>
Der Wert UserName¶
Mit dem optionalen Wert UserName kannst du einen anderen Benutzernamen zur Authentifizierung am Active Directory Server verwenden. Wenn du diesen Wert nicht angibst, wird der Standardbenutzername verwendet mit dem der Raptor Server gestartet wurde.
Gibst du einen Benutzernamen an, musst du auch ein Passwort mit dem Wert Password angeben.
1<Module name="ActiveDirectoryAuth">
2 <List name="Servers">
3 <ListEntry>
4 <Value name="Prefixes">example</Value>
5 <Value name="Host">example01</Value>
6 <Value name="UserName">administrator</Value>
7 <Value name="Password">[...]</Value>
8 </ListEntry>
9 </List>
10</Module>
Der Wert Password¶
Mit dem optionalen Wert Password definierst du das Passwort, welches zur Authentifizierung am Active Directory Server verwendet wird. Lässt du diesen Wert weg, wird kein Passwort verwendet.
Gibst du einen Benutzernamen mit dem Wert UserName an, musst du auch ein Passwort angeben.
Schütze dieses Passwort indem du es kodierst, wie es im Kapitel Kodieren von Passwörtern beschrieben wird.
1<Module name="ActiveDirectoryAuth">
2 <List name="Servers">
3 <ListEntry>
4 <Value name="Prefixes">example</Value>
5 <Value name="Host">example01</Value>
6 <Value name="UserName">administrator</Value>
7 <Value name="Password">[...]</Value>
8 </ListEntry>
9 </List>
10</Module>
Der Wert Container¶
Mit dem optionalen Wert Container kannst du einen LDAP-Pfad angeben, der auf eine LDAP-Gruppe verweist, um die Benutzer für die Authentifizierung einzuschränken. Nur Benutzer, die in der angegebenen Gruppe verfügbar sind, können sich dann am Raptor System authentifizieren.
Der LDAP-Pfad sollte in der korrekten LDAP-Syntax angegeben werden, zum Beispiel: OU=Gruppe,DC=example,DC=com. Lässt du diesen Wert weg, sind alle Benutzer im Active Directory für die Authentifizierung verfügbar.
1<Module name="ActiveDirectoryAuth">
2 <List name="Servers">
3 <ListEntry>
4 <Value name="Prefixes">example</Value>
5 <Value name="Host">example01</Value>
6 <Value name="UserName">administrator</Value>
7 <Value name="Password">[...]</Value>
8 <Value name="Container">OU=Gruppe,DC=example,DC=com</Value>
9 </ListEntry>
10 </List>
11</Module>
Der Wert SSL¶
Mit dem Wert SSL aktivierst du eine verschlüsselte Verbindung zum Active Directory Server. Lässt du diesen Wert weg, wird als Standartwert No verwendet welches eine unverschlüsselte Verbindung aufbaut.
Wir empfehlen dir diesen Wert immer auf Yes zu setzten und eine verschlüsselte Verbindung zum Active Directory Server aufzubauen. Eine SSL-Verbindung bietet zusätzliche Sicherheit, indem die Kommunikation zwischen dem Raptor System und dem Active Directory Server verschlüsselt wird.
1<Module name="ActiveDirectoryAuth">
2 <List name="Servers">
3 <ListEntry>
4 <Value name="Prefixes">example</Value>
5 <Value name="Host">example01</Value>
6 <Value name="UserName">administrator</Value>
7 <Value name="Password">[...]</Value>
8 <Value name="SSL">Yes</Value>
9 </ListEntry>
10 </List>
11</Module>
