Microsoft Foundry のロールベースのアクセス制御

この記事では、スコープ、組み込みロール、一般的なエンタープライズ割り当てパターンなど、Microsoft Foundry の主要なロールベースのアクセス制御 (RBAC) の概念について説明します。

Microsoft Foundry での認証と承認の詳細については、「認証と承認を参照してください。

開始するための最低限の役割の割り当て

AzureとMicrosoft Foundryの新規ユーザーは、ユーザープリンシパルとプロジェクトマネージドIDの両方がFoundryの機能にアクセスできるように、まずこれらの最小限の割り当てから始めてください。

現在の割り当てを確認するには、単一のAzure リソースへのユーザーのアクセス権を確認。

• Foundry リソースの Foundry ユーザー ロールをユーザー プリンシパルに割り当てます。

  Important

  Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。

• Foundry リソースの Foundry ユーザー ロールをプロジェクトのマネージド ID に割り当てます。

プロジェクトを作成したユーザーがロールを割り当てることができる場合 (たとえば、サブスクリプションまたはリソース グループ スコープでAzure所有者ロールを持つなど)、Microsoft Foundry ポータル UI を使用してプロジェクトが作成されると、両方の割り当てが自動的に追加されます。

これらのロールを手動で割り当てるには、次の簡単な手順を使用します。

ユーザー プリンシパルにロールを割り当てる

Azure ポータルで Foundry リソースを開き、Access コントロール (IAM) に移動します。 Foundry User のロールの割り当てを作成し、[メンバー] を [ユーザー]、[グループ]、またはサービス プリンシパルに設定し、ユーザー プリンシパルを選択して、[確認と割り当て] を選択します。

プロジェクトのマネージド ID にロールを割り当てる

Azure ポータルで Foundry プロジェクトを開き、Access control (IAM) に移動します。 Foundry User のロールの割り当てを作成し、[メンバー] を [マネージド ID] に設定し、プロジェクトのマネージド ID を選択して、[確認と割り当て] を選択します。

Foundry でのロールベースのアクセス制御の用語

Microsoft Foundry のロールベースのアクセス制御を理解するには、企業に関する 2 つの質問を検討してください。

• Microsoft Foundry でビルドするときにチームにどのようなアクセス許可を付与しますか?
• どの範囲でチームにアクセス許可を割り当てたいですか?

これらの質問に答えるために、この記事全体で使用される用語の説明を次に示します。

• アクセス許可: コントロール プレーン操作とデータ プレーン操作の両方の読み取り、書き込み、削除、管理など、ID がリソースに対して実行できるアクションを許可または拒否しました。
• Scope: ロールの割り当てが適用されるAzure リソースのセット。 一般的なスコープには、サブスクリプション、リソース グループ、Foundry リソース、Foundry プロジェクト、または個々のエージェントが含まれます。
• Role: 特定のスコープでAzureリソースに対して実行できるアクションを定義するアクセス許可の名前付きコレクション。

ID は、エンタープライズ要件に基づいて、選択したスコープで特定のアクセス許可を持つロールを取得します。

Microsoft Foundry では、ロールの割り当てを完了するときに、次のスコープを考慮してください。

• Foundry リソース: Microsoft Foundry 環境の管理、セキュリティ、監視の境界を定義する最上位レベルのスコープ。
• Foundry プロジェクト: Foundry リソース内のサブスコープ。Foundry API、ツール、および開発者ワークフローの作業を整理し、アクセス制御を適用するために使用されます。
• エージェント: 個々のエージェントに適用される Foundry プロジェクト内のより狭いスコープ。 このスコープでのロールの割り当ては現在、エージェント エンドポイント アクセスに対してのみ評価されるため、このスコープを使用して、プロジェクト内のすべてのエージェントへのエンドポイント アクセスを許可せずに、特定のエージェントのエンドポイントへのアクセスを許可します。 詳細については、「エージェント スコープのロール割り当て」を参照してください。

組み込みロール

Foundry の組み込みロールは、チーム メンバーに割り当てることができる一般的なアクセス シナリオをカバーするMicrosoftによって作成されたロールです。 Azure全体で使用される主要な組み込みロールには、所有者、共同作成者、閲覧者が含まれます。 これらのロールは、Foundry リソースのアクセス許可に固有ではありません。

Foundry リソースの場合は、追加の組み込みロールを使用して、最小特権アクセス原則に従います。 次の表に、Foundry の主要な組み込みロールと、AI + Machine Learning 組み込みロールの正確なロール定義へのリンクを示します。

個々のエージェントにロールを割り当てる方法の詳細については、「 エージェントスコープロールの割り当て」を参照してください。

各組み込みロールの権限

次の表を使用して、Microsoft Foundry の組み込みロールごとに許可されているアクセス許可を確認します。

次の表を使用して、組み込みロール (所有者、共同作成者、閲覧者) Azureキーごとに許可されているアクセス許可を確認します。

エージェントを公開するには、Foundry リソース スコープで少なくとも Foundry Project Manager ロールが必要です。 詳細については、「Microsoft Foundry の Agent アプリケーション」を参照してください。

これらのタブを使用して、Foundry リソース レベルで割り当てられた組み込みロールの違いを調べることができます (サブスクリプション レベルで割り当てられている所有者を除く)

プロジェクトのエンタープライズ RBAC マッピングのサンプル

Enterprise Foundry リソースのロールベースのアクセス制御 (RBAC) を実装する方法の例を次に示します。

ロールの割り当てを管理する

Foundry でロールを管理するには、Azureでロールを割り当てたり削除したりするためのアクセス許可が必要です。 Azure組み込みの Owner ロールには、そのアクセス許可が含まれています。 Foundry ポータル ([管理] ウィンドウ)、Azureポータル IAM、またはAzure CLIを使用してロールを割り当てることができます。 ロールは、Azure ポータルの IAM または Azure CLI を使用して削除できます。

az role assignment create --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" --assignee "joe@contoso.com" --scope /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/this-rg 

PROJECT_SCOPE="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.CognitiveServices/accounts/<accountName>/projects/<projectName>"

az role assignment create \
    --assignee-object-id "<principalId>" \
    --assignee-principal-type ServicePrincipal \
    --role "eed3b665-ab3a-47b6-8f48-c9382fb1dad6" \
    --scope "$PROJECT_SCOPE"

エージェント スコープのロールの割り当て

プロジェクト全体ではなく、特定のエージェントのスコープでロールを割り当てます。 この方法では、プロジェクト内のすべてのエージェントへのエンドポイント アクセスを許可せずに、1 つのエージェントへのエンドポイント アクセスを許可できます。 エージェントのスコープ URI は、次のパターンに従います。

/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.CognitiveServices/accounts/<accountName>/projects/<projectName>/agents/<agentName>

たとえば、次のコマンドは、Foundry Agent Consumer ロール (ロール定義 ID eed3b665-ab3a-47b6-8f48-c9382fb1dad6) を、特定のエージェントのスコープでサービス プリンシパルに割り当てます。

AGENT_SCOPE="/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.CognitiveServices/accounts/<accountName>/projects/<projectName>/agents/<agentName>"

az role assignment create \
    --assignee-object-id "<principalId>" \
    --assignee-principal-type ServicePrincipal \
    --role "eed3b665-ab3a-47b6-8f48-c9382fb1dad6" \
    --scope "$AGENT_SCOPE"

エージェント スコープのロール割り当てのしくみは、プロジェクト スコープの割り当てと同じAzure RBAC モデルに従います。 プロジェクト スコープで割り当てることができるロールは、エージェント スコープでも割り当てることができます。 ただし、エージェント スコープでは、ロールの割り当ては現在、エージェント エンドポイント アクセスに対してのみ評価され、より広範なコントロール プレーンまたは管理アクセス許可は付与されません。

プロジェクトのカスタム ロールを作成する

組み込みロールがエンタープライズ要件を満たしていない場合は、許可されたアクションとスコープを正確に制御できるカスタム ロールを作成します。 サブスクリプション レベルのカスタム ロール定義の例を次に示します。

{
  "properties": {
    "roleName": "My Enterprise Foundry User",
    "description": "Custom role for Foundry at my enterprise to only allow building Agents. Assign at subscription level.",
    "assignableScopes": ["/subscriptions/<your-subscription-id>"],
    "permissions": [ { 
        "actions": ["Microsoft.CognitiveServices/*/read", "Microsoft.Authorization/*/read", "Microsoft.CognitiveServices/accounts/listkeys/action","Microsoft.Resources/deployments/*"], 
        "notActions": [], 
        "dataActions": ["Microsoft.CognitiveServices/accounts/AIServices/agents/*"], 
        "notDataActions": []     
    } ]
  }
}

カスタム ロールの作成の詳細については、次の記事を参照してください。

• Azure Portal
• Azure CLI
• Azure PowerShell
• Microsoft Foundry でプレビュー機能を無効にする。 この記事では、カスタム ロールを構築するときに使用できる、コントロールとデータ プレーン全体にわたる Foundry の特定のアクセス許可について詳しく説明します。

注意事項と制限事項

• 削除された Foundry アカウントを表示および消去するには、サブスクリプション スコープで共同作成者ロールが割り当てられている必要があります。

• 共同作成者ロールを持つユーザーは、Foundry でモデルをデプロイできます。

• リソースにカスタム ロールを作成するには、リソースのスコープに対する所有者ロールが必要です。

• Azureでロールを割り当てるアクセス許可 (アカウント スコープで割り当てられた所有者ロールなど) をユーザー プリンシパルに割り当て、Azure ポータルまたは Foundry ポータル UI から Foundry リソースをデプロイすると、Foundry ユーザー ロールがユーザー プリンシパルに自動的に割り当てられます。 SDK または CLI から Foundry をデプロイする場合、この割り当ては適用されません。

  Important

  Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。

• Foundry リソースを作成すると、組み込みのロールベースのアクセス制御 (RBAC) アクセス許可によってリソースにアクセスできるようになります。 Foundry の外部で作成されたリソースを使用するには、リソースにアクセスできるアクセス許可があることを確認します。 次に例をいくつか示します。

  • 新しいAzure Blob Storage アカウントを使用するには、Foundry アカウント リソースのマネージド ID を、そのストレージ アカウントのストレージ BLOB データ閲覧者ロールに追加します。
  • 新しいAzure AI 検索 ソースを使用するには、foundry を Azure AI 検索 ロールの割り当てに追加します。

• Foundry でモデルを微調整するには、データ プレーンとコントロール プレーンの両方の権限が必要です。 微調整されたモデルをデプロイする場合は、コントロール プレーン アクセス許可。 そのため、データ プレーンとコントロール プレーンの両方のアクセス許可を持つ組み込みロールは Foundry 所有者 ロールだけです。 または、必要に応じて、データ プレーンのアクセス許可に Foundry ユーザー ロールを割り当て、コントロール プレーンのアクセス許可に Foundry アカウント所有者 ロールを割り当てることもできます。

展開の種類固有のアクセス許可

以下のセクションでは、特定のデプロイの種類におけるアクセス許可の適用範囲について説明します。 特定のワークロードのロール割り当てを計画する際は、各組み込みロールのアクセス許可にある組み込みロールの表と併せてそれらを使用してください。

マネージド コンピュート コントロール プレーン オペレーション

管理されたコンピューティング デプロイ (プレビュー) は、Microsoft.CognitiveServices プロバイダーに基づく独自のAzure リソース プロバイダー操作のセットによって制御されます。 これらの操作は、マネージド コンピューティング デプロイを作成、読み取り、更新、削除できるユーザーと、Foundry アカウントで使用可能なアクセラレータの容量とクォータの使用状況を読み取ることができるユーザーを制御します。

このセクションでは、必須の 5 つのコントロール プレーン操作、それらの操作を許可する組み込みロール、およびロールとアクセス許可の対応関係が標準デプロイ (従量課金トークン方式および PTU) とどのように異なるかを一覧表示します。

必要な操作

Foundry アカウントでマネージド コンピューティング デプロイを完全に管理するには、次の 5 つの操作が必要です。

ロールと権限の対応付け

次の表に、5 つのマネージド コンピューティング コントロール プレーン操作のそれぞれに付与する組み込みロールを示します。

Azure組み込みの Owner ロールと Contributor ロールは、サブスクリプションまたはリソース グループに対するワイルドカード アクション付与を通じて、5 つの操作すべてを許可します。

比較: 標準デプロイとマネージド コンピューティング デプロイ

マネージド コンピューティングデプロイのコントロール プレーンアクセス許可サーフェイスは、標準 (トークンごとの支払いおよび PTU) デプロイの表面を反映しています。操作名は、リソースの種類セグメント (deployments と managedComputeDeployments、 modelCapacities と managedComputeCapacities) によってのみ異なります。

次の表は、各ロールの CRUD カバレッジが 2 つのデプロイ ファミリ間でどのように比較されるかをまとめたものです。

推奨されるロールの割り当て

マネージド コンピューティングでこれらの操作へのアクセスを割り当てるときは、次の開始点を使用します。

• マネージド コンピューティング デプロイのデプロイと運用: Foundry アカウント スコープに Cognitive Services 共同作成者 を割り当てます。
• デプロイとクォータの読み取り専用ビューアー: Foundry アカウント スコープに Cognitive Services ユーザー または Foundry ユーザー を割り当てます。
• Foundry projectを管理しますが、モデルはデプロイしません: Foundry アカウント スコープに Foundry Project Manager を割り当てます。 Projectマネージャーはデプロイとクォータを読み取ることができますが、作成または削除することはできません。
• 推論時にMicrosoft Entra IDを使用してマネージド コンピューティングデプロイを呼び出します: Foundry アカウント スコープにFoundry Userを割り当てます。また、ユーザーが保持するコントロール プレーン ロール (または推論専用ユーザーの場合は、コントロール プレーン ロールはまったくありません) を割り当てます。

エンド ツー エンドのデプロイ ワークフローについては、「 マネージド コンピューティングを使用してオープンソース モデルをデプロイする」を参照してください。

関連コンテンツ

• Microsoft Foundry での特権ロールが必要なタスク — ロールの割り当てやエージェント インフラストラクチャを含む、すべての管理タスクに必要なロール。
• プロジェクトを作成します。
• 1 つのAzure リソースに対するユーザーのアクセスを確認します。
• Foundry での認証と承認。
• Microsoft Foundry でプレビュー機能を無効にする。
• ホストされるエージェントのアクセス許可のリファレンス。

付録

アクセス分離の例

企業内のユーザー ペルソナに応じて、組織ごとに異なるアクセス分離要件がある場合があります。 アクセスの分離とは、組み込みロールを使用したアクセス許可の分離または一元化された高度に制限されたロールに対して、どのロールの割り当てが企業のどのユーザーに付与されるかを指します。 Foundry には、アクセス分離の要件に応じて組織に対して選択できる 3 つのアクセス分離オプションがあります。

アクセスの分離はありません。 つまり、企業では、開発者、プロジェクト マネージャー、または管理者の間でアクセス許可を分離する要件はありません。これらのロールのアクセス許可は、チーム間で割り当てることができます。

そのため、次の手順を行う必要があります。

• 組織内のすべてのユーザーに、リソース スコープで Foundry Owner ロールを付与する

  Important

  Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。

部分的なアクセスの分離。 つまり、企業のプロジェクト マネージャーは、プロジェクト内で開発し、プロジェクトを作成できる必要があります。 ただし、管理者は Foundry 内で開発することはできず、Foundry プロジェクトとアカウントのみを作成する必要があります。

そのため、次の手順を行う必要があります。

• 管理者に対し、リソース範囲で Foundry アカウント所有者権限を付与する
• リソースに対する Foundry Project Manager ロールを開発者とprojectマネージャーに付与する

フルアクセス隔離 つまり、管理者、プロジェクト マネージャー、開発者には、企業内のさまざまな機能に重複しない明確なアクセス許可が割り当てられます。

そのため、次の手順を行う必要があります。...

• リソース スコープで Foundry アカウント所有者 を管理者に付与する
• 開発者に Foundry リソース スコープの 閲覧者 ロールを付与し、プロジェクト スコープで Foundry ユーザー に付与する
• プロジェクト マネージャーに、リソース スコープで Foundry Project Manager ロールを付与してください
• プロジェクト スコープ (またはエージェントごとの制御のエージェント スコープ) に対する Foundry Agent Consumer ロールをエージェント コンシューマーに付与する

Foundry で Microsoft Entra グループを使用する

Microsoft Entra IDには、リソース、アプリケーション、タスクへのアクセスを管理するいくつかの方法が用意されています。 Microsoft Entra グループを使用すると、個々のユーザーではなく、ユーザーのグループにアクセスとアクセス許可を付与できます。 エンタープライズ IT 管理者は、Azure ポータルでMicrosoft Entra グループを作成して、開発者のロールの割り当てプロセスを簡略化できます。 Microsoft Entra グループを作成するときに、Foundry プロジェクトで作業する新しい開発者に必要なロールの割り当ての数を最小限に抑えるには、グループに必要なロールの割り当てを必要なリソースに割り当てます。

Foundry で Microsoft Entra ID グループを使用するには、次の手順を実行します。

1. Azure ポータルの Groups に Security グループを作成します。
2. 共有アクセスが必要な所有者とユーザー プリンシパルを組織内に追加します。
3. ターゲット リソースを開き、 アクセス制御 (IAM) に移動します。
4. 必要なロールを ユーザー、グループ、またはサービス プリンシパルに割り当てて、新しいセキュリティ グループを選択します。
5. ロールをグループのすべてのメンバーに割り当てるには、[確認と割り当て] を選択してください。

一般的な例:

• エージェントを構築し、トレースを実行し、主要な Foundry 機能を使用するには、Microsoft Entra グループに Foundry User を割り当てます。
• より広範な開発アクセス権を持たないエージェントとの対話を許可するには、Foundry Agent Consumer を Microsoft Entra グループに割り当てます。
• トレース機能と監視機能を使用するには、接続されている Application Insights リソースの 閲覧者 を同じグループに割り当てます。

Microsoft Entra ID グループ、前提条件、および制限事項の詳細については、以下を参照してください。

• グループ、グループ メンバーシップ、Microsoft Entra。
• Microsoft Entra。