Previous Topic: WSAuthenticateNext Topic: Login2


Login

The Login method authenticates and obtains authorization from the DSM manager.

Parameters

xsd:string userName

The name of a valid user account that has permission to authenticate with the DSM manager. If unified login is disabled, this is a mandatory parameter.

xsd:string password

The password that corresponds to the given user name. If unified login is disabled, this is a mandatory parameter.

xsd:string manager (M)

The host name of the DSM manager to which the method should attempt to connect.

Return Values

xsd:string LoginReturn

A unique session ID to use as an input parameter for all further calls to the web service.

Remarks

This method obtains a connection to the manager and creates a web service session, returning the session ID for further web service calls.

TWindows and Linux credentials:

Windows Domain

url: http://<hostname>/UDSM_R11_WebService/mod_gsoap.dll

user : winnt://<domain name>/<username>

password : <password>

manager :<dsmmanagername>

Linux

url : http://<hostname>/UDSM_R11_WebService

user : unixl://<complete domain name>/<username>

password : <password>

manager :<dsmmanagername>

hostname

Specifies the name of the the computer on which Web Services is installed.

domain name

Specifies the NT domain name (either local machine name or domain name)

Complete domain name

Specifies the fully qualified machine name of the Linux machine

It is recommended that you use SSL to connect to Web Services.

When connecting to Active Directory:

url: http:// <hostname>/UDSM_R11_WebService (on Linux)

url: http://<hostname>/UDSM_R11_WebService/mod_gsoap.dll (on Windows)

user : ldap://<directory name>/<username>

<username> can be of UPN or DN format

In UPN format : <username>: user@directory name

IN DN Format : <username>: cn= user,ou=users,ou=XXXX,dc=YYY dc=com

When connecting to an LDAP enabled directory (not Active Directory):

url: http:// <hostname>/UDSM_R11_WebService (on Linux)

url: http://<hostname>/UDSM_R11_WebService/mod_gsoap.dll (on Windows)

user : ldap://<directory name>/<user dn>

<user dn> is the distinguished name format, for example

cn= user,ou=users,ou= XXXX,dc=YYY dc=com

When connecting to NDS (Windows only):

url: http://<hostname>/UDSM_R11_WebService/mod_gsoap.dll

user: nds://<tree name>/<user dn>

<user dn> is the distinguished name format; for example,

cn=user.ou=XXXX.o=aar