Share via

AbstractApplicationBuilder<T>.WithInstanceDicoveryMetadata Method

  • Reference

Definition

Namespace:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Package:
Microsoft.Identity.Client v4.66.1

Overloads

WithInstanceDicoveryMetadata(String)
Obsolete.

Allows developers to configure their own valid authorities. A json string similar to https://aka.ms/aad-instance-discovery should be provided. MSAL uses this information to:

  • Call REST APIs on the environment specified in the preferred_network
  • Identify an environment under which to save tokens and accounts in the cache
  • Use the environment aliases to match tokens issued to other authorities
For more details see https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDicoveryMetadata(Uri)
Obsolete.

Lets an organization setup their own service to handle instance discovery, which enables better caching for microservice/service environments. A Uri that returns a response similar to https://aka.ms/aad-instance-discovery should be provided. MSAL uses this information to:

  • Call REST APIs on the environment specified in the preferred_network
  • Identify an environment under which to save tokens and accounts in the cache
  • Use the environment aliases to match tokens issued to other authorities
For more details see https://aka.ms/msal-net-custom-instance-metadata

WithInstanceDicoveryMetadata(String)

Caution

This method name has a typo, please use WithInstanceDiscoveryMetadata instead

Allows developers to configure their own valid authorities. A json string similar to https://aka.ms/aad-instance-discovery should be provided. MSAL uses this information to:

  • Call REST APIs on the environment specified in the preferred_network
  • Identify an environment under which to save tokens and accounts in the cache
  • Use the environment aliases to match tokens issued to other authorities
For more details see https://aka.ms/msal-net-custom-instance-metadata 
[System.Obsolete("This method name has a typo, please use WithInstanceDiscoveryMetadata instead", false)]
public T WithInstanceDicoveryMetadata (string instanceDiscoveryJson);
[<System.Obsolete("This method name has a typo, please use WithInstanceDiscoveryMetadata instead", false)>]
member this.WithInstanceDicoveryMetadata : string -> 'T
Public Function WithInstanceDicoveryMetadata (instanceDiscoveryJson As String) As T

Parameters

instanceDiscoveryJson
String

Returns

T
Attributes
ObsoleteAttribute

Remarks

Developers take responsibility for authority validation if they use this method. Should not be used when the authority is not know in advance. Has no effect on ADFS or B2C authorities, only for AAD authorities

Applies to

WithInstanceDicoveryMetadata(Uri)

Caution

This method name has a typo, please use WithInstanceDiscoveryMetadata instead

Lets an organization setup their own service to handle instance discovery, which enables better caching for microservice/service environments. A Uri that returns a response similar to https://aka.ms/aad-instance-discovery should be provided. MSAL uses this information to:

  • Call REST APIs on the environment specified in the preferred_network
  • Identify an environment under which to save tokens and accounts in the cache
  • Use the environment aliases to match tokens issued to other authorities
For more details see https://aka.ms/msal-net-custom-instance-metadata 
[System.Obsolete("This method name has a typo, please use WithInstanceDiscoveryMetadata instead", false)]
public T WithInstanceDicoveryMetadata (Uri instanceDiscoveryUri);
[<System.Obsolete("This method name has a typo, please use WithInstanceDiscoveryMetadata instead", false)>]
member this.WithInstanceDicoveryMetadata : Uri -> 'T
Public Function WithInstanceDicoveryMetadata (instanceDiscoveryUri As Uri) As T

Parameters

instanceDiscoveryUri
Uri

Returns

T
Attributes
ObsoleteAttribute

Remarks

Developers take responsibility for authority validation if they use this method. Should not be used when the authority is not know in advance. Has no effect on ADFS or B2C authorities, only for AAD authorities

Applies to