logon Element
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
Signs in to an Office Communicator Web Access server with specified user credentials.
Syntax
<logon/>
Element Information
Parent Element
Element |
Description |
|---|---|
Contains one or more methods that a Unified Communications AJAX API Client sends to a Communicator Web Access server. |
Child Elements
Element |
Occurrences |
Description |
|---|---|---|
0 or more |
A persons account name, of the "domain\user" or "user@domain" form. |
|
0 or more |
The password of the user account. |
Remarks
The logon request must be made first before any other requests in a session. The logon method is the only request method that cannot have a rid attribute. It can be used to let a user log on to a Communicator Web Access server based on one of the following authentication schemes:
Form-based authentication in which the user must provide his or her credentials explicitly to be authenticated. The URL used for such a request is "https://server.contoso.com/forms/logon.html".
Integrated Windows authentication in which the credentials from the user's Windows account is used to have the user authenticated. The URL for such a request is "https://server.contoso.com/iwa/logon.html".
Single Sign-On (SSO) The URL for such a request is "https://server.contoso.com/sso/logon.html".
When the request is successful, the server creates an authentication ticket and returns it to the client through a special HTTP header (named "CWA-Ticket") in the HTTP response. The caller must cache this ticket and submit it, as the CWA-Ticket header, in all subsequent HTTP requests throughout the session.
The ticket expires after a server-specified time period. The Communicator Web Access server issues a new ticket when that time period expires. The client must watch for the new ticket in the HTTP responses from both the command and data channels. The client cache must be updated after receiving a new authentication ticket. This new ticket is used in all HTTP requests made to the command and data channels until the next update of the ticket. If the authentication ticket is not returned, the logon request has failed.
After a successful logon request, the client must make the initiateSession request immediately. This must happen before calling any other methods.
Examples
In this example, Jim T. is logging on to Unified Communications using Form-based authentication. The format of the user element used is domain\user.
<logon>
<user>contoso\jimT</user>
<password>contosojimt</password>
</logon>