IServiceManagement<TService> Interface

Article
11/28/2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

An interface which provides a simpler authentication experience.

Namespace: Microsoft.Xrm.Sdk.Client
Assembly: Microsoft.Xrm.Sdk (in Microsoft.Xrm.Sdk.dll)

Syntax

public interface IServiceManagement<TService>

Public Interface IServiceManagement(Of TService)

Type Parameters

TService
Type: IDiscoveryService or IOrganizationService. Specifies a service type.

Properties

	Name	Description
	AuthenticationType	Gets the type of authentication in use by the identity provider of the service.
	CrossRealmIssuerEndpoints	Gets the available endpoints of the user’s home realm identity provider.
	CurrentServiceEndpoint	Gets or sets the current endpoint in use by a service.
	IssuerEndpoints	Gets the available endpoints of the security token service (STS).
	PolicyConfiguration	Gets the policy configuration that identifies a Secure Token Service (STS).

Methods

	Name	Description
	Authenticate(AuthenticationCredentials)	Authenticates the logged on user with the service.
	CreateChannelFactory()	Creates a WCF channel factory that uses the default Kerberos credentials.
	CreateChannelFactory(ClientAuthenticationType)	Creates a WCF channel factory with a specified type of authentication.
	CreateChannelFactory(ClientCredentials)	Creates a WCF channel factory using specified client credentials.
	CreateChannelFactory(TokenServiceCredentialType)	For internal use only.
	GetIdentityProvider(String)	Returns the identity provider used for a specified user when accessing a service.

Remarks

Instances of the IServiceConfiguration<TService> and IServiceManagement<TService> interfaces are basically interchangeable, the only real difference being that the IServiceManagement<TService> interface exposes support for the AuthenticationCredentials class and a single Authenticate call that covers most scenarios.

For best performance, create an instance of this interface only one time per client session and re-use that instance as necessary.

Share via