<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p>Azureの利用方法を調べていると、唐突に「サービスプリンシパルで認証を行ってください」などの記述にぶつかり「さーびす...ぷりんしぱる...って何？」となることはありませんでしょうか？<br>
そしてAzureのポータルを探し回ってもどこにもサービスプリンシパルを作成できなさそうなメニューが見当たらず、ドキュメントを読んでも結局何をどうすればサービスプリンシパルができたことになるのかよく分からず困ったりしていませんでしょうか。</p>
<p>この記事では</p>
<ul>
<li>サービスプリンシパルとは何か</li>
<li>Azureの認証におけるサービスプリンシパルの位置づけ</li>
<li>サービスプリンシパルなどの作成方法</li>
</ul>
<p>などを簡潔にまとめ、「サービスプリンシパル」やAzureの認証で困っている人の助けになればと思っています。</p>
<h1 id="%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%83%97%E3%83%AA%E3%83%B3%E3%82%B7%E3%83%91%E3%83%AB%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B">
<a class="header-anchor-link" href="#%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%83%97%E3%83%AA%E3%83%B3%E3%82%B7%E3%83%91%E3%83%AB%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B" aria-hidden="true"></a> サービスプリンシパルとは何か</h1>
<ul>
<li>サービスプリンシパルとは: 「Azureでシステムが認証に使うためのID」です。一般のユーザーと同じようにAzureのロール（サブスクリプションの所有権とかVMの閲覧権とか）を持つことができ、サービスプリンシパルとして認証することでAzureのリソースの管理を行うことできます。（ポータルにはログインできません）</li>
</ul>
<p>ただ、システムの認証を行う手段についてはサービスプリンシパル以外にもマネージドIDがあります。</p>
<p>以下の表でどちらが必要かをご判断ください。</p>
<h1 id="azure%E3%81%AE%E8%AA%8D%E8%A8%BC%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%83%97%E3%83%AA%E3%83%B3%E3%82%B7%E3%83%91%E3%83%AB%E3%81%AE%E4%BD%8D%E7%BD%AE%E3%81%A5%E3%81%91">
<a class="header-anchor-link" href="#azure%E3%81%AE%E8%AA%8D%E8%A8%BC%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%83%97%E3%83%AA%E3%83%B3%E3%82%B7%E3%83%91%E3%83%AB%E3%81%AE%E4%BD%8D%E7%BD%AE%E3%81%A5%E3%81%91" aria-hidden="true"></a> Azureの認証におけるサービスプリンシパルの位置づけ</h1>
<table>
<thead>
<tr>
<th>認証主体</th>
<th>想定される利用方法</th>
<th>ポータルへのログイン可否</th>
<th>作成方法</th>
</tr>
</thead>
<tbody>
<tr>
<td>ユーザー</td>
<td>Azureを操作する人間</td>
<td>可能</td>
<td>AzureAD(Entra ID)※1でユーザーとして追加</td>
</tr>
<tr>
<td>マネージドID</td>
<td>Azureサービス</td>
<td>不可能</td>
<td>Azureリソースの詳細画面 &gt; 設定 &gt; IDから有効化</td>
</tr>
<tr>
<td>サービスプリンシパル</td>
<td>Azureと連携するシステム</td>
<td>不可能</td>
<td>AzureAD(Entra ID)の「アプリの登録」から登録</td>
</tr>
</tbody>
</table>
<p>おおむね以下のような考えに則って利用する認証主体を選択すればよいかと思います。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/28ad2864d7b8-20231114.png" loading="lazy" class="md-img"></p>
<p>マネージドIDはAzureによってよしなに（※2）管理される認証主体です。Azureを操作させたい対象がAzure上のサービス（例えば、VMにデータベースアクセスさせたい、AppServiceからBlobストレージに書き込みたいなど）である場合にはサービスプリンシパルではなくマネージドIDを使うのがおすすめです。</p>
<p>逆に、Azure外部のシステム（例えばオンプレミスやローカル、他クラウド上で動くWebサーバー）に権限を与えたい場合にはサービスプリンシパルをご利用ください。</p>
<p>※正確に言うとマネージドIDもサービスプリンシパルの一種なのですが、ここでは簡単のため割愛します</p>
<h1 id="%E5%90%84%E8%AA%8D%E8%A8%BC%E4%B8%BB%E4%BD%93%E3%81%AE%E4%BD%9C%E6%88%90%E6%96%B9%E6%B3%95">
<a class="header-anchor-link" href="#%E5%90%84%E8%AA%8D%E8%A8%BC%E4%B8%BB%E4%BD%93%E3%81%AE%E4%BD%9C%E6%88%90%E6%96%B9%E6%B3%95" aria-hidden="true"></a> 各認証主体の作成方法</h1>
<h3 id="%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> ユーザーの作成</h3>
<p>Azure AD (EntraID)で「管理」 &gt; 「ユーザー」 &gt; 「新しいユーザー」から追加します。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/31ada83a55d3-20231114.png" loading="lazy" class="md-img"></p>
<h3 id="%E3%83%9E%E3%83%8D%E3%83%BC%E3%82%B8%E3%83%89id%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#%E3%83%9E%E3%83%8D%E3%83%BC%E3%82%B8%E3%83%89id%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> マネージドIDの作成</h3>
<p>権限を付与したいAzureサービスのリソース詳細の設定 &gt; IDから追加します。<br>
大抵の場合、「システム割り当て済み」（※3）をオン＞保存でよいかと思われます。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/610f20f35994-20231114.png" loading="lazy" class="md-img"></p>
<h3 id="%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%83%97%E3%83%AA%E3%83%B3%E3%82%B7%E3%83%91%E3%83%AB%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%83%97%E3%83%AA%E3%83%B3%E3%82%B7%E3%83%91%E3%83%AB%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> サービスプリンシパルの作成</h3>
<p>AzureADの管理 &gt; 「アプリの登録」&gt;新規登録から追加 します。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/5040d7ff2003-20231114.png" loading="lazy" class="md-img"></p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/279a6717bd58-20231114.png" loading="lazy" class="md-img"></p>
<p>大変に分かりづらいポイントなのですが「サービスプリンシパル」≒「AzureADに登録されたアプリ」です（正確にはアプリに対応する形でサービスプリンシパルが払い出されるのですが操作としては一体化しています）。アプリ新規登録ではURL等の入力を求められますが、URLを持たないサービスであれば指定せず単に登録だけで問題ありません。URLはOAuth等のユーザー認証を行う場合にのみ必要になります</p>
<p>その後、使う用途に合わせて「証明書とシークレット」からクライアントシークレットや証明書を作成します。Azure CLIの場合にはシークレット、Azure SDKの場合には証明書が必要になります。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/245dbf91e69e-20231114.png" loading="lazy" class="md-img"></p>
<h1 id="%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E4%BB%98%E4%B8%8E%E6%96%B9%E6%B3%95">
<a class="header-anchor-link" href="#%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E4%BB%98%E4%B8%8E%E6%96%B9%E6%B3%95" aria-hidden="true"></a> ロールの付与方法</h1>
<p>3主体ともほぼ同じ手順となります。</p>
<p>これからアクセスしたい対象リソースの「アクセス制御(IAM)」から追加 &gt; ロール割り当ての追加から追加します。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/e81265bfd846-20231114.png" loading="lazy" class="md-img"></p>
<ol>
<li>付与したいロール &gt; 2. 付与したいメンバーの順に指定してロールを付与します。</li>
</ol>
<p>付与したいロールでは「ひとまず大きめの権限を与えてアクセスできるかだけ確認したい」場合には特権管理者ロールタブから共同作成者を選択してください。（のちに適宜必要最小限のロールへの変更を推奨します）</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/0964c30359ff-20231114.png" loading="lazy" class="md-img"></p>
<p>付与したいメンバーの選択では<br>
ユーザー・サービスプリンシパル・マネージドIDの選択をラジオボタン行った後に<br>
メンバーの選択を行ってください。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/710da3c3f3e0-20231114.png" loading="lazy" class="md-img"></p>
<h1 id="%E8%AA%8D%E8%A8%BC%E6%96%B9%E6%B3%95">
<a class="header-anchor-link" href="#%E8%AA%8D%E8%A8%BC%E6%96%B9%E6%B3%95" aria-hidden="true"></a> 認証方法</h1>
<p>様々な認証方法がありますが、例えばAzure CLIでの認証（ログイン）方法は以下となります。</p>
<p><a href="https://learn.microsoft.com/ja-jp/cli/azure/authenticate-azure-cli-interactively" target="_blank" rel="nofollow noopener noreferrer">ユーザーによるCLIログイン</a><br>
<a href="https://learn.microsoft.com/ja-jp/cli/azure/authenticate-azure-cli-managed-identity" target="_blank" rel="nofollow noopener noreferrer">マネージドIDによるCLIログイン</a><br>
<a href="https://learn.microsoft.com/ja-jp/cli/azure/authenticate-azure-cli-service-principal" target="_blank" rel="nofollow noopener noreferrer">サービスプリンシパルによるCLIログイン</a></p>
<p>ただし、マネージドIDについては対象リソース内でコマンドを打てば（ロールが適切に付与されていれば）明示的にログインしなくてもCLIが動作するはずです（リソースの外側で勝手にリクエストに認証子が付与されます）</p>
<h1 id="%E6%9C%80%E5%BE%8C%E3%81%AB">
<a class="header-anchor-link" href="#%E6%9C%80%E5%BE%8C%E3%81%AB" aria-hidden="true"></a> 最後に</h1>
<p>分からなかったことがあればコメント欄にどんどんご記載ください</p>
<hr>
<p>※1: Azure ADは2023/4にEntra IDに改称されました。しかし、現時点では多くのドキュメントでAzure ADに呼称が残っているため併記しました。同じものとお考え下さい。</p>
<p>※2: 「よしなに」具体的には鍵のローテーション更新をAzureが自動的にやってくれるなどが挙げられます。また、Azureリソースが別のAzureリソースにアクセスする際の認証プロセス自体もユーザーから見えないところで透過的に行ってくれます</p>


サービスプリンシパルって何？Azureの認証エンティティについて

サービスプリンシパルとは何か

Azureの認証におけるサービスプリンシパルの位置づけ

azure

Discussion