Ruft den Benutzer für den angegebenen Namen username ab.
Gilt für Clouds (Integration Appliances) sowie für Integrationseinheiten.
Parameter:
- username
- Der angegebene Benutzer namens username.
- Rückgabe:
- Der Benutzer, der dem angegebenen Namen username entspricht.
Beispiele:
Beim folgenden Beispiel handelt es sich um eine SOAP-Anforderung zum Abrufen eines Benutzers anhand des angegebenen Benutzernamens
username.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
<soapenv:Header>
<sec:sessionId>BF1E7729085BB066446DF913FAE34596</sec:sessionId>
</soapenv:Header>
<soapenv:Body>
<sec:getUser>
<sec:username>webman</sec:username>
</sec:getUser>
</soapenv:Body>
</soapenv:Envelope>
Beim folgenden Beispiel handelt es sich um die SOAP-Antwort auf die Anforderung.
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:getUserResponse xmlns:ns2="http://www.approuter.com/schemas/2008/1/
security" xmlns:ns3="http://www.approuter.com/schema/router/1000/security/03">
<ns2:user>
<ns3:id>965AAB3FED8D3CCBBE4DC8EE0E2944EA</ns3:id>
<ns3:name>webman</ns3:name>
<ns3:encPasswd>{SHA}clO20r2ZJMJcDrNwXQzhWB8YcdI=</ns3:encPasswd>
<ns3:displayName>WebServiceUser</ns3:displayName>
<ns3:isActive>true</ns3:isActive>
<ns3:isMutable>true</ns3:isMutable>
<ns3:isVisible>true</ns3:isVisible>
<ns3:email>webman@mycompany.com</ns3:email>
<ns3:createdTime>2010-03-02T22:11:32.935Z</ns3:createdTime>
<ns3:failedLoginCount>0</ns3:failedLoginCount>
<ns3:scopeId>B47EAECF6AD14AA028B4EA038CB742D0</ns3:scopeId>
<ns3:scopeType>Tenant</ns3:scopeType>
</ns2:user>
</ns2:getUserResponse>
</S:Body>
</S:Envelope>
Für jeden Benutzer werden die folgenden Informationen zurückgegeben:
- id
- Die ID des Benutzers.
- name
- Der Name des Benutzers.
- encPasswd
- Das mit SHA (Secure Hash Algorithm) codierte Kennwort für den Benutzer.
- displayName
- Der Name, der für die Rolle in der WMC (Web Management Console, Webmanagementkonsole) angezeigt wird.
- isActive
- Entweder 'true' oder 'false'. Der Wert 'true' bedeutet, dass der Benutzer angemeldet ist. Der Wert 'false' gibt an, dass der Benutzer nicht angemeldet ist.
- isMutable
- Entweder 'true' oder 'false'. Der Wert 'true' bedeutet, dass das Objekt aktualisiert werden kann. Der Wert 'false' gibt an, dass keine Aktualisierung des Objekts möglich ist.
- isVisible
- Entweder 'true' oder 'false'. Der Wert 'true' bedeutet, dass das Objekt in der WMC (Web Management Console, Webmanagementkonsole) sichtbar ist. Der Wert 'false' gibt an, dass das Objekt in der WMC (Web Management Console, Webmanagementkonsole) nicht sichtbar ist.
- email
- Die E-Mail-Adresse des Benutzers.
- createdTime
- Datum und Uhrzeit der Erstellung des Benutzers.
- failedLoginCount
- Die Anzahl von fehlgeschlagenen Versuchen der Anmeldung unter Verwendung dieses Namens. Nach fünf fehlgeschlagenen Versuchen wird der Name des Benutzers username 15 Sekunden lang gesperrt. Bei jedem weiteren fehlgeschlagenen Versuch wird die Dauer der Sperrung verdoppelt (15 Sekunden - 30 Sekunden - 60 Sekunden - 120 Sekunden).
- scopeId
- Die Geltungsbereichs-ID für den Geltungsbereich (Wirkungsbereich), in dem sich der Benutzer befindet. Dies gilt nicht für Integrationseinheiten (Integration Appliances).
- scopeType
- Der Typ von Geltungsbereich - entweder 'Tenant' (Nutzer) oder 'Environment' (Umgebung). Dies gilt nicht für Integrationseinheiten (Integration Appliances).