Microsoft MVP성태의 닷넷 이야기
개발 환경 구성: 390. C# - 컴파일러 옵션 OSS signing / Public Signing [링크 복사], [링크+제목 복사]
조회: 2464
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

C# - 컴파일러 옵션 OSS signing / Public Signing

지난 글에서 설명한 옵션과 함께,

C# - 재현 가능한 빌드(reproducible builds) == Deterministic builds
; https://blogs.msdn.microsoft.com/dotnet/2016/04/02/whats-new-for-c-and-vb-in-visual-studio/

비주얼 스튜디오 2015 업데이트 2(엄밀히 Roslyn 컴파일러)에 추가된 기능으로,

New C# and VB features in Visual Studio 2015 Update 2
; https://blogs.msdn.microsoft.com/dotnet/2016/04/02/whats-new-for-c-and-vb-in-visual-studio/

publicSign 옵션이 있습니다.

Public Signing
; https://github.com/dotnet/corefx/blob/master/Documentation/project-docs/public-signing.md

말 그대로, publicKey로만 서명된 것으로,

publicSign: Supports a new method of signing that is similar to delay signing except it doesn’t need to add skip verification entries to your machine. Binaries can be public signed with only the public key and load into contexts necessary for development and testing. This is also known as OSS signing.


당연히 개인키 없이 서명하는 것이므로 누구에 의해 만들어졌음을 보증할 수는 없습니다. 이 옵션이 어떤 것인지는, 그것이 나오게 된 이유를 들여다보면 쉽게 알 수 있습니다.

.NET Full Framework의 경우, 마이크로소프트가 만들고 배포를 했으며 이는 GAC에 등록이 됩니다. 따라서 기존의 강력한 이름 서명으로 만족할 수 있었고, 별 문제가 없었습니다. 하지만, .NET Core가 나오면서 이런 상황이 바뀝니다. .NET Core는 누구나 빌드해서 배포할 수 있는 오픈 소스 프로젝트이기 때문에 마이크로소프트가 해당 어셈블리들을 서명하기 위해 개인키를 함께 노출할 수는 없는 상황입니다. (다시 말해, 개인키 파일까지 github에 올릴 수는 없습니다.) 물론, 마이크로소프트가 배포하는 .NET Core 모듈만 개인키 서명을 하면 되고, 직접 빌드한 경우에는 서명 작업을 아예 안할 수도 있습니다. 그런데 이런 경우 문제가 발생합니다.

가령, 기존에 만들어진 프로그램이 마이크로소프트가 배포한 .NET Core를 참조했다고 가정해 보겠습니다. 즉, 프로그램에는 이미 마이크로소프트가 서명한 .NET Core를 강력한 이름의 어셈블리로 참조를 추가하고 있는 것입니다. 그런데 이 프로그램을 자신이 빌드한 .NET Core 환경에서 실행시키는 경우, 서명이 없으므로 해당 프로그램은 서명이 있는 어셈블리와 바인딩을 시도하므로 실패하게 되는 것입니다.

따라서, 자신이 빌드를 주도할 수 없는 오픈 소스 프로젝트의 경우라면 기존의 "강력한 이름 서명" 방식이 어울리지 않게 된 것입니다. 이를 위해 보완된 것이 바로 "공개 서명(Public Signing)"이고 이것이 오픈 소스 프로젝트와 어울리다 보니 한때 "오픈 소스 서명(OSS - Open Source Signing)"이라고도 불렸던 것입니다.

어찌 보면, 개인 키 서명을 미뤄두는 "delay signing"과 유사하지만 차이점이라면 별도의 서명하지 않은 어셈블리에 대한 "보안 생략 설정(Skip Verification)"을 하지 않아도 된다는 것입니다.

지연 서명된 DLL과 서명된 DLL의 차이점
; https://www.sysnet.pe.kr/2/0/11258

지연 서명된 어셈블리를 sn.exe -Vr 등록 없이 사용하는 방법
; https://www.sysnet.pe.kr/2/0/11259

이런 특징 덕분에 개발자의 환경뿐만 아니라 일반 사용자의 환경에서도 실행에 아무런 불편함이 없게 되었습니다.




결국, 이 기능으로 인해 마이크로소프트는 닷넷 관련 오픈 소스 프로젝트에 "공개키"만을 포함시켜도 되었고 여전히 어셈블리의 이름을 "강력한 이름(strong name)"으로 부여할 수 있게 되었습니다.

여러분들도, github에 올릴 오픈 소스가 있는데 그것에 서명하고 싶다면 (혹은, 은근히 PublicKeyToken을 자신의 개인키로 서명하던 것들과 일치시키고 싶다면) Public Signing을 이용하시면 됩니다. 방법은, 간단하게 csproj 파일에 다음의 옵션을 추가하는 것입니다.

<PublicSign>True</PublicSign>

하지만, 이 옵션만 주고 빌드하면 다음의 에러가 떨어집니다.

error CS8102: Public signing was specified and requires a public key, but no public key was specified.

아무리 그래도 공개키는 있어야 하는 것입니다. ^^ 이를 위해 비주얼 스튜디오의 "Developer Command Prompt for VS 2017"에서 다음과 같이 sn.exe를 실행시켜 공개키를 담은 파일을 구할 수 있습니다.

c:\temp>sn -k test.snk

Microsoft (R) .NET Framework Strong Name Utility  Version 4.0.30319.0
Copyright (c) Microsoft Corporation.  All rights reserved.

Key pair written to test.snk

c:\temp>sn -p test.snk public.snk

Microsoft (R) .NET Framework Strong Name Utility  Version 4.0.30319.0
Copyright (c) Microsoft Corporation.  All rights reserved.

Public key written to public.snk

위에서 보면, -k 옵션으로 개인키/공개키를 함께 담은 test.snk 파일을 생성하고 -p 옵션을 이용해 그 파일로부터 공개키만을 담은 별도의 public.snk 파일을 생성했습니다. 이제 public.snk 파일만 솔루션 폴더에 복사한 후 공개 서명할 어셈블리의 프로젝트 파일에 다음의 설정을 추가합니다.

<SignAssembly>True</SignAssembly>
<AssemblyOriginatorKeyFile>$(SolutionDir)public.snk</AssemblyOriginatorKeyFile>

빌드 후, 출력된 바이너리(dll/exe) 파일을 .NET Reflector 같은 도구를 이용해 열어 보면 다음과 같이 강력한 이름이 지정된 것을 볼 수 있습니다.

ClassLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=fd4372d50df8504c

또한, 이 파일을 참조하는 다른 어셈블리가 있다면 이에 대한 참조에 강력한 이름 형식으로 바인딩하고 있는 것을 ildasm.exe를 통해 확인할 수 있습니다.

.assembly extern ClassLibrary1
{
  .publickeytoken = (FD 43 72 D5 0D F8 50 4C )                         // .Cr...PL
  .ver 1:0:0:0
}

"Public Signing" 글에서도 설명하고 있지만, 어셈블리에 지정된 CorFlags 값도,

[Flags]
public enum CorFlags
{
    ILOnly           = 0x00000001,
    Requires32Bit    = 0x00000002,
    ILLibrary        = 0x00000004,
    StrongNameSigned = 0x00000008,
    NativeEntryPoint = 0x00000010,
    TrackDebugData   = 0x00010000,
    Prefers32Bit     = 0x00020000,
}

여느 강력한 이름으로 서명된 어셈블리와 다를 바 없게 지정되어 있습니다.

[서명 전]
E:\ConsoleApp1\bin\Debug>corflags ClassLibrary1.dll
Microsoft (R) .NET Framework CorFlags Conversion Tool.  Version  4.6.1055.0
Copyright (c) Microsoft Corporation.  All rights reserved.

Version   : v4.0.30319
CLR Header: 2.5
PE        : PE32
CorFlags  : 0x1
ILONLY    : 1
32BITREQ  : 0
32BITPREF : 0
Signed    : 0

[서명 후]
E:\ConsoleApp1\bin\Debug>corflags ClassLibrary1.dll
Microsoft (R) .NET Framework CorFlags Conversion Tool.  Version  4.6.1055.0
Copyright (c) Microsoft Corporation.  All rights reserved.

Version   : v4.0.30319
CLR Header: 2.5
PE        : PE32
CorFlags  : 0x9 ( == ILOnly | StrongNameSigned)
ILONLY    : 1
32BITREQ  : 0
32BITPREF : 0
Signed    : 1




참고로, 빌드 시에 다음과 같은 오류가 발생한다면?

Error CS8102 Public signing was specified and requires a public key, but no public key was specified.

다음의 옵션을 누락시켰기 때문입니다.

<SignAssembly>True</SignAssembly>




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



donaricano-btn



[최초 등록일: ]
[최종 수정일: 7/25/2018 ]

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

비밀번호

댓글 쓴 사람
 




... [16]  17  18  19  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
12114정성태1/13/20201474디버깅 기술: 156. C# - PDB 파일로부터 심벌(Symbol) 및 타입(Type) 정보 열거 [1]파일 다운로드3
12113정성태1/12/20202012오류 유형: 590. Visual C++ 빌드 오류 - fatal error LNK1104: cannot open file 'atls.lib' [1]
12112정성태1/12/2020919오류 유형: 589. PowerShell - 원격 Invoke-Command 실행 시 "WinRM cannot complete the operation" 오류 발생
12111정성태3/23/20202047디버깅 기술: 155. C# - KernelMemoryIO 드라이버를 이용해 실행 프로그램을 숨기는 방법(DKOM: Direct Kernel Object Modification) [12]
12110정성태6/23/20201550디버깅 기술: 154. Patch Guard로 인해 블루 스크린(BSOD)가 발생하는 사례 [5]파일 다운로드1
12109정성태1/10/20201212오류 유형: 588. Driver 프로젝트 빌드 오류 - Inf2Cat error -2: "Inf2Cat, signability test failed."
12108정성태1/10/2020917오류 유형: 587. Kernel Driver 시작 시 127(The specified procedure could not be found.) 오류 메시지 발생
12107정성태1/10/20201065.NET Framework: 877. C# - 프로세스의 모든 핸들을 열람 - 두 번째 이야기
12106정성태1/8/20201169VC++: 136. C++ - OSR Driver Loader와 같은 Legacy 커널 드라이버 설치 프로그램 제작 [1]
12105정성태1/8/20201104디버깅 기술: 153. C# - PEB를 조작해 로드된 DLL을 숨기는 방법
12104정성태1/9/20201561DDK: 9. 커널 메모리를 읽고 쓰는 NT Legacy driver와 C# 클라이언트 프로그램 [4]
12103정성태4/23/20202739DDK: 8. Visual Studio 2019 + WDK Legacy Driver 제작- Hello World 예제 [1]파일 다운로드2
12102정성태1/6/20201642디버깅 기술: 152. User 권한(Ring 3)의 프로그램에서 _ETHREAD 주소(및 커널 메모리를 읽을 수 있다면 _EPROCESS 주소) 구하는 방법
12101정성태1/8/20201140.NET Framework: 876. C# - PEB(Process Environment Block)를 통해 로드된 모듈 목록 열람
12100정성태1/3/2020821.NET Framework: 875. .NET 3.5 이하에서 IntPtr.Add 사용
12099정성태1/3/20201186디버깅 기술: 151. Windows 10 - Process Explorer로 확인한 Handle 정보를 windbg에서 조회
12098정성태9/10/20201236.NET Framework: 874. C# - 커널 구조체의 Offset 값을 하드 코딩하지 않고 사용하는 방법 [3]
12097정성태1/2/2020857디버깅 기술: 150. windbg - Wow64, x86, x64에서의 커널 구조체(예: TEB) 구조체 확인
12096정성태1/2/20201171디버깅 기술: 149. C# - DbgEng.dll을 이용한 간단한 디버거 제작
12095정성태12/27/20191349VC++: 135. C++ - string_view의 동작 방식
12094정성태11/23/20201192.NET Framework: 873. C# - 코드를 통해 PDB 심벌 파일 다운로드 방법
12093정성태12/26/20191394.NET Framework: 872. C# - 로딩된 Native DLL의 export 함수 목록 출력파일 다운로드1
12092정성태12/25/20191215디버깅 기술: 148. cdb.exe를 이용해 (ntdll.dll 등에 정의된) 커널 구조체 출력하는 방법
12091정성태12/25/20191864디버깅 기술: 147. pdb 파일을 다운로드하기 위한 symchk.exe 실행에 필요한 최소 파일 [1]
12090정성태12/24/20191161.NET Framework: 871. .NET AnyCPU로 빌드된 PE 헤더의 로딩 전/후 차이점
12089정성태12/23/20191018디버깅 기술: 146. gflags와 _CrtIsMemoryBlock을 이용한 Heap 메모리 손상 여부 체크
... [16]  17  18  19  20  21  22  23  24  25  26  27  28  29  30  ...