Click or drag to resize
RallyRestApiAuthenticateWithZSessionID Method
Authenticates against Rally with the specified credentials

Namespace: Rally.RestApi
Assembly: Rally.RestApi (in Rally.RestApi.dll) Version: 3.1.1.0 (3.1.1.0)
Syntax
public RallyRestApiAuthenticationResult AuthenticateWithZSessionID(
	string userName,
	string zSessionID,
	string rallyServer = "https://rally1.rallydev.com",
	WebProxy proxy = null,
	bool allowSSO = true
)

Parameters

userName
Type: SystemString
The user name to be used for access
zSessionID
Type: SystemString
The ZSessionID to be used for access. This would have been provided by Rally on a previous call.
rallyServer (Optional)
Type: SystemString
The Rally server to use (defaults to DEFAULT_SERVER)
proxy (Optional)
Type: System.NetWebProxy
Optional proxy configuration
allowSSO (Optional)
Type: SystemBoolean
Is SSO authentication allowed for this call? It can be useful to disable this during startup processes.

Return Value

Type: RallyRestApiAuthenticationResult
An RallyRestApiAuthenticationResult that indicates the current state of the authentication process.
Exceptions
ExceptionCondition
RallyUnavailableExceptionRally returned an HTML page. This usually occurs when Rally is off-line. Please check the ErrorMessage property for more information.
RallyFailedToDeserializeJsonThe JSON returned by Rally was not able to be deserialized. Please check the JsonData property for what was returned by Rally.
Examples
C#
RallyRestApi restApi = new RallyRestApi();
WebProxy myProxy = new WebProxy();
restApi.AuthenticateWithZSessionID("myuser@company.com", "zSessionID", proxy: myProxy);
See Also