ServiceProxy.AuthenticateCrossRealmCore Method

Article
06/20/2014

Applies To: Microsoft Dynamics CRM 2013, Microsoft Dynamics CRM Online

Authenticates a user in a realm other than the realm that the Microsoft Dynamics CRM server is located in.

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

Syntax

'Declaration
Protected Overridable Function AuthenticateCrossRealmCore As SecurityTokenResponse

protected virtual SecurityTokenResponse AuthenticateCrossRealmCore ()

Return Value

Type: SecurityTokenResponse
A security token response.

Remarks

This method will attempt to authenticate the home realm, then use the corresponding security token to authenticate to the Microsoft Dynamics CRM realm STS (Security Token Service). In addition to the normal client credential requirements, the homeRealmUri constructor parameter is expected to be set in the call to the constructor.

The returned SecurityTokenResponse should be the security token that can be used to authenticate against the Microsoft Dynamics CRM server realm STS.

This method may be overridden in the case that home realm authentication requires multiple hops, which is not supported by this call.

ServiceConfigurationand HomeRealmUri must be set prior to calling this method.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Server 2008, Windows Server 2012, Windows 7 (All Versions), Windows 8 (All Versions)

Target Platforms

Windows Server 2008, ,Windows Server 2012, ,Windows 7 (All Versions),

Share via