Konfigurationsdatei AuthenticationServiceConfiguration: Unterschied zwischen den Versionen

Aus succestWiki
Wechseln zu: Navigation, Suche
 
(7 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
 
* Kurzform: AuthenticationServiceConfiguration
 
* Kurzform: AuthenticationServiceConfiguration
 
* Vollständig: TestcaseRepositoryAPI.UserAndSessionManagement.AuthenticationServiceConfiguration.config
 
* Vollständig: TestcaseRepositoryAPI.UserAndSessionManagement.AuthenticationServiceConfiguration.config
 +
 +
Im Folgenden ist die Konfigurationsdatei, ihr Aufbau und die Bedeutung der einzelnen Tags grundsätzlich beschrieben. Eine Erklärung der Möglichkeiten, die succest im Zusammenspiel mit LDAP Servers anbietet, zeigt dieser [https://www.youtube.com/watch?v=HflhNqLsWRg Screencast].
  
 
== Beispiel ==
 
== Beispiel ==
Zeile 13: Zeile 15:
 
         <ldapString>LDAPS://192.168.220.101:636/DC=dom2012r2,DC=local</ldapString>
 
         <ldapString>LDAPS://192.168.220.101:636/DC=dom2012r2,DC=local</ldapString>
 
         <ldapUserName>administrator@dom2012r2.local</ldapUserName>
 
         <ldapUserName>administrator@dom2012r2.local</ldapUserName>
−
         <ldapPassword>12hallosos$</ldapPassword>
+
         <ldapPassword>XYZ</ldapPassword>
 
         <ldapFilter>(&amp;(objectClass=user)(|(sAMAccountName={0})(userPrincipalName={0})))</ldapFilter>
 
         <ldapFilter>(&amp;(objectClass=user)(|(sAMAccountName={0})(userPrincipalName={0})))</ldapFilter>
 
         <attributes>
 
         <attributes>
Zeile 25: Zeile 27:
 
         <ldapString>LDAP://192.168.220.102:389/CN=Users,DC=dom2016,DC=local</ldapString>
 
         <ldapString>LDAP://192.168.220.102:389/CN=Users,DC=dom2016,DC=local</ldapString>
 
         <ldapUserName>administrator@dom2016.local</ldapUserName>
 
         <ldapUserName>administrator@dom2016.local</ldapUserName>
−
         <ldapPassword>12hallosos$</ldapPassword>
+
         <ldapPassword>XYZ</ldapPassword>
 
         <ldapFilter>(&amp;(objectClass=user)(|(sAMAccountName={0})(userPrincipalName={0})))</ldapFilter>
 
         <ldapFilter>(&amp;(objectClass=user)(|(sAMAccountName={0})(userPrincipalName={0})))</ldapFilter>
 
         <attributes>
 
         <attributes>
Zeile 59: Zeile 61:
 
| Definiert die zu verwendende Implementierung für die Authentifizierung.
 
| Definiert die zu verwendende Implementierung für die Authentifizierung.
 
Dabei sind folgende Varianten unterstützt:  
 
Dabei sind folgende Varianten unterstützt:  
−
* AuthenticationServiceLDAP: Nutzung eines LDAP z.B. aus einem Active Directory Service
+
* <code>AuthenticationServiceLDAP</code>: Nutzung eines LDAP z. B. aus einem Active Directory Service
−
* AuthenticationServiceLocal: Nutzung einer MS SQL Datenbank.
+
* <code>AuthenticationServiceLocal</code>: Nutzung einer MS SQL Datenbank.
−
 
 
 
|-
 
|-
 
|
 
|
 
ConfigNode/config
 
ConfigNode/config
−
| Wir nur benötigt wenn AuthServiceClass auf TestcaseRepositoryAPI.AuthenticationServiceLDAP gesetzt ist.
+
| Wir nur benötigt wenn "AuthServiceClass" auf <code>AuthenticationServiceLDAP</code> gesetzt ist.
 
|-
 
|-
 
|
 
|
Zeile 75: Zeile 76:
 
| Zeichenkette die für die Verbindung zum LDAP genutzt wird.
 
| Zeichenkette die für die Verbindung zum LDAP genutzt wird.
 
'''WICHTIG''' Das Schema 'LDAP' oder 'LDAPS' innerhalb des [https://de.wikipedia.org/wiki/Uniform_Resource_Identifier URI] muss groß geschrieben werden.
 
'''WICHTIG''' Das Schema 'LDAP' oder 'LDAPS' innerhalb des [https://de.wikipedia.org/wiki/Uniform_Resource_Identifier URI] muss groß geschrieben werden.
 +
|-
 +
|
 +
::ldapUserName
 +
| Nutzername 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.
 +
|-
 +
|
 +
::ldapPassword
 +
| 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.
 
|-
 
|-
 
|
 
|
 
::ldapFilter
 
::ldapFilter
−
| Definiert den Suchfilter zum Finden eines Nutzers.
+
| 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 [http://ldapwiki.com/wiki/LDAP%20Query%20Examples hier].
 +
|-
 +
|
 +
::attributes
 +
| Klammer-Tag um eine Liste von abzufragenden Attributen.
 +
|-
 +
|
 +
:::attributeUPN
 +
| Legt fest, welches Attribute im LDAP den [https://de.wikipedia.org/wiki/User_Principal_Name 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 E-Mail-Attribut verwendet werden, solange diese immer gepflegt und eindeutig ist.
 
|-
 
|-
 
|
 
|
 
:::attributeName
 
:::attributeName
−
| Definiert den Attributnamen der Rückgabe, in dem der Realname des Nutzers steht.
+
| Legt fest in welchem Attribute succest den tatsächlichen Namen des Nutzerobjektes erwartet.
 
|-
 
|-
 
|
 
|
 
:::attributeGroups
 
:::attributeGroups
−
| Definiert den Attributnamen der Rückgabe, in dem die Namen der dem Nutzer zugehörigen Gruppen stehen.
+
| 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
−
| Definiert den Attributnamen der Rückgabe, in dem die [[ID]] des Nutzers steht.
+
| 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]]

Aktuelle Version vom 20. März 2018, 15:49 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

Im Folgenden ist die Konfigurationsdatei, ihr Aufbau und die Bedeutung der einzelnen Tags grundsätzlich beschrieben. Eine Erklärung der Möglichkeiten, die succest im Zusammenspiel mit LDAP Servers anbietet, zeigt dieser Screencast.

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>(&amp;(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>(&amp;(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>(&amp;(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:

  • AuthenticationServiceLDAP: Nutzung eines LDAP z. B. aus einem Active Directory Service
  • AuthenticationServiceLocal: Nutzung einer MS SQL Datenbank.

ConfigNode/config

Wir nur benötigt wenn "AuthServiceClass" auf AuthenticationServiceLDAP gesetzt ist.
ldapServer
Sich wiederholender Klammer-Tag. Je abzufragendem LDAP Server wird ein ldapServer-Tag geöffnet und geschlossen.
ldapString
Zeichenkette die für die Verbindung zum LDAP genutzt wird.

WICHTIG Das Schema 'LDAP' oder 'LDAPS' innerhalb des URI muss groß geschrieben werden.

ldapUserName
Nutzername 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.
ldapPassword
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.
ldapFilter
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.
attributes
Klammer-Tag um eine Liste von abzufragenden Attributen.
attributeUPN
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 E-Mail-Attribut verwendet werden, solange diese immer gepflegt und eindeutig ist.
attributeName
Legt fest in welchem Attribute succest den tatsächlichen Namen des Nutzerobjektes erwartet.
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
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.