getUsers
Ruft eine Liste aller Benutzer basierend auf der Sitzungs-ID ab.
Gilt für Clouds (Integration Appliances) sowie für Integrationseinheiten.
- Rückgabe:
- Die Benutzer.
Beispiele:
Beim folgenden Beispiel handelt es sich um eine SOAP-Anforderung zum Abrufen von Benutzern. Als Eingabe für die Anforderung wird die Sitzungs-ID verwendet.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
<soapenv:Header>
<sec:sessionId>8EB8F17160F7D1E561EC45EFEBF344CF</sec:sessionId>
</soapenv:Header>
<soapenv:Body>
<sec:getUsers/>
</soapenv:Body>
</soapenv:Envelope>
Beim folgenden Beispiel handelt es sich um die SOAP-Antwort auf die Anforderung zum Abrufen der Benutzer:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:getUsersResponse xmlns:ns2="http://www.approuter.com/
schemas/2008/1/security" xmlns:ns3="http://www.approuter.com/schema/
router/1000/security/03">
<ns2:users>
<ns3:id>860DDF6E8DE511EF0EA8E249A1514EA1</ns3:id>
<ns3:name>foo@mycompany.com</ns3:name>
<ns3:encPasswd>{SHA}L84w50sj87W4IQUhr2NqKsuO8kI=</ns3:encPasswd>
<ns3:displayName>Foo</ns3:displayName>
<ns3:isActive>true</ns3:isActive>
<ns3:isMutable>true</ns3:isMutable>
<ns3:isVisible>true</ns3:isVisible>
<ns3:email>foo@mycompany.com</ns3:email>
<ns3:createdTime>2010-02-24T23:12:10.252Z</ns3:createdTime>
<ns3:failedLoginCount>0</ns3:failedLoginCount>
<ns3:scopeId>B47EAECF6AD14AA028B4EA038CB742D0</ns3:scopeId>
<ns3:scopeType>Tenant</ns3:scopeType>
</ns2:users>
<ns2:users>
<ns3:id>90D63CC6F3A5F90C587B2B478858432D</ns3:id>
<ns3:name>admin@mycompany.com</ns3:name>
<ns3:encPasswd>{SHA}8eQYsQgWL3V0sLf7akuJO5wM11c=</ns3:encPasswd>
<ns3:displayName>admin@mycompany.com</ns3:displayName>
<ns3:isActive>true</ns3:isActive>
<ns3:isMutable>false</ns3:isMutable>
<ns3:isVisible>true</ns3:isVisible>
<ns3:email>admin@mycompany.com</ns3:email>
<ns3:createdTime>2010-02-12T21:50:35Z</ns3:createdTime>
<ns3:lastLoginTime>2010-03-10T17:20:39.774Z</ns3:lastLoginTime>
<ns3:lastFailedLoginTime>2010-03-03T18:25:24.936Z</
ns3:lastFailedLoginTime>
<ns3:failedLoginCount>0</ns3:failedLoginCount>
<ns3:scopeId>B47EAECF6AD14AA028B4EA038CB742D0</ns3:scopeId>
<ns3:scopeType>Tenant</ns3:scopeType>
</ns2:users>
<ns2:users>
<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:users>
<ns2:users>
<ns3:id>B77F69E6D9488E2607B02076B4F848DC</ns3:id>
<ns3:name>support@mycompany.com</ns3:name>
<ns3:encPasswd>{SHA}Ek2MpQlE1+fGMEYo1kSF6lpbNIk=</ns3:encPasswd>
<ns3:displayName>support@mycompany.com</ns3:displayName>
<ns3:isActive>false</ns3:isActive>
<ns3:isMutable>false</ns3:isMutable>
<ns3:isVisible>true</ns3:isVisible>
<ns3:email>support@mycompany.com</ns3:email>
<ns3:createdTime>2010-02-12T21:50:35Z</ns3:createdTime>
<ns3:failedLoginCount>0</ns3:failedLoginCount>
<ns3:scopeId>B47EAECF6AD14AA028B4EA038CB742D0</ns3:scopeId>
<ns3:scopeType>Tenant</ns3:scopeType>
</ns2:users>
</ns2:getUsersResponse>
</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 den Benutzer in der WMC (Web Management Console, Webmanagementkonsole) angezeigt wird.
- isActive
- Entweder 'true' oder 'false', je nachdem, ob der Benutzer angemeldet oder 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.
- Die E-Mail-Adresse des Benutzers.
- createdTime
- Datum und Uhrzeit der Erstellung des Benutzers.
- failedLoginCount
- Die Anzahl von fehlgeschlagenen Versuchen der Anmeldung beim Nutzer 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.
- scopeId
- Die Geltungsbereichs-ID für den Geltungsbereich (Wirkungsbereich), in dem sich der Benutzer befindet. Gilt ausschließlich für Clouds.
- scopeType
- Der Typ von Geltungsbereich - entweder 'Tenant' (Nutzer) oder 'Environment' (Umgebung). Gilt ausschließlich für Clouds.