Web Services Developer's Guide → Web Services API Reference → SBM Administrative Web Services → Administrative Calls → IsUserValid
This service determines whether a specified user is valid.
Argument | Type | Description |
---|---|---|
auth (optional) | Auth | The Auth type supplies credentials and optionally, a host name for licensing. The userId and password can be specified with HTTP BASIC or WS-SECURITY instead. |
user (optional) | UserIdentifier | The user to be checked. |
A boolean is returned, showing whether the user is valid (true) or not (false). The user account is checked in the context of either the calling user or the specified user. For example:
<ae:IsUserValidResponse> <ae:return>true</ae:return> </ae:IsUserValidResponse>
IsUserValid will return true if the specified user was found in the database and is not deleted or disabled. Otherwise false is returned.
The following XML is a snippet of the payload this is sent with IsUserValid.
<urn:IsUserValid> <urn:auth> <urn:userId>admin</urn:userId> <urn:password></urn:password> <urn:hostname></urn:hostname> </urn:auth> <urn:user> <urn:displayName>carmen</urn:displayName> <urn:id></urn:id> <urn:uuid></urn:uuid> <urn:loginId></urn:loginId> </urn:user> </urn:IsUserValid>
Copyright © 2007–2015 Serena Software, Inc. All rights reserved.