다음을 통해 공유


CookieAuthenticationOptions 클래스

정의

CookieAuthenticationMiddleware에 대한 구성 옵션입니다.

public ref class CookieAuthenticationOptions : Microsoft::AspNetCore::Builder::AuthenticationOptions, Microsoft::Extensions::Options::IOptions<Microsoft::AspNetCore::Builder::CookieAuthenticationOptions ^>
public class CookieAuthenticationOptions : Microsoft.AspNetCore.Builder.AuthenticationOptions, Microsoft.Extensions.Options.IOptions<Microsoft.AspNetCore.Builder.CookieAuthenticationOptions>
type CookieAuthenticationOptions = class
    inherit AuthenticationOptions
    interface IOptions<CookieAuthenticationOptions>
Public Class CookieAuthenticationOptions
Inherits AuthenticationOptions
Implements IOptions(Of CookieAuthenticationOptions)
상속
CookieAuthenticationOptions
구현

생성자

CookieAuthenticationOptions()

기본값으로 초기화된 옵션 인스턴스를 만듭니다.

속성

AccessDeniedPath

AccessDeniedPath 속성은 나가는 403 금지 상태 코드를 지정된 경로로 302 리디렉션으로 변경해야 한다는 것을 미들웨어에 알릴 수 있습니다.

AuthenticationScheme

옵션의 AuthenticationScheme은 특정 인증 체계의 논리적 이름에 해당합니다. 파이프라인에서 동일한 인증 미들웨어 유형을 두 번 이상 사용하기 위해 다른 값이 할당될 수 있습니다.

(다음에서 상속됨 AuthenticationOptions)
AutomaticAuthenticate

true이면 인증 미들웨어가 들어오는 요청 사용자를 변경합니다. false이면 인증 미들웨어는 AuthenticationScheme에 의해 명시적으로 표시된 경우에만 ID를 제공합니다.

(다음에서 상속됨 AuthenticationOptions)
AutomaticChallenge

true이면 인증 미들웨어가 자동 챌린지를 처리해야 합니다. false이면 인증 미들웨어는 AuthenticationScheme에 의해 명시적으로 표시된 경우에만 응답을 변경합니다.

(다음에서 상속됨 AuthenticationOptions)
ClaimsIssuer

생성된 모든 클레임에 사용해야 하는 발급자를 가져오거나 설정합니다.

(다음에서 상속됨 AuthenticationOptions)
CookieDomain

쿠키를 만드는 데 사용되는 도메인을 결정합니다. 이 항목은 기본적으로 제공되지 않습니다.

CookieHttpOnly

브라우저가 클라이언트 쪽 JavaScript에서 쿠키를 액세스할 수 있도록 허용하는지 확인합니다. 기본값은 true입니다. 즉, 쿠키는 HTTP 요청에만 전달되며 페이지 스크립트에서는 사용할 수 없습니다.

CookieManager

요청에서 쿠키를 가져오거나 응답에 설정하는 데 사용되는 구성 요소입니다.

기본적으로 ChunkingCookieManager가 사용됩니다.

CookieName

ID를 유지하는 데 사용되는 쿠키 이름을 확인합니다. 기본값은 "입니다. AspNetCore.Cookies". AuthenticationScheme의 이름을 변경하는 경우, 특히 시스템에서 쿠키 인증 미들웨어를 여러 번 사용하는 경우 이 값을 변경해야 합니다.

CookiePath

쿠키를 만드는 데 사용되는 경로를 결정합니다. 가장 높은 브라우저 호환성을 위해 기본값은 "/"입니다.

CookieSecure

HTTPS 요청에서만 쿠키를 전송해야 하는지 확인합니다. 기본값은 SignIn을 수행 중인 페이지가 HTTPS인 경우에도 쿠키를 HTTPS 요청으로 제한하는 것입니다. HTTPS 로그인 페이지가 있고 사이트의 일부가 HTTP인 경우 이 값을 변경해야 할 수 있습니다.

DataProtectionProvider

설정된 경우 데이터 보호를 위해 CookieAuthenticationMiddleware에서 사용됩니다.

Description

응용 프로그램에 사용할 수 있게 된 인증 유형에 대한 추가 정보입니다.

(다음에서 상속됨 AuthenticationOptions)
Events

시작 시 응용 프로그램에서 만든 개체 인스턴스에 공급자를 할당할 수 있습니다. 미들웨어는 공급자에서 메서드를 호출하여 처리가 발생하는 특정 지점에서 애플리케이션 제어를 제공합니다. 컨트롤이 제공되지 않는 경우 메서드가 호출될 때 아무 작업도 수행되지 않는 기본 인스턴스가 제공됩니다.

ExpireTimeSpan

쿠키가 만들어진 시점부터 유효하게 유지되는 시간을 제어합니다. 만료 정보는 보호된 쿠키 티켓에 있습니다. 이로 인해 브라우저가 쿠키를 제거한 후 서버에 전달한 경우에도 만료된 쿠키가 무시됩니다.

LoginPath

LoginPath 속성은 나가는 401 권한이 없음 상태 코드를 302 지정된 로그인 경로로 리디렉션으로 변경해야 함을 미들웨어에 알립니다. 생성된 401이 ReturnUrlParameter라는 이름의 쿼리 문자열 매개 변수로 LoginPath에 추가된 현재 URL입니다. LoginPath에 대한 요청이 새 SignIn ID를 부여하면 ReturnUrlParameter 값이 브라우저를 다시 리디렉션하는 데 사용됩니다.
원래 권한이 없는 상태 코드를 발생시킨 URL에 대한 입니다.

LogoutPath

미들웨어에 LogoutPath가 제공된 경우 해당 경로에 대한 요청이 ReturnUrlParameter를 기반으로 리디렉션됩니다.

ReturnUrlParameter

ReturnUrlParameter는 401 권한이 없음 상태 코드가 302 로그인 경로로 리디렉션으로 변경된 경우 미들웨어에서 추가되는 쿼리 문자열 매개 변수 이름을 확인합니다. 또한 이 항목은 로그인 경로 또는 로그아웃 경로에 요청이 도착할 때 작업이 수행된 후 원래 URL로 되돌아가기 위해 검색되는 쿼리 문자열 매개 변수입니다.

SessionStore

요청 간에 ID를 저장할 선택적 컨테이너입니다. 사용되는 경우 세션 식별자만 클라이언트로 전송됩니다. ID가 많을 경우 발생하는 잠재적 문제를 줄이는 데 사용할 수 있습니다.

SlidingExpiration

SlidingExpiration이 true로 설정된 경우 만료 범위의 중간 부분 이상으로 요청을 처리할 때는 언제든지 새 만료 시간이 있는 새 쿠키를 다시 발급하도록 미들웨어에 지시합니다.

SystemClock

For testing purposes only.

SystemClock

For testing purposes only.

(다음에서 상속됨 AuthenticationOptions)
TicketDataFormat

TicketDataFormat은 ID 및 쿠키 값에 저장된 다른 속성을 보호 및 보호 해제하는 데 사용됩니다. 제공되지 않으면 IApplicationBuilder.Properties에 포함된 데이터 보호 서비스를 사용하여 기본 데이터 처리기가 만들어집니다. 기본 데이터 보호 서비스는 ASP.NET에서 실행 중인 경우 컴퓨터 키를 기반으로 하며 다른 프로세스에서 실행 중인 경우에는 DPAPI를 기반으로 합니다.

명시적 인터페이스 구현

IOptions<CookieAuthenticationOptions>.Value

CookieAuthenticationMiddleware에 대한 구성 옵션입니다.

적용 대상