호환성: 응용 프로그램 간 인증 쿠키 공유하기

일반적으로 웹 사이트는 서로 조화롭게 동작하는 다수의 개별적인 웹 응용 프로그램으로 구성되는 경우가 많습니다. 따라서 응용 프로그램 개발자가 좋은 Single Sign-On 경험을 제공하기 위해서는, 사이트에 존재하는 모든 개별적인 웹 응용 프로그램들 간에 서로 인증 티켓을 공유해야 하는 경우가 종종 발생합니다.

이런 시나리오에 대응하기 위해서, 데이터 보호 스택은 Katana 쿠키 인증 및 ASP.NET Core 쿠키 인증 티켓의 공유를 지원합니다.

응용 프로그램 간 인증 쿠키 공유하기

두 개의 다른 ASP.NET Core 응용 프로그램 간에 서로 인증 쿠키를 공유하려면, 쿠키를 공유할 응용 프로그램들을 각각 다음과 같이 구성합니다.

구성 메서드 내에서 CookieAuthenticationOptions를 이용해서 쿠키에 관련된 데이터 보호 서비스를 설정하고 AuthenticationScheme을 ASP.NET 4.X에 적합하게 설정합니다.

ASP.NET Core Identity를 사용 중인 경우:

app.AddIdentity<ApplicationUser, IdentityRole>(options =>
{
    options.Cookies.ApplicationCookie.AuthenticationScheme = "ApplicationCookie";
    options.Cookies.ApplicationCookie.DataProtectionProvider = DataProtectionProvider.Create(new DirectoryInfo(@"c:\shared-auth-ticket-keys\"));
});

쿠키 미들웨어를 직접 사용할 경우:

app.UseCookieAuthentication(new CookieAuthenticationOptions
{
    DataProtectionProvider = DataProtectionProvider.Create(new DirectoryInfo(@"c:\shared-auth-ticket-keys\"))
});

DataProtectionProvider를 사용하려면 Microsoft.AspNetCore.DataProtection.Extensions NuGet 패키지가 필요합니다.

이 방식을 사용할 경우, DirectoryInfo는 인증 쿠키 전용으로 따로 준비된 키 저장소의 위치를 가리켜야 합니다. 이 쿠키 인증 미들웨어는 명시적으로 제공된 DataProtectionProvider의 구현을 사용하게 되는데, 이 DataProtectionProvider는 응용 프로그램의 다른 영역에서 사용되는 데이터 보호 시스템과 격리됩니다. 이때, 응용 프로그램들 간의 격리를 위해서 삽입되는 응용 프로그램 이름은 무시됩니다 (이는 의도적인 것으로, 여러 응용 프로그램에서 페이로드를 공유하려고 시도하고 있기 때문입니다).

 app.UseCookieAuthentication(new CookieAuthenticationOptions
 {
     DataProtectionProvider = DataProtectionProvider.Create(
         new DirectoryInfo(@"c:\shared-auth-ticket-keys\"),
         configure =>
         {
             configure.ProtectKeysWithCertificate("thumbprint");
         })
 });

ASP.NET 4.x 응용 프로그램과 ASP.NET Core 응용 프로그램 간 인증 쿠키 공유하기

Katana 쿠키 인증 미들웨어를 사용하는 ASP.NET 4.x 응용 프로그램은 ASP.NET Core 쿠키 인증 미들웨어와 호환되는 인증 쿠키를 생성하도록 구성할 수 있습니다. 이를 활용하면 대규모 사이트를 구성하는 각각의 응용 프로그램들을 단계적으로 업그레이드 하면서, 동시에 계속해서 사이트 전체에 걸친 원활한 Single Sign 경험을 제공할 수 있습니다.

ASP.NET 4.x 응용 프로그램과 ASP.NET Core 응용 프로그램 간에 인증 쿠키를 공유하려면, 이전 절에서 설명한 것처럼 ASP.NET Core 응용 프로그램을 구성하고 다음과 같은 과정에 따라 ASP.NET 4.x 응용 프로그램을 구성하십시오.

1. Microsoft.Owin.Security.Interop 패키지를 대상 ASP.NET 4.x 응용 프로그램에 설치합니다.

2. Startup.Auth.cs 파일에서 UseCookieAuthentication을 호출하는 코드를 찾습니다. 일반적으로 다음과 같은 형태를 띄고 있습니다.

   app.UseCookieAuthentication(new CookieAuthenticationOptions
   {
       // ...
   });

3. 다음과 같이 UseCookieAuthentication 호출을 수정해서, CookieName을 ASP.NET Core 쿠키 인증 미들웨어에서 사용되는 이름과 동일하게 변경하고, 키 저장소 경로를 전달해서 초기화 한 DataProtectionProvider의 인스턴스를 제공하고, 청크 형식이 호환되도록 CookieManager를 Interop ChunkingCookieManager로 설정합니다.

   app.UseCookieAuthentication(new CookieAuthenticationOptions
   {
       AuthenticationType = DefaultAuthenticationTypes.ApplicationCookie,
       CookieName = ".AspNetCore.Cookies",
       // CookiePath = "...", (if necessary)
       // ...
       TicketDataFormat = new AspNetTicketDataFormat(
           new DataProtectorShim(
               DataProtectionProvider.Create(new DirectoryInfo(@"c:\shared-auth-ticket-keys\"))
               .CreateProtector("Microsoft.AspNetCore.Authentication.Cookies.CookieAuthenticationMiddleware",
               "Cookies", "v2"))),
       CookieManager = new ChunkingCookieManager()
   });

   DirectoryInfo는 ASP.NET Core 응용 프로그램에서 지정한 저장소 위치와 동일한 경로를 가리켜야 하고 동일한 설정을 사용해서 구성돼야 합니다.

이렇게 구성하면 ASP.NET 4.x 및 ASP.NET Core 응용 프로그램이 인증 쿠키를 공유하게 됩니다.