Entra ID のサービスプリンシパル:ベストプラクティスとよくある問題
By Mirko Peters ·
サービスプリンシパルとは何か、アプリの登録とどう違うのか、そして Microsoft が文書化しているセキュリティのプラクティス(マネージド ID、証明書、最小特権、所有者、既知の落とし穴)を解説します。
Automatically translated with AI from the original post. Read the English original
サービスプリンシパルとは、Microsoft Entra テナント内でアプリケーションが使用する ID のことです。そのテナント内でアプリがアクセスできる範囲を定義します。Microsoft が文書化しているセキュリティのプラクティスは簡潔にまとめられています。マネージド ID を優先し、シークレットを避け、最小特権を付与し、所有者を制限し、それらすべてを定期的に確認することです。
重要なポイント
- アプリケーション オブジェクトは、ホーム テナントにあるグローバルな設計図です。サービスプリンシパルは各テナントにあるローカルなインスタンスで、そのテナントでアプリが何をできるかを定義します。
- Microsoft は資格情報を推奨度の高い順に並べています。マネージド ID、フェデレーted 資格情報、証明書の順です。シークレット(パスワード)は使用しないよう求めています。
- 必要最小限の許可のみを要求し、アプリのみのアクセスよりも委任されたアクセスを優先し、アプリがもはや必要としないアクセス許可は削除してください。
- 所有者は必要最小限に留め、所有者の一覧を数か月ごとに確認し、サービスプリンシパルごとに少なくとも 2 人の所有者を置いてください。
- 削除されたアプリとサービスプリンシパルは最大 30 日間復元できます。管理者ではないユーザーが作成できるアプリとサービスプリンシパルのオブジェクトは最大 250 個までで、削除済みのものも含まれます。
本記事は、アプリケーション オブジェクトとサービスプリンシパル オブジェクト、アプリの登録のセキュリティ、アプリの削除と復元に関する Microsoft Learn のページに基づいています。それらのページの内容が食い違っている場合や記載がない場合は、その旨を明記しています。
アプリケーション オブジェクトとサービスプリンシパルの違い
Microsoft では次の 2 つのオブジェクトについて説明しています。
- アプリケーション オブジェクト。アプリのグローバルな表現です。アプリが登録されたテナント(ホーム テナント)に存在します。そこから作成されるサービスプリンシパルの設計図のような役割を果たします。
- サービスプリンシパル。1 つのテナントにおけるアプリのローカルな表現です。そのテナントでアプリのアクセス ポリシーとアクセス許可を定義するセキュリティ プリンシパルです。
シングル テナント アプリには、ホーム テナントに 1 つのサービスプリンシパルがあります。マルチテナント アプリには、ホーム テナントの 1 つに加え、アプリへの同意が行われた各テナントにそれぞれ 1 つずつあります。ポータルでアプリを登録すると、両方のオブジェクトが作成されます。Microsoft Graph で登録する場合は、サービスプリンシパルの作成は別の手順になります。
アプリケーション オブジェクトへの変更は、ホーム テナントのサービスプリンシパルにのみ反映されます。他のテナントのサービスプリンシパルには伝播しません。
サービスプリンシパルの 3 つの種類
| 種類 | リンクされたアプリ オブジェクト | 編集できますか | |---|---|---| | アプリケーション | はい | アプリ オブジェクトで管理され、テナント固有の設定があります | | マネージド ID | いいえ | アクセス許可を付与できますが、直接変更はできません | | レガシ | いいえ | 資格情報や応答 URL などの編集可能なプロパティがあります |
レガシ サービス プリンシパルは、作成されたテナントでのみ使用されます。Microsoft Graph では、種類は servicePrincipalType プロパティとして表示されます。リファレンスには、これら 3 つ以外の値も記載されており、エージェント ID を表す ServiceIdentity や、内部用の SocialIdp などが含まれます。Microsoft Graph の公式ドキュメントによると、対応するアプリ登録が存在しない Application サービス プリンシパルにはトークンが発行されません。
文書化された方法で作成する
- 少なくとも Cloud Application Administrator の権限を持つアカウントで Microsoft Entra 管理センターにサインインします。
- Entra ID > アプリの登録 に移動し、新規登録 を選択します。
- 名前を入力し、アプリが単一テナント向けの場合は この組織のディレクトリのみのアカウント を選択します。
- 登録 を選択します。サービス プリンシパルが自動的に作成されます。
その後、アクセス許可、同意、サインイン情報を管理するには エンタープライズ アプリケーション を使用します。Azure へのアクセスについては、同じページでサブスクリプション、リソース グループ、またはリソース スコープでロールを割り当てる方法が説明されており、下位のスコープにはアクセス許可が継承されます。動作する最も狭いスコープを選ぶのは一般的な最小特権の原則であり、そのページで要求されているものではありません。
Microsoftのベスト プラクティス
適切な ID の種類を選ぶ
サービスが Azure で実行され、ユーザーのサインインを行わず、Web API ではなく、複数テナントを必要としない場合は、アプリ登録の代わりにマネージド ID を検討してください。
資格情報の優先順位
Microsoft は、優先度の高いものから低いものの順にオプションを挙げています。ただし、このページでは正式なランキングとは呼んでいません。
- 資格情報としてのマネージド ID。資格情報の管理が不要になるため、Microsoft は強く推奨しています。
- 信頼できるプラットフォームからのフェデレーション資格情報。Microsoft は慎重に扱うよう助言しており、信頼できるプラットフォームからのみフェデレーション資格情報を構成するよう求めています。
- 証明書。Azure Key Vault などのキー コンテナーに保存し、信頼された証明機関が発行したものを優先してください。
- シークレット。ページには次のように記載されています。「"パスワード資格情報を使用しないでください。"」
同じページの関連ルールは次のとおりです。アプリケーション管理ポリシーを使ってシークレットの有効期間を制限するか、シークレットをブロックします。パブリック クライアントやインストール済みクライアントに資格情報を配置しません。資格情報は頻繁にロールオーバーします。資格情報をアプリ間で共有しません。1 つのアプリに多数の資格情報を持たせないようにします。また、ビルド パイプラインで資格情報スキャナーを使用し、資格情報がリポジトリに残らないようにすることも推奨しています。このページには、ローテーションの具体的な間隔は示されていません。
リダイレクト URI を適切に管理する
すべてのリダイレクト URI の所有者を明確にし、その背後にある DNS レコードを監視し、ワイルドカードや http などの安全でないスキームを避け、リストを絞り込んでください。ページによると、いずれかの URI の所有権が失効すると、アプリケーションが侵害される可能性があります。
アクセス許可を制限する
必要最小限のアクセス許可だけを要求し、アクセス許可を定期的に見直して、アプリがもう必要としないものは削除します。可能な限り、アプリ専用アクセスよりも委任アクセスを優先してください。
インスタンスをロックし、所有者を制限する
テナント管理者は任意のテナントでサービス プリンシパルをカスタマイズできるため、アプリ所有者が管理すべき資格情報などの予期しない変更が加えられる可能性があります。Microsoft は、アプリ インスタンス プロパティ ロックを構成し、利用可能な機密プロパティをすべてロックすることを推奨しています。これは、マルチテナント アプリでは特に重要です。
アプリケーションの所有者は、必要最小限の人数に限定してください。管理者は所有者の一覧を数か月ごとに 1 回見直すべきです。Microsoft Entra のアクセス レビューを使うと、この作業を自動化できます。Microsoft Graph のリファレンスでは、サービス プリンシパルごとに少なくとも 2 人の所有者を置くことも推奨されています。
識別子 URI を正しく使用する
v1.0 トークンを受け取るアプリでは、既定の URI である api://<appId> と api://<tenantId>/<appId> のみを使用してください。v2.0 トークンの場合は、api://<appId> の形式が推奨されます。この値はテナント内で一意である必要があり、末尾にスラッシュを付けてはいけません。カスタム識別子 URI を持つリソース アプリでは、v2.0 のアクセス トークン形式を使用してください。
よくある問題と公式ドキュメントの記載内容
サインインの追跡が難しい。 Entra には、ユーザーのサインインとは別に、サービス プリンシパルとマネージド ID 用のサインイン ログがあります。少なくとも Reports Reader のロールを持つ状態で Microsoft Entra 管理センターを開き、Entra ID > 監視と正常性 > サインイン ログ に移動します。私が参照したページには、サービス プリンシパルのサインインがどのタブに表示されるかは書かれていません。
アプリがトークンを取得できなくなる。 まず、アプリの登録がまだ存在するか確認します。次に、サービス プリンシパルの accountEnabled と appRoleAssignmentRequired プロパティを確認します。accountEnabled が false の場合は、割り当てられていてもユーザーはサインインできません。appRoleAssignmentRequired が true の場合は、先にアプリ ロールの割り当てが必要です。
作成時にクォータ エラーが出る。 管理者以外のユーザーが作成できるアプリとサービス プリンシパルの合計は 250 までです。アクティブなオブジェクトと復元可能な削除済みオブジェクトの両方がカウントされ、削除済みアイテム コンテナーから完全に削除したときにのみクォータが解放されます。
復元しても、すべてが元に戻らなかった。 Learn には 2 つの記述があります。アプリ オブジェクトのページでは、「アプリの登録」UI でアプリケーション オブジェクトを復元しても、そのサービス プリンシパルは復元されないとされています。一方、削除と回復に関する FAQ では、両方が削除されていた場合、アプリの登録を復元するとサービス プリンシパルも復元されるとされています。復元後は必ず結果を確認してください。また、FAQ によると、サービス プリンシパル ポリシーは回復できないため再構成が必要であり、プロビジョニング データが再表示されるまでに 40 分から 1 日かかる場合があります。
アプリは削除ではなく一時停止したい。 Learn ではアプリケーションの非アクティブ化について説明しています。非アクティブ化すると新しいトークンの発行が停止しますが、調査や後日の再アクティブ化のためにオブジェクトは保持されます。
簡単なレビューのルーチン
- シークレットを持つアプリを一覧にし、証明書またはマネージド ID に移行します。
- 誰も使用していないアクセス許可を削除します。
- 所有者と有効期限を確認します。
- リダイレクト URI のドメインが自社のものであることを確認します。
- 未使用のアプリについて、サービス プリンシパルのサインイン ログを確認します。
関連情報
データソース
- Microsoft Learn: Microsoft Entra ID のアプリケーション プロパティに関するセキュリティのベスト プラクティス
- Microsoft Learn: Microsoft Entra ID のアプリケーション オブジェクトとサービス プリンシパル
- Microsoft Learn: Microsoft Entra アプリの登録とサービス プリンシパルの作成
- Microsoft Learn: アプリケーションとサービス プリンシパルの削除と回復
- Microsoft Learn: servicePrincipal リソースの種類 (Microsoft Graph)
- Microsoft Learn: Microsoft Entra ID のサインイン ログ
FAQ
アプリの登録とサービスプリンシパルの違いは何ですか?
Microsoft Learn によると、アプリケーション オブジェクト(アプリの登録)はアプリのグローバルな表現であり、ホーム テナントに存在します。サービスプリンシパルは特定のテナントにおけるローカルな表現で、そのテナントでのアクセス ポリシーとアクセス許可を定義します。ポータルでアプリを登録すると、ホーム テナントに両方が作成されます。
サービスプリンシパルにはクライアント シークレットと証明書のどちらを使うべきですか?
Microsoft のセキュリティ ガイダンスでは、最も推奨されるのがマネージド ID、次に信頼できるプラットフォームからのフェデレーted 資格情報、どちらも使えない場合に証明書資格情報とされています。シークレットとも呼ばれるパスワード資格情報は使用しないよう求めています。
サービスプリンシパルではなくマネージド ID を使うべきなのはどのような場合ですか?
Microsoft Learn は 4 つの条件を挙げています。サービスが Azure 上で実行されること、ユーザーのサインインを行わないこと、Web API リソースとして動作しないこと、複数のテナントで実行する必要がないことです。4 つすべてに当てはまる場合は、マネージド ID を検討してください。マネージド ID はそれ自体がサービスプリンシパルの一種で、直接編集することはできません。
削除されたサービスプリンシパルを復元できますか?
Microsoft Learn の削除と復元に関する FAQ によると、論理削除されたアプリケーションとサービスプリンシパルは最大 30 日間復元でき, その後は完全に削除されます。アプリの登録は Microsoft Entra 管理センターで復元します。サービスプリンシパルは、削除されたサービスプリンシパルが管理センターに表示されないため、PowerShell または Microsoft Graph で復元します。
アプリを作成する際に Directory_QuotaExceeded エラーが表示されるのはなぜですか?
Learn の FAQ によると、管理者ではないユーザーが作成できるアプリケーションとサービスプリンシパルは最大 250 個までで、有効なオブジェクトと復元可能な削除済みオブジェクトの両方がカウントされます。オブジェクトを削除しただけではクォータは自動的に解放されません。削除済みアイテムのコンテナーから完全に削除する必要があります。