세션 및 보안

문서 세션 및 액세스 제어

Doconut 토큰은 열려 있는 문서를 식별합니다. 이 토큰을 포함한 요청이 제공되면, 토큰을 얻은 사람은 모든 페이지를 읽을 수 있습니다. 이 페이지에서는 문서 세션이 무엇을 보유하고 있는지, 얼마나 오래 지속되는지, 그리고 DocImage.axd이(가) 누가 페이지를 볼 수 있는지 결정하는 방법을 — 단일 서버와 웹 팜 모두에서 — 설명합니다.

문서 세션이 보유하는 내용

각 성공적인 OpenDocumentAsync은 메모리에 보관되는 하나의 세션을 생성합니다:

  • 로드된 포맷 뷰어 — 구문 분석된 문서를 보유하는 엔진 인스턴스,
  • 페이지별 상태 — 회전, 뒤집기 및 사용자가 위젯에서 적용하는 주석 데이터,
  • 선택적인 검색 인덱스, 첫 번째 검색 시 구축되거나 미리 구축된 .srh 파일에서 로드됩니다,
  • 세션 워터마크는 DocOptions.Watermark에서 가져옵니다.

수명

세션은 슬라이딩 윈도우 방식으로 만료됩니다: DocOptions.TimeOut 분(기본값 60), 토큰을 제시하는 모든 요청에 의해 재설정됩니다. 세션이 종료될 때 — 만료 또는 CloseDocument(token)에 의해 — 해당 문서 엔진이 해제되고 메모리가 즉시 해제됩니다.

csharp
// 한 번의 미리보기를 위한 단기간 세션
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

만료된 토큰을 포함한 요청은 Document session not found. Please re-open document. 라는 오류 이미지를 반환합니다. 페이지는 새 토큰을 얻기 위해 문서를 다시 열어야 합니다. 단일 서버에서는 애플리케이션 풀을 재활용하면 모든 세션도 종료됩니다.

페이지는 해당 세션이 열었을 때만 제공됩니다

UnsafeMode = false — 기본값 — 을 사용하면 문서를 열 때 해당 요청의 ASP.NET 세션에 secure-{token} 항목을 기록하여 접근 권한을 부여합니다. DocImage.axd은 세션 상태 자체가 필요하며, 요청 세션이 해당 항목을 보유하고 있을 때만 페이지를 제공합니다. 동일한 토큰을 제시하는 다른 브라우저는 You Are Not Authorized To View This Page. 라는 오류 이미지를 받게 됩니다.

csharp
Doconut.DoconutHost.Initialize(options =>
{
    // false (기본값): DocImage.axd는 열었던 ASP.NET 세션에만 페이지를 제공합니다
    // 문서. 핸들러가 자체적으로 세션 상태를 요청합니다; 사이트가 세션 상태를 끄지 않기만 하면 됩니다
    // Web.config에서 세션 상태를 끄십시오.
    options.UnsafeMode = false;
});

세 가지 실용적인 결과:

  • 열기 엔드포인트는 세션 상태가 필요합니다. MVC 컨트롤러와 Web Forms 페이지는 기본적으로 세션 상태를 가지고 있습니다. 사용자 정의 IHttpHandler은 System.Web.SessionState.IRequiresSessionState을 구현하지 않으면 세션 상태가 없습니다. 세션 없이 열면 부여할 것이 없으므로 뷰어는 모든 페이지에서 "You Are Not Authorized To View This Page." 라는 메시지를 표시합니다.
  • 세션 상태는 유지되어야 합니다. <sessionState mode="Off" />이 Web.config에 있으면 부여와 검사가 모두 비활성화되어 모든 페이지가 거부됩니다.
  • 브라우저는 세션 쿠키를 전송해야 합니다. 위젯의 요청은 동일 출처이므로 자동으로 ASP.NET_SessionId를 포함합니다. 쿠키 저장소가 없는 클라이언트(스크립트, 서버 간 호출, 쿠키를 제거하는 크로스 오리진 설정)는 거부됩니다. 이것이 기능이 작동하는 방식입니다.

UnsafeMode = true은 검사를 끕니다: 토큰을 포함한 모든 요청이 제공됩니다. 이는 각 문서에 대한 전역 스위치이며, 문서별 재정의가 없습니다. false 상태로 두세요.

폐기

CloseDocument(token)은 메모리를 해제하는 것 이상을 수행합니다: 현재 요청의 세션에서 secure-{token} 항목을 제거하고 토큰을 폐기하여, 폐기된 토큰은 즉시 거부됩니다.

웹 팜: 서명된 티켓

팜에서는 다음 요청이 문서를 한 번도 본 적 없는 서버, 다른 워커 프로세스, 자체 ASP.NET 세션을 가진 서버에 도달할 수 있습니다. 세션 부여는 이를 따라가지 못합니다. 분산 모드는 이를 브라우저에 바인딩된 서명된 티켓으로 대체합니다: 모든 노드는 문서 세션을 위한 하나의 저장소와 하나의 서명 키를 공유하며, DocImage.axd은 티켓이 해당 토큰, 해당 브라우저에 대해 유효하고 — 사용자가 로그인된 경우 — 해당 사용자에 대해 유효할 때 요청을 허용합니다.

설정은 모든 노드에서 동일합니다:

csharp
// Global.asax.cs - Application_Start
// 팜 비밀: 최소 32 bytes, 모든 노드에서 동일하며, 소스 제어에서 제외됩니다.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));

Doconut.DoconutHost.Initialize(
    options => options.UnsafeMode = false,     // 티켓 검사는 이것이 false일 때만 실행됩니다
    services => services.AddDoconutDistributed(d =>
    {
        d.Store             = CloudLocation.FileShare;
        d.FileShareRootPath = @"\\fileserver\doconut-shared";  // 모든 노드가 접근할 수 있는 폴더
        d.SigningKey        = farmKey;                          // 최소 32 bytes, 모든 노드에서 동일
    }));

그런 다음 열기 엔드포인트는 열기 전에 티켓을 브라우저에 바인딩하고, 토큰과 함께 티켓을 반환합니다:

  • DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)을 설정합니다 — 티켓에 연결된 doconut-client 쿠키를 발행하고 — DocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);
  • OpenDocumentAsync 후에, 토큰과 함께 viewer.AccessToken을 반환합니다;
  • 페이지에서 두 값을 위젯에 전달합니다: objViewer.View(token, access).

클래식 웹 팜 플래그(IsWebfarm와 ExportToPng)에서 전환하시나요? 마이그레이션에서 단계별 변화를 보여줍니다.

서명 키를 소스 제어에 포함하지 마세요: 이 키는 티켓에 서명하고 공유 저장소의 문서를 암호화합니다. 다른 키를 가진 노드는 다른 노드가 발행한 모든 티켓을 거부합니다.

실제 브라우저나 쿠키를 유지하는 스크립트로 팜을 테스트하세요. doconut-client 쿠키가 없는 클라이언트는 401으로 응답받지 않습니다: 상태 200과 함께 "not authorized" 오류 이미지를 받으며, 크기는 약 2KB로 실제 페이지가 수십에서 수백 KB인 것과 대비됩니다.

운영 체크리스트

  • UnsafeMode = false을 유지하세요(기본값).
  • 세션 상태가 있는 요청에서 문서를 열고, 세션 상태를 절대 끄지 마세요.
  • 세션 쿠키가 DocImage.axd에 도달하도록 확인하세요(동일 출처, HTTPS, 이를 허용하는 SameSite 정책).
  • 팜에서는 모든 노드가 공유하는 하나의 서명 키를 사용한 분산 모드를 사용하세요.
  • 사용자가 문서를 떠날 때 CloseDocument을 호출하세요 — 메모리와 보안 모두에 이점이 있습니다.
  • 토큰을 절대 로그하거나 공유하지 마세요; 단명한 자격 증명으로 취급하세요.

이 페이지가 도움이 되었나요?