Konfigurationsdatei AuthenticationServiceConfiguration: Unterschied zwischen den Versionen
| Zeile 98: | Zeile 98: | ||
| | | | ||
:::attributeName | :::attributeName | ||
| − | | | + | | Legt fest in welchem Attribute succest den tatsächlichen Namen des Nutzerobjektes erwartet. |
|- | |- | ||
| | | | ||
:::attributeGroups | :::attributeGroups | ||
| − | | | + | | In der Regel realisiert LDAP die Zugehörigkeit einzelner Benutzerobjekte zu Gruppen durch ein Attribut, das mehrfach genannt die Gruppen als Werte liefert, denen der Benutzer angehört. Der Name dieses Attributes ist hier anzugeben. |
|- | |- | ||
| | | | ||
:::attributeObjectId | :::attributeObjectId | ||
| − | | | + | | succest benötigt zwingend eine [https://de.wikipedia.org/wiki/Globally_Unique_Identifier GUID] für jedes LDAP-Benutzer-Objekt. Microsoft [https://de.wikipedia.org/wiki/Active_Directory Active Directory] enthält von Haus aus ein Attribut für jedes Objekt, in dem eine GUID steht (objectGUID). Andere LDAP Implementierungen bringen ein solches Attribut nicht von Haus aus mit. In diesem Falle kann succest einen anderen eindeutigen Wert (z. B. den des Attributes, das bereits als UPN verwendet wird) heranziehen und daraus selbst eine GUID ermitteln. |
|} | |} | ||
[[Category:Konfiguration]] | [[Category:Konfiguration]] | ||
Version vom 22. August 2017, 08:27 Uhr
Diese Konfiguration legt fest, auf welche Art und Weise das succest Testcase Repository (TCR) und der succest Testcase Editor (TCE) Zugriffe authentifizieren und autorisieren soll.
- Kurzform: AuthenticationServiceConfiguration
- Vollständig: TestcaseRepositoryAPI.UserAndSessionManagement.AuthenticationServiceConfiguration.config
Beispiel
<root>
<AuthServiceClass Type="string">TestcaseRepositoryAPI.AuthenticationServiceLDAP</AuthServiceClass>
<ConfigNode Type="XmlDocument">
<config>
<ldapServer> <!-- Erster LDAP Server zur Abfrage (Windows Server 2012 AD) -->
<ldapString>LDAPS://192.168.220.101:636/DC=dom2012r2,DC=local</ldapString>
<ldapUserName>administrator@dom2012r2.local</ldapUserName>
<ldapPassword>XYZ</ldapPassword>
<ldapFilter>(&(objectClass=user)(|(sAMAccountName={0})(userPrincipalName={0})))</ldapFilter>
<attributes>
<attributeUPN>userPrincipalName</attributeUPN>
<attributeName>name</attributeName>
<attributeGroups>memberOf</attributeGroups>
<attributeObjectId>objectGUID</attributeObjectId>
</attributes>
</ldapServer>
<ldapServer> <!-- Zweiter LDAP Server zur Abfrage (Windows Server 2016 AD) -->
<ldapString>LDAP://192.168.220.102:389/CN=Users,DC=dom2016,DC=local</ldapString>
<ldapUserName>administrator@dom2016.local</ldapUserName>
<ldapPassword>XYZ</ldapPassword>
<ldapFilter>(&(objectClass=user)(|(sAMAccountName={0})(userPrincipalName={0})))</ldapFilter>
<attributes>
<attributeUPN>userPrincipalName</attributeUPN>
<attributeName>name</attributeName>
<attributeGroups>memberOf</attributeGroups>
<attributeObjectId>objectGUID</attributeObjectId>
</attributes>
</ldapServer>
<ldapServer> <!-- Dritter LDAP Server zur Abfrage (Apache DS) -->
<ldapString>LDAP://localhost:10389/ou=users,dc=succest,dc=local</ldapString>
<ldapUserName />
<ldapPassword />
<ldapFilter>(&(objectClass=person)(givenName={0}))</ldapFilter>
<attributes>
<attributeUPN>mail</attributeUPN>
<attributeName>sn</attributeName>
<attributeGroups>seeAlso</attributeGroups>
<attributeObjectId>mail</attributeObjectId>
</attributes>
</ldapServer>
</config>
</ConfigNode>
</root>
Elemente
| Element | Beschreibung |
|---|---|
|
AuthServiceClass |
Definiert die zu verwendende Implementierung für die Authentifizierung.
Dabei sind folgende Varianten unterstützt:
|
|
ConfigNode/config |
Wir nur benötigt wenn AuthServiceClass auf TestcaseRepositoryAPI.AuthenticationServiceLDAP gesetzt ist. |
|
Sich wiederholender Klammer-Tag. Je abzufragendem LDAP Server wird ein ldapServer-Tag geöffnet und geschlossen. |
|
Zeichenkette die für die Verbindung zum LDAP genutzt wird.
WICHTIG Das Schema 'LDAP' oder 'LDAPS' innerhalb des URI muss groß geschrieben werden. |
|
Username zur Anmeldung am LDAP Server. Der Wert ist optional, der Tag kann leer gelassen werden. In dem Falle nutzt succest eine anonyme Anmeldung am LDAP Server um Zugangsdaten gegen das LDAP zu prüfen. |
|
Passwort zur Anmeldung am LDAP Server. Der Wert ist optional, der Tag kann leer gelassen werden. In dem Falle nutzt succest eine anonyme Anmeldung am LDAP Server um Zugangsdaten gegen das LDAP zu prüfen. |
|
Definiert den Suchfilter zum Finden eines Nutzers. Eine gute Erklärung für Suchfilter inklusive passender Beispiele für AD und andere LDAP Implementierung finden Sie hier. |
|
Klammer-Tag um eine Liste von abzufragenden Attributen. |
|
Legt fest, welches Attribute im LDAP den User Principal Name eines Objektes enthält. Da dieses Attribute hauptsächlich dazu verwendet wird, um das Objekt innerhalb des einen LDAP eindeutig zu identifizieren, kann hier im Falle, das kein echter UPN im LDAP gespeichert ist, auch z. B. das EMail - Attribut verwendet werden, solange diese immer gepflegt und eindeutig ist. |
|
Legt fest in welchem Attribute succest den tatsächlichen Namen des Nutzerobjektes erwartet. |
|
In der Regel realisiert LDAP die Zugehörigkeit einzelner Benutzerobjekte zu Gruppen durch ein Attribut, das mehrfach genannt die Gruppen als Werte liefert, denen der Benutzer angehört. Der Name dieses Attributes ist hier anzugeben. |
|
succest benötigt zwingend eine GUID für jedes LDAP-Benutzer-Objekt. Microsoft Active Directory enthält von Haus aus ein Attribut für jedes Objekt, in dem eine GUID steht (objectGUID). Andere LDAP Implementierungen bringen ein solches Attribut nicht von Haus aus mit. In diesem Falle kann succest einen anderen eindeutigen Wert (z. B. den des Attributes, das bereits als UPN verwendet wird) heranziehen und daraus selbst eine GUID ermitteln. |