Authenticated​Connection Class

Definition

Represents an authenticated interface to the HealthVault service. Most operations performed against the service require authentication.

public class AuthenticatedConnection : Microsoft.Health.ApplicationConnection
Inheritance
Derived

Inherited Members

Microsoft.Health.ApplicationConnection

Microsoft.Health.HealthServiceConnection

Remarks

You must connect to the HealthVault service to access its web methods. This class does not maintain an open connection to the service, but uses XML over HTTP to make requests and receive responses from the service. The connection only maintains the data necessary for the request.

An authenticated connection takes the user name and password, authenticates them against the HealthVault service, and then stores an authentication token which is then passed to the service on each subsequent request. An authenticated connection is required for accessing a person's health record.

For operations that do not require user or application authentication, use the AnonymousConnection class.

Constructors

Authenticated​Connection(​Credential)

Creates an instance of the AuthenticatedConnection class with the specified credential.

Authenticated​Connection(​Health​Service​Instance, ​Credential)

Creates an instance of the AuthenticatedConnection class with the specified HealthVault web-service instance and credential.

Authenticated​Connection(​Guid, ​Credential)

Creates an instance of the AuthenticatedConnection class with the specified application identifier, and credential.

Authenticated​Connection(​Guid, ​Health​Service​Instance, ​Credential)

Creates an instance of the AuthenticatedConnection class with the specified application identifier, HealthVault web-service instance, and credential.

Authenticated​Connection(​Guid, ​String, ​Credential)

Creates an instance of the AuthenticatedConnection class with the specified application identifier, a string representing the URL, and credential.

Authenticated​Connection(​Guid, ​Uri, ​Credential)

Creates an instance of the AuthenticatedConnection class with the specified application identifier, URL, and credential.

Properties

Is​Impersonating

Gets the value which states whether or not the current connection is impersonating a different user than who is authenticated.

Methods

Authenticate()

Logs on to the HealthVault service using the username and password.

Get​All​Application​Settings()

Gets the application settings for the current application and person.

Get​Application​Settings()

Gets the application settings for the current application and person.

Impersonate(​Guid)

Sets the identifier for the person being impersonated.

Log​On(​String)

Uses the specified Live ID ticket to authenticate the user with HealthVault.

Log​On(​String, ​Boolean)

Uses the specified Live ID ticket to authenticate the user with HealthVault.

Log​On(​String, ​Boolean, ​Manual​Reset​Event)

Uses the specified Live ID ticket to authenticate the user with HealthVault.

Log​On(​String, ​Boolean, ​Manual​Reset​Event, ​Guid, ​Uri, ​Uri)

Uses the specified Live ID ticket to authenticate the user with HealthVault.

Log​On(​String, ​Boolean, ​Boolean, ​Manual​Reset​Event, ​Guid, ​Uri, ​Uri)

Uses the specified Live ID ticket to authenticate the user with HealthVault.

Set​Application​Settings(​IX​Path​Navigable)

Sets the application settings for the current application and person.

Stop​Impersonating()

Unsets the target person identifier for all requests.