Authentication

To communicate with the AgilePoint API, you must establish a session, which associates an authenticated user with a set of calls. The client must provide credentials to the AgilePoint Server using Windows authentication.

There are two main ways to provide credentials to the AgilePoint Server: Specify the user's credentials, or use the default credentials.

Specify the Credentials for a User

Specify the user name, password, and domain name for a user. The domain name could be a Windows Domain Name or a Local Host Name. The following example shows the syntax for establishing credentials in this way:

System.Net.ICredentials = new 
    System.Net.NetworkCredential(userName, password, domainName);

Use the Default Credentials

Use the default credentials for a user. The default is the system credentials for the current security context in which the application is running. For a client-side application, these are usually the Windows credentials (user name, password, and domain) of the user running the application. For ASP.NET applications, the default credentials are the user credentials of the authenticated user, or the user being impersonated.

For more information, see Surrogate.

System.Net.ICredentials = 
    System.Net.CredentialCache.DefaultCredentials;