IIS 통합 Windows 인증을 사용한 SSO(Single Sign On)

2025년 1월 12일

통합 Windows 인증 개요

통합 Windows 인증(Integrated Windows Authentication, IWA)은 IIS와 사용자가 동일한 도메인에 로그인한 경우 자동으로 사용자 자격 증명을 IIS에 제공하는 메커니즘입니다. 그러면 사용자 인증 완료 판정 및 인증된 사용자 정보를 얻을 수 있습니다.

이를 통해 사용자는 추가 로그인 작업 없이 IIS에서 호스팅(또는 연동)하는 웹 응용 프로그램에 액세스할 수 있으며 다른 응용 프로그램 서버와 SSO 연동을 수행할 수 있습니다.

※ 같은 도메인에 참가하고 있지 않은 경우나, 인증되어 있지 않은 유저가 IIS의 페이지에 액세스 하면 로그인 다이얼이 표시되어, 올바르게 인증하지 않는 경우는, HTTP Error 401.1 – Unauthorized 가 된다.

SSO(Single Sign On) 흐름

Chat&Messenger 온프레미스 Ultimate 플랜에서는 통합 Windows 인증을 통해 SSO가 가능합니다.

클라이언트는 먼저 통합 Windows 인증 페이지 /cam-iissso에 액세스합니다.
/cam-iissso 페이지에서 ASP.NET에서 인증된 결정을 내리고 CAMServer에 연결
CAMServer는 LDAP 검색을 수행하여 정규 AD 사용자인지 확인하고 ssoToken (고유 랜덤 값 30 바이트 이상)과 함께 CAMServer에 액세스하는 URL을 생성하고 리디렉션 요청을 수행합니다.
CAMServer에 액세스하고 ssoToken을 사용하여 인증합니다. 인증이 성공하면 API 액세스에 대한 세션 ID가 할당됩니다.

SSO를 실현하기 위한 요구사항

IIS 설치

서버 역할에서 IIS를 설치합니다.

IIS 설치 시 옵션으로 "Windows 인증"을 확인합니다.

IIS 역할 설치가 완료된 후 별도의 ISAPI 필터 및 ISAPI 확장 설치

ISAPI 필터: IIS에서 확장 모듈 로드를 지원합니다.
ISAPI 확장: IIS에 ISAPI 확장을 추가합니다. AspNetCoreModuleV2 동작에 필수입니다. IIS 관리자 시작(iisreset)

ASP.NET Core Hosting Bundle 설치

ASP.NET Core Hosting Bundle 설치하십시오.

설치 후 IIS를 다시 시작하여 처리기 매핑에 AspNetCoreModuleV2가 있는지 확인하십시오.

IIS 환경에서 ASP.NET Core 응용 프로그램을 호스팅하는 경우 ASP.NET Core Hosting Bundle을 설치하면 다음이 자동으로 설치됩니다. .NET Runtime ASP.NET Core Runtime

응용 프로그램 추가 (cam-iissso)

SSO 모듈을 다운로드하고 C:\inetpub\wwwroot\cam-iissso로 복사 https://chat-messenger.com/dl/fdd94dd-022_f2aaac/cam-iissso.zip Default Web Site에 cam-iissso 응용 프로그램 추가 별칭 cam-iissso 물리적 경로 C:\inetpub\wwwroot\cam-iissso