Share via


IServiceConfiguration<TService> Interface

 

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

Represents a configured Microsoft Dynamics 365 service.

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

Syntax

public interface IServiceConfiguration<TService>
Public Interface IServiceConfiguration(Of TService)

Type Parameters

  • TService
    Type: Type. The type of service.

Properties

Name Description
System_CAPS_pubproperty AuthenticationType

Gets the type of authentication in use by the identity provider of the service.

System_CAPS_pubproperty CrossRealmIssuerEndpoints

Gets the available endpoints of the user’s home realm identity provider.

System_CAPS_pubproperty CurrentIssuer

Gets or sets the endpoint used by the Secure Token Service (STS) to issue the trusted token.

System_CAPS_pubproperty CurrentServiceEndpoint

Gets or sets the current endpoint in use by a service.

System_CAPS_pubproperty IssuerEndpoints

Gets the available endpoints of the security token service (STS).

System_CAPS_pubproperty PolicyConfiguration

Gets the policy configuration that identifies a Secure Token Service (STS).

System_CAPS_pubproperty ServiceEndpoints

Gets the available endpoints of the service.

Methods

Name Description
System_CAPS_pubmethod Authenticate(ClientCredentials)

Authenticates against the trusted Microsoft Dynamics 365 Secure Token Service using client credentials.

System_CAPS_pubmethod Authenticate(ClientCredentials, SecurityTokenResponse)

Authenticates against Microsoft account using client credentials and a security token response.

System_CAPS_pubmethod Authenticate(SecurityToken)

Authenticates against the trusted Microsoft Dynamics 365 Secure Token Service using a security token.

System_CAPS_pubmethod AuthenticateCrossRealm(ClientCredentials, String, Uri)

Authenticates against a remote Secure Token Service (STS) using client credentials.

System_CAPS_pubmethod AuthenticateCrossRealm(SecurityToken, String, Uri)

Authenticates against a remote Secure Token Service (STS) using a security token retrieved from an identity provider (when in federation mode).

System_CAPS_pubmethod AuthenticateDevice(ClientCredentials)

Authenticates a registered device against Microsoft account.

System_CAPS_pubmethod CreateChannelFactory()

Creates a client factory that uses the default Kerberos credentials.

System_CAPS_pubmethod CreateChannelFactory(ClientAuthenticationType)

Creates a WCF channel factory with a specified type of authentication.

System_CAPS_pubmethod CreateChannelFactory(ClientCredentials)

Creates a WCF channel factory that supports passing the client credentials, regardless of whether in federation authentication mode or not.

System_CAPS_pubmethod CreateChannelFactory(TokenServiceCredentialType)

For internal use only.

System_CAPS_pubmethod 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 interface exposes support for the AuthenticationCredentials class and a single Authenticate call that covers most scenarios.

For best performance, create an instance of the IServiceConfiguration<TService> interface only one time per client session and re-use that instance as necessary.

See Also

Microsoft.Xrm.Sdk.Client Namespace

Return to top

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright