Azure DevOps
Azure Artifacts のプライベートフィードにある Babel Obfuscator の NuGet パッケージを参照し、Azure DevOps の Secure Files からライセンスを渡して、Azure Pipelines で Babel Obfuscator を実行します。
Azure Pipelines は .NET SDK でプロジェクトをビルドし、Babel.Obfuscator パッケージがそのビルドに Babel タスクを組み込みます。ビルドエージェントに Babel をインストールする必要はありません。ビルドツールはパッケージに含まれているため、パイプラインは、パッケージを置いたフィードに対して認証し、Babel にライセンスを渡すだけで済みます。
このページで使用するサンプルは、小さなコンソールアプリケーションです。
git clone https://github.com/babelfornet/devops-integration.gitパッケージを Azure Artifacts フィードに置く
Babel.Obfuscator パッケージは nuget.org では公開されていません。Ultimate エディションまたは Babel Licensing のサイトエディションと一緒に提供されます。このパッケージは、自分の組織だけが読み取れるプライベートフィードにプッシュしてください。
Babel Obfuscator のパッケージをパブリックフィードには決してプッシュしないでください。パッケージには Babel のビルドツールが含まれており、再公開するとライセンスの条件に違反します。
Azure DevOps で「Artifacts」を開き、Babel という名前のフィードを作成して、そこにパッケージをプッシュします。
dotnet nuget push Babel.Obfuscator.12.0.0.nupkg \
--source "https://pkgs.dev.azure.com/ORGANISATION/_packaging/Babel/nuget/v3/index.json" \
--api-key azソリューションと同じ場所に NuGet.config を追加し、自分のコンピューターとビルドエージェントの両方がこのフィードからパッケージを解決できるようにします。
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<clear />
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="babel" value="https://pkgs.dev.azure.com/ORGANISATION/_packaging/Babel/nuget/v3/index.json" />
</packageSources>
</configuration>このファイルには、意図的に資格情報を含めていません。開発者のコンピューターでは Azure Artifacts Credential Provider が一度だけ資格情報の入力を求め、パイプラインでは NuGetAuthenticate タスクがビルド ID のトークンを渡します。どちらの場合も、リポジトリにシークレットが書き込まれることはありません。
パッケージを参照する
アセンブリを難読化したいすべてのプロジェクトに、パッケージ参照を追加します。
<ItemGroup>
<PackageReference Include="Babel.Obfuscator" Version="12.0.0">
<PrivateAssets>all</PrivateAssets>
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>
</ItemGroup>PrivateAssets を指定すると、プロジェクトが生成するパッケージにこの参照が含まれなくなります。Babel はビルド時のツールであり、配布するアセンブリの依存関係ではないためです。
ライセンスを Secure Files に追加する
Pipelines → Library → Secure files を開き、署名済みの babel.licenses ファイルをアップロードします。Pipeline permissions でパイプラインを許可します。ジョブはファイルをダウンロードし、そのパスを MSBuild の BabelLicense プロパティに渡します。Azure DevOps はジョブの終了時にファイルのコピーを削除します。
Babel 12.3.0 ではファイルパスを使用してください。このバージョンでは、env:BABEL_LICENSE 経由で渡した有効な XML ライセンスが拒否されることがあります。XML 本体はリポジトリ、コマンドライン、MSBuild のプロパティ値に含めないでください。
パイプライン
完全な azure-pipelines.yml は、Ubuntu エージェントで実行されます。このパイプラインでは、.NET SDK のインストール、Babel フィードへの認証、ソリューションの復元とビルドを行い、難読化された出力をパイプラインの成果物として公開します。
trigger:
- main
pool:
vmImage: ubuntu-latest
variables:
buildConfiguration: Release
steps:
- task: UseDotNet@2
displayName: Install the .NET SDK
inputs:
version: 10.0.x
- task: NuGetAuthenticate@1
displayName: Authenticate to the Babel feed
- script: dotnet restore DevOpsIntegration.sln
displayName: Restore
- task: DownloadSecureFile@1
name: babelLicense
displayName: Download the Babel license
inputs:
secureFile: 'babel.licenses'
- script: dotnet build DevOpsIntegration.sln --configuration $(buildConfiguration) --no-restore "-p:BabelLicense=$(babelLicense.secureFilePath)"
displayName: Build and obfuscate
- task: PublishPipelineArtifact@1
displayName: Publish the obfuscated output
inputs:
targetPath: DevOpsIntegration/bin/$(buildConfiguration)/net10.0
artifact: DevOpsIntegrationプライベートフィードにアクセスできるようにしているのは NuGetAuthenticate@1 です。このタスクはパイプライン自身の ID で資格情報プロバイダーを構成するため、上の NuGet.config には packageSourceCredentials セクションも、自分のトークンも必要ありません。
パイプラインで docker build を実行する場合は、DownloadSecureFile@1 が返すパスを Docker のビルドシークレット の入力に指定します。
難読化は dotnet build の一部として実行され、Babel 用の独立したステップはありません。Babel のログはビルド出力に表示され、ライセンスまたは構成のエラーがあるとステップは失敗します。
ビルドエージェントのイメージに必要なのは、.NET SDK を実行できることだけです。ubuntu-latest は最も安価な選択肢で、どのターゲットランタイムにも使えます。Babel は IL を処理するため、Linux のビルドエージェントでも Windows 向けのアセンブリを難読化できます。.NET Framework のターゲット、WPF、Windows Forms のように、ビルドそのものに Windows が必要な場合は windows-latest を使用してください。
難読化を設定する
Babel は、プロジェクトファイルの MSBuild プロパティで設定します。よくある構成は、ローカルでのデバッグが通常どおり動作するように Debug ビルドには手を加えず、Release ビルドを保護するものです。
<PropertyGroup Condition="'$(Configuration)' == 'Debug'">
<BabelEnabled>false</BabelEnabled>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
<StringEncryption>stream</StringEncryption>
<ControlFlowObfuscation>if=on;goto=on;switch=on;case=on;call=on</ControlFlowObfuscation>
<ControlFlowIterations>3</ControlFlowIterations>
<ResourceEncryption>true</ResourceEncryption>
</PropertyGroup>すべてのプロパティはパッケージリファレンスに一覧があり、それらが Babel の機能にどう対応するかは難読化の設定で説明しています。
アセンブリ全体に対する切り替えよりも細かく制御するには、ルールファイルを追加します。次のルールは、短いメソッドには制御フロー難読化を適用しないようにします。短いメソッドでは、フラット化のコストが隠蔽の効果を上回るためです。
<?xml version="1.0" encoding="utf-8" ?>
<Rules>
<Rule name="reduce control flow" feature="control flow" exclude="false" applyToMembers="true">
<Target>Classes,Structures</Target>
<Pattern>*</Pattern>
<Properties>
<MaxSwitchTargets>5</MaxSwitchTargets>
<MinInstructionCount>18</MinInstructionCount>
<UseValueEncryption>false</UseValueEncryption>
</Properties>
<Description>Do not scramble methods with few instructions.</Description>
</Rule>
</Rules>BabelRules プロパティで、ビルドにこのファイルを指定します。
<PropertyGroup>
<BabelRules>$(MSBuildThisFileDirectory)babelRules.xml</BabelRules>
</PropertyGroup>結果の確認
パイプラインの成果物をダウンロードし、アセンブリが難読化されているものと思い込まずに、実際に難読化されていることを確認してください。Babel による難読化の検出のサンプルは、これを自動的にテストする方法を示しています。このテストはゲートとしてパイプラインに追加する価値があります。そうしないと、ライセンスの設定ミスやビルドステップのスキップがあっても、何も失敗しないまま難読化されていないアセンブリが配布されてしまいます。
本番環境から届くスタックトレースをデコードする予定がある場合は、ビルドで生成されたマップファイルを保管しておいてください。スタックトレースのデコードを参照してください。