Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 8개 있습니다.)

Wslhub.Sdk 사용으로 알아보는 CoInitializeSecurity 사용 제약

남정현 님이 nuget에 공개한 Wslhub.Sdk 패키지는,

Wslhub.Sdk
; https://www.nuget.org/packages/Wslhub.Sdk/

Windows 10에 설치된 WSL의 다양한 기능을 래핑해 아래와 같이 사용법을 제공합니다.

using Wslhub.Sdk;

// Place the code Wsl.InitializeSecurityModel() at the top of your application's Main() method.
Wsl.InitializeSecurity();

// Assert WSL installation status
Wsl.AssertWslSupported();

// Enumerate distro list
var distros = Wsl.GetDistroListFromRegistry();

// Query distro informations
var queryResults = Wsl.GetDistroQueryResult();

// Run a command
var result = Wsl.RunWslCommand(distroName, "cat /etc/passwd");

// Run a command with default distro
var defaultDistro = Wsl.GetDefaultDistro();
var result = defaultDistro.RunWslCommand("cat /etc/passwd");
Stream Redirection
using var outputStream = new MemoryStream();

var defaultDistro = Wsl.GetDefaultDistro();
defaultDistro.RunWslCommand("ls /dev | gzip -", outputStream);

outputStream.Seek(0L, SeekOrigin.Begin);
using var gzStream = new GZipStream(outputStream, CompressionMode.Decompress, true);
using var streamReader = new StreamReader(gzStream, new UTF8Encoding(false), false);
var content = streamReader.ReadToEnd();

Console.Out.WriteLine(content);

이 중에서 Wsl.InitializeSecurity() 메서드는,

wsl-sdk-dotnet/src/Wslhub.Sdk/Wsl.cs /
; https://github.com/wslhub/wsl-sdk-dotnet/blob/main/src/Wslhub.Sdk/Wsl.cs#L19

public static void InitializeSecurityModel()
{
    var result = NativeMethods.CoInitializeSecurity(
        IntPtr.Zero,
        (-1),
        IntPtr.Zero,
        IntPtr.Zero,
        NativeMethods.RpcAuthnLevel.Default,
        NativeMethods.RpcImpLevel.Impersonate,
        IntPtr.Zero,
        NativeMethods.EoAuthnCap.StaticCloaking,
        IntPtr.Zero);

    if (result != 0)
        throw new COMException("Cannot complete CoInitializeSecurity.", result);
}

CoInitializeSecurity Win32 API 함수를 호출하는데요, 엄밀히는 Console App 프로젝트에서 저걸 호출하지 않아도 WslHub 패키지는 잘 동작합니다.

var defaultDistro = Wsl.GetDefaultDistro();
var result = defaultDistro.RunWslCommand("cat /etc/passwd"); // 정상 동작

그런데 굳이 CoInitializeSecurity를 명시적으로 호출하는 이유는, 이것의 적용이 Process(EXE) 전역적으로 단 한 번의 호출만 허용된다는 특징을 가지기 때문입니다. 이에 대해서는 이미 아래의 논의에서 나왔는데요,

CoInitializeSecurity를 제대로 부르고 싶으면 결국은 네이티브의 힘을 빌릴 수밖에 없는 걸까요?
; https://forum.dotnetdev.kr/t/coinitializesecurity/1002

간단하게 예를 들어, Console App 프로젝트를 만들어 2번 연속 호출해 보면,

using System;
using WslSdk.Interop;

// Install-Package Wslhub.Sdk
class Program
{
    static void Main(string[] args)
    {
        var result = NativeMethods.CoInitializeSecurity(
            IntPtr.Zero,
            (-1),
            IntPtr.Zero,
            IntPtr.Zero,
            NativeMethods.RpcAuthnLevel.Default,
            NativeMethods.RpcImpLevel.Impersonate,
            IntPtr.Zero,
            NativeMethods.EoAuthnCap.StaticCloaking,
            IntPtr.Zero);

        Console.WriteLine(result);

        result = NativeMethods.CoInitializeSecurity(
            IntPtr.Zero,
            (-1),
            IntPtr.Zero,
            IntPtr.Zero,
            NativeMethods.RpcAuthnLevel.Default,
            NativeMethods.RpcImpLevel.Impersonate,
            IntPtr.Zero,
            NativeMethods.EoAuthnCap.StaticCloaking,
            IntPtr.Zero);

        Console.WriteLine(result);
    }
}

/* 출력 결과
0
-2147417831
*/

처음 호출은 0(S_OK)을 반환하지만, 두 번째 호출은 0x80010119(-2147417831) 값으로 RPC_E_TOO_LATE - "Security must be initialized before any interfaces are marshalled or unmarshalled. It cannot be changed once initialized." 오류를 의미합니다.

따라서, 응용 프로그램 사용 중에 누군가 CoInitializeSecurity를 다른 옵션을 적용해 초기화하게 되면 이후의 WslHub 메서드들이 정상 동작하지 않을 수 있으므로 미리 WslHub의 요구 사항에 맞게 호출해 두는 것뿐입니다. (그렇다면, 반대로 다른 응용 프로그램들이 CoInitializeSecurity를 호출했을 때 의도했던 목적으로의 사용은 실패하게 될 것입니다.)




그런데, WSL Win32 API 호출과 CoInitializeSecurity가 무슨 관계가 있을까요?

이에 대해서도 "CoInitializeSecurity를 제대로 부르고 싶으면 결국은 네이티브의 힘을 빌릴 수밖에 없는 걸까요?" 질문에서 설명이 나옵니다.

즉, WSL의 기능들은 내부적으로 (svchost.exe로 호스팅 중인) lxssmanager.dll에서 제공하는 CLSID_LxssUserSession/IID_ILxssSession COM 개체를 통해 노출이 되는데, WSL Win32 API 함수들은 그 COM 개체 사용을 래퍼하는 층에 불과합니다. (확인하지는 않았습니다. ^^)

결국 여러분의 프로세스에서 호출하는 Win32 API는 svchost.exe로의 RPC 호출이 되고 이 과정에서 원격 호출을 위한 자격 전달의 기본 모드를 CoInitializeSecurity로 설정할 수 있었던 것입니다. 여기서 WSL API 사용과 관계해 중요한 것은 Impersonate 인자인데요,

var result = NativeMethods.CoInitializeSecurity(
    IntPtr.Zero,
    (-1),
    IntPtr.Zero,
    IntPtr.Zero,
    NativeMethods.RpcAuthnLevel.Default,
    NativeMethods.RpcImpLevel.Impersonate,
    IntPtr.Zero,
    NativeMethods.EoAuthnCap.StaticCloaking,
    IntPtr.Zero);

만약 이 값을 Identify나 Anonymous로 바꾸면 실행 시 다음과 같은 식의 오류가 발생합니다.

Unhandled Exception: System.Exception: Ubuntu20.04 is not registered distro.
   at Wslhub.Sdk.Wsl.RunWslCommand(String distroName, String commandLine, Int32 bufferLength)
   at WinFormInit.Program.Main(String[] args)

왜냐하면, 호출 측의 자격 증명(예를 들어 로컬 컴퓨터의 testusr 계정)이 서비스 측(svchost.exe)으로 전달되지 않기 때문에 서버는 현재 호출의 사용자 계정 문맥을 확인할 수 없고, 이는 "Ubuntu20.04"가 설치된 testusr 계정에 대한 정보를 알 수 없는 결과를 낳기에 저런 오류가 발생하게 됩니다.

정리하면, svchost.exe에서 실행하는 코드를 현재 우리가 실행 중인 프로그램(ConsoleApp1.exe)을 구동한 사용자 계정의 문맥으로 실행할 수 있어야 정상적인 WSL Win32 API들이 동작할 수 있습니다. 그리고, 이를 위해서는 (기본값으로 Impersonate가 가능하기 때문에) CoInitializeSecurity 호출을 아예 하지 않거나, Impersonate가 가능한 모드로 CoInitializeSecurity를 호출해야 한다는 전제 조건이 필요합니다.

(첨부 파일은 이 글의 예제 프로젝트를 포함합니다.)




(업데이트: 별도 DLL에 포함된 타입을 STAThread Main 메서드에서 사용하는 경우 CoInitializeSecurity 자동 호출)

참고로, "CoInitializeSecurity를 제대로 부르고 싶으면 결국은 네이티브의 힘을 빌릴 수밖에 없는 걸까요?" 글에서는 STAThread가 붙은 경우 CoInitializeSecurity가 모두 성공했다고 하지만 제가 테스트한 바에 따르면 달랐습니다. 즉, 다음의 코드를,

using System;
using WslSdk.Interop;

class Program
{
    [STAThread]
    static void Main(string[] args)
    {
        var result = NativeMethods.CoInitializeSecurity(
            IntPtr.Zero,
            (-1),
            IntPtr.Zero,
            IntPtr.Zero,
            NativeMethods.RpcAuthnLevel.None,
            NativeMethods.RpcImpLevel.Impersonate,
            IntPtr.Zero,
            NativeMethods.EoAuthnCap.StaticCloaking,
            IntPtr.Zero);

        Console.WriteLine(result);
    }
}

.NET Framework에서 실행하면 -2147417831(RPC_E_TOO_LATE) 값이 반환되고 .NET Core에서 실행하면 0이 반환됩니다.




C# - CoCreateInstance 관련 Inteop 오류 정리
; https://www.sysnet.pe.kr/2/0/12678

Wslhub.Sdk 사용으로 알아보는 CoInitializeSecurity 사용 제약
; https://www.sysnet.pe.kr/2/0/12665

별도 DLL에 포함된 타입을 STAThread Main 메서드에서 사용하는 경우 CoInitializeSecurity 자동 호출
; https://www.sysnet.pe.kr/2/0/12666

COM+ 서버 응용 프로그램을 이용해 CoInitializeSecurity 제약 해결
; https://www.sysnet.pe.kr/2/0/12667

ionescu007/lxss github repo에 공개된 lxssmanager.dll의 CLSID_LxssUserSession/IID_ILxssSession 사용법
; https://www.sysnet.pe.kr/2/0/12676

역공학을 통한 lxssmanager.dll의 ILxssSession 사용법 분석
; https://www.sysnet.pe.kr/2/0/12677

C# - DLL Surrogate를 이용한 Out-of-process COM 개체 제작
; https://www.sysnet.pe.kr/2/0/12668

DLL Surrogate를 이용한 Out-of-process COM 개체에서의 CoInitializeSecurity 문제
; https://www.sysnet.pe.kr/2/0/12670

CoInitializeSecurity의 전역 설정을 재정의하는 CoSetProxyBlanket 함수 사용법
; https://www.sysnet.pe.kr/2/0/12679




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 2/4/2023]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 31  32  33  34  [35]  36  37  38  39  40  41  42  43  44  45  ...
NoWriterDateCnt.TitleFile(s)
12763정성태8/9/20218060Java: 29. java.lang.NullPointerException - com.mysql.jdbc.ConnectionImpl.getServerCharset
12762정성태8/8/202111677Java: 28. IntelliJ - Unable to open debugger port 오류
12761정성태8/8/20218826Java: 27. IntelliJ - java: package javax.inject does not exist [2]
12760정성태8/8/20216178개발 환경 구성: 594. 전용 "Command Prompt for ..." 단축 아이콘 만들기
12759정성태8/8/20219366Java: 26. IntelliJ + Spring Framework + 새로운 Controller 추가 [2]파일 다운로드1
12758정성태8/7/20218695오류 유형: 751. Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode)
12757정성태8/7/20219421Java: 25. IntelliJ + Spring Framework 프로젝트 생성
12756정성태8/6/20218126.NET Framework: 1084. C# - .NET Core Web API 단위 테스트 방법 [1]파일 다운로드1
12755정성태8/5/20217267개발 환경 구성: 593. MSTest - 단위 테스트에 static/instance 유형의 private 멤버 접근 방법파일 다운로드1
12754정성태8/5/20218154오류 유형: 750. manage.py - Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
12753정성태8/5/20218422오류 유형: 749. PyCharm - Error: Django is not importable in this environment
12752정성태8/4/20216523개발 환경 구성: 592. JetBrains의 IDE(예를 들어, PyCharm)에서 Visual Studio 키보드 매핑 적용
12751정성태8/4/20219633개발 환경 구성: 591. Windows 10 WSL2 환경에서 docker-compose 빌드하는 방법
12750정성태8/3/20216383디버깅 기술: 181. windbg - 콜 스택의 "Call Site" 오프셋 값이 가리키는 위치
12749정성태8/2/20215807개발 환경 구성: 590. Visual Studio 2017부터 단위 테스트에 DataRow 특성 지원
12748정성태8/2/20216443개발 환경 구성: 589. Azure Active Directory - tenant의 관리자(admin) 계정 로그인 방법
12747정성태8/1/20217024오류 유형: 748. 오류 기록 - MICROSOFT GRAPH – HOW TO IMPLEMENT IAUTHENTICATIONPROVIDER파일 다운로드1
12746정성태7/31/20219076개발 환경 구성: 588. 네트워크 장비 환경을 시뮬레이션하는 Packet Tracer 프로그램 소개
12745정성태7/31/20216911개발 환경 구성: 587. Azure Active Directory - tenant의 관리자 계정 로그인 방법
12744정성태7/30/20217530개발 환경 구성: 586. Azure Active Directory에 연결된 App 목록을 확인하는 방법?
12743정성태7/30/20218188.NET Framework: 1083. Azure Active Directory - 외부 Token Cache 저장소를 사용하는 방법파일 다운로드1
12742정성태7/30/20217441개발 환경 구성: 585. Azure AD 인증을 위한 사용자 인증 유형
12741정성태7/29/20218651.NET Framework: 1082. Azure Active Directory - Microsoft Graph API 호출 방법파일 다운로드1
12740정성태7/29/20217320오류 유형: 747. SharePoint - InvalidOperationException 0x80131509
12739정성태7/28/20217308오류 유형: 746. Azure Active Directory - IDW10106: The 'ClientId' option must be provided.
12738정성태7/28/20217895오류 유형: 745. Azure Active Directory - Client credential flows must have a scope value with /.default suffixed to the resource identifier (application ID URI).
... 31  32  33  34  [35]  36  37  38  39  40  41  42  43  44  45  ...