Auth

Description

The Auth type supplies credentials and optionally, a host name for licensing. The Auth type parameters are listed below.

Parameters

Name	Type	Description
userID	string	The SBM user Login ID. If you are only specifying the host name, then userID is optional.
password	string	The password for the user. If you are only specifying the host name, then password is optional.
hostname	string	The host name of the client.
loginAsUserId	string	User ID for the SBM login you wish to impersonate. If you are only specifying the host name, then loginAsUserId is optional.
extendedData	ExtendedData	Placeholder for future arguments.

Usage

The Auth type allows credentials to be provided if not using WS-SECURITY or HTTP BASIC to pass the credentials. The hostname element is only needed in case you want to override the client's IP address for licensing purposes, forcing Serena License Manager to use a particular client host. If it is not provided, the code gets the client hostname from the socket.

Note: The loginAsUserId parameter requires that the calling user is either a Global Managed Administrator or a Managed Administrator with Admin privileges to one of the groups which the user to be impersonated belongs.

XML

The following XML shows Auth as seen in a typical call.

<urn:auth>
    <urn:userId>admin</urn:userId>
    <urn:password>password</urn:password>
    <urn:hostname>localhost</urn:hostname>
    <urn:loginAsUserId></urn:loginAsUserId>
    <urn:extendedData></urn:extendedData>
</urn:auth>