HttpRequestMessageAuthenticationExtensions.WithAuthenticationOptions 메서드

public static System.Net.Http.HttpRequestMessage WithAuthenticationOptions(this System.Net.Http.HttpRequestMessage request, Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions options);

static member WithAuthenticationOptions : System.Net.Http.HttpRequestMessage * Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions -> System.Net.Http.HttpRequestMessage

<Extension()>
Public Function WithAuthenticationOptions (request As HttpRequestMessage, options As MicrosoftIdentityMessageHandlerOptions) As HttpRequestMessage

매개 변수

반품

메서드 체인에 대해 동일한 요청 메시지입니다.

예외

예제

var options = new MicrosoftIdentityMessageHandlerOptions
{
    Scopes = { "https://graph.microsoft.com/.default" }
};
options.WithAgentIdentity("my-agent-guid");

var request = new HttpRequestMessage(HttpMethod.Get, "/me")
    .WithAuthenticationOptions(options);

설명

이 메서드는 요청에 설정된 기존 인증 옵션을 재정의합니다. 옵션 개체는 다른 Microsoft ID 웹 패키지의 확장 메서드를 사용하여 추가로 구성할 수 있습니다.

public static System.Net.Http.HttpRequestMessage WithAuthenticationOptions(this System.Net.Http.HttpRequestMessage request, Action<Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions> configure);

static member WithAuthenticationOptions : System.Net.Http.HttpRequestMessage * Action<Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions> -> System.Net.Http.HttpRequestMessage

<Extension()>
Public Function WithAuthenticationOptions (request As HttpRequestMessage, configure As Action(Of MicrosoftIdentityMessageHandlerOptions)) As HttpRequestMessage

매개 변수

반품

메서드 체인에 대해 동일한 요청 메시지입니다.

예외

예제

var request = new HttpRequestMessage(HttpMethod.Get, "/api/users")
    .WithAuthenticationOptions(options =>
    {
        options.Scopes.Add("https://myapi.domain.com/user.read");
        options.WithAgentIdentity("agent-application-id");
        options.RequestAppToken = true;
    });

설명

요청에 이미 인증 옵션이 구성된 경우 대리자는 수정할 기존 옵션 개체를 받게 됩니다. 그렇지 않으면 새 MicrosoftIdentityMessageHandlerOptions 인스턴스가 만들어지고 대리자에게 전달됩니다.

이 메서드는 에이전트 ID 메서드와 같은 다른 Microsoft ID 웹 패키지의 확장 메서드를 적용해야 하는 경우에 특히 유용합니다.