Azure AI 検索でマネージド ID を使用して接続するように検索サービスを構成する

[アーティクル]
11/22/2024

重要

ユーザー割り当てマネージド ID の割り当ては、追加の使用条件のもとでパブリックプレビュー段階にあります。 Management プレビュー REST API は、Azure AI 検索のユーザー割り当てマネージド ID の割り当てを提供します。 "システム割り当て" マネージド ID のサポートは一般提供されています。

Azure AI 検索から、インデックス作成またはクエリ中にデータ、応用 AI、またはベクター化を提供するリソースへの送信接続には、Microsoft Entra ID とロールの割り当てを使用できます。

送信接続に対してロールを使用するには、まず、Microsoft Entra テナント内で検索サービスのセキュリティプリンシパルとして、システム割り当てまたはユーザー割り当てマネージド ID のいずれかを使用するように検索サービスを構成します。マネージド ID を取得したら、承認されたアクセスのロールを割り当てることができます。マネージド ID とロールの割り当てにより、接続文字列またはコードでシークレットと資格情報を渡す必要がなくなります。

前提条件

任意のリージョンの Basic レベル以上の検索サービス。
有効なロールの割り当てを持つ Microsoft Entra セキュリティプリンシパルからの受信要求を許可する Azure リソース。

サポートされるシナリオ

Azure AI 検索は、システム割り当てまたはユーザー割り当てマネージド ID で他の Azure リソースに接続できます。

システム割り当てマネージド ID の検索サービスの構成は一般提供されています。
ユーザー割り当てマネージド ID の検索サービスの構成は、追加の使用条件のもとでパブリックプレビュー段階にあります。
システム割り当てとユーザー割り当てのどちらの場合でも、マネージド ID のデータプレーンの使用は一般提供されています。たとえば、インデクサーデータソース接続、キーコンテナー、デバッグセッション、またはエンリッチメントキャッシュでユーザー割り当てマネージド ID が必要な場合は、使用する機能も一般提供されているものであると仮定して、一般提供の REST API バージョンを使用して接続を作成できます。

システムマネージド ID は、接続文字列が、Microsoft Entra ID に対応するサービスまたはアプリケーションの一意リソース ID である場合に示されます。ユーザー割り当てマネージド ID は、"identity" プロパティを介して指定されます。

検索サービスでは、Azure Storage をインデクサーデータソースとして使用し、デバッグセッション、エンリッチメントキャッシュ、ナレッジストアのデータシンクとして使用します。ストレージに書き戻す検索機能の場合、「ロールの割り当て」セクションで説明されているように、マネージド ID には共同作成者ロールの割り当てが必要です。

シナリオ	System	ユーザー割り当て
サポートされている Azure データソースへのインデクサー接続 ¹	はい	はい
カスタマーマネージドキーの Azure Key Valut	はい	はい
デバッグセッション (Azure Storage でホストされている)¹	はい	いいえ
エンリッチメントキャッシュ (Azure Storage でホストされている) ^1、 ²	はい	はい
ナレッジストア (Azure Storage でホストされている) ¹	はい	はい
スキル/ベクタライザーを介した Azure OpenAI、Azure AI Foundry、Azure Functions への接続 ³	はい	はい

¹ 検索とストレージの間の接続では、ネットワークセキュリティ構成により、使用できるマネージド ID の種類に制約が課されます。信頼されたサービスの例外またはリソースインスタンスルールによるストレージへの同一リージョン接続に使用できるのは、システムマネージド ID だけです。詳細については、「ネットワークで保護されたストレージアカウントへのアクセス」を参照してください。

² 現在、共有キーアクセスがオフになっているストレージアカウントのテーブルに AI 検索サービスを接続することはできません。

³ スキル/ベクタライザーを介した Azure OpenAI、Azure AI Foundry、Azure Functions への接続には、カスタムスキル、カスタムベクタライザー、Azure OpenAI 埋め込みスキル、Azure OpenAI ベクタライザー、AML スキル、Azure AI Foundry モデルカタログベクタライザーが含まれます。

システムマネージド ID を作成する

システム割り当てマネージド ID を有効にすると、Microsoft Entra ID によって検索サービス用の ID が作成され、これを同じテナント内の他の Azure サービスに対する認証に使用できるようになります。その後に、データとモデルにアクセスするためのロールの割り当てでこの ID を使用できます。

システム割り当てマネージド ID は検索サービスに固有であり、その有効期間中サービスにバインドされます。検索サービスは、1 つのシステム割り当てマネージド ID しか持つことができません。

Azure portal にサインインし、ご利用の検索サービスを探します。
[設定] にある [ID] を選択します。
[システム割り当て] タブの [状態] で、[オン] を選択します。
[保存] を選択します。

設定を保存すると、ページが更新され、検索サービスに割り当てられているオブジェクト識別子が表示されます。

Set-AzSearchService `
  -Name YOUR-SEARCH-SERVICE-NAME `
  -ResourceGroupName YOUR-RESOURCE-GROUP-NAME `
  -IdentityType SystemAssigned

詳細については、「システム割り当てマネージド ID を使用して検索サービスを作成する (Azure PowerShell)」を参照してください。

az search service update `
  --name YOUR-SEARCH-SERVICE-NAME `
  --resource-group YOUR-RESOURCE-GROUP-NAME `
  --identity-type SystemAssigned

詳細については、「システム割り当てマネージド ID を使用して検索サービスを作成する (Azure CLI)」を参照してください。

検索サービスを作成または更新するへの要求を作成します。

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2023-11-01
{
  "location": "[region]",
  "sku": {
    "name": "[sku]"
  },
  "properties": {
    "replicaCount": [replica count],
    "partitionCount": [partition count],
    "hostingMode": "default"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

システムマネージド ID の確認とオブジェクト識別子が応答で返されます。

詳細については、「サービスの作成または更新 (Management REST API)」を参照してください。

ユーザー割り当てマネージド ID を作成する

重要

このシナリオの一部はパブリックプレビュー段階にあり、追加使用条件の下で提供されます。 Management プレビュー REST API は、Azure AI 検索のユーザー割り当てマネージド ID の構成を提供します。

ユーザー割り当てマネージド ID は Azure のリソースです。ロールの割り当てをよりきめ細かく行う場合は、複数のユーザー割り当てマネージド ID を作成します。たとえば、ID を異なるアプリケーションやシナリオごとに分けることができます。

手順は次のとおりです。

Azure サブスクリプションで、ユーザー割り当てマネージド ID を作成します。
検索サービスで、サービス定義を更新してユーザー割り当てマネージド ID を有効にします (この手順はプレビュー段階です)。
接続する他の Azure サービスで、ID のロールの割り当てを作成します。
インデクサーデータソースなどの Azure AI 検索上のデータソース接続では、接続の詳細でユーザーマネージド ID を参照します (この手順は、その機能のサポートが一般提供されている場合は一般提供になります)。

ユーザー割り当てマネージド ID のスコープは、サブスクリプション、リソースグループ、またはリソースの種類に設定できます。

ユーザー割り当てマネージド ID の関連付けは、Azure portal、Management REST API のプレビューバージョン、およびこの機能を提供するベータ SDK パッケージでサポートされています。

Azure Portal
REST API

Azure ポータル
[リソースの作成] を選択します。
[サービスとマーケットプレースを検索してください] 検索バーで、[ユーザー割り当てマネージド ID] を検索し、[作成] を選択します。
サブスクリプション、リソースグループ、リージョンを選択します。 ID にわかりやすい名前を付けます。
[作成] を選択し、リソースのデプロイが完了するまで待ちます。

ID を使用できるようになるまで数分かかります。
検索サービスページの [設定] から、[ID] を選択します。
割り当てられたユーザー タブで、追加を選択します。
サブスクリプションを選択し、前の手順で作成したユーザー割り当て管理対象リソースを選択します。

Azure portal の代わりにプレビューの Management REST API を使用して、ユーザー割り当てマネージド ID を割り当てることができます。 API バージョン 2021-04-01-preview 以降を使用します。この例では、2024-06-01-preview を使用します。

検索サービスを UPDATE する要求を作成します。

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-06-01-preview
{
  "location": "[region]",
  "sku": {
    "name": "[sku]"
  },
  "properties": {
    "replicaCount": [replica count],
    "partitionCount": [partition count],
    "hostingMode": "default"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/[subscription ID]/resourcegroups/[resource group name]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[name of managed identity]": {}
    }
  }
}

完全修飾マネージド ID を指定するには、"identity" プロパティを設定します。
- "type" は ID の型です。両方について、有効な値は "SystemAssigned"、"UserAssigned"、または "SystemAssigned, UserAssigned" です。値 "None" を指定すると、以前に割り当てられた ID が検索サービスからクリアされます。
- "userAssignedIdentities" には、ユーザー割り当てマネージド ID の詳細が含まれます。この ID は、これは、サービスの更新要求で指定する前に、既に存在している必要があります。

ロールの割り当て

マネージド ID を取得したら、Azure リソースに対する検索サービスのアクセス許可を決定するロールを割り当てます。

インデクサーデータ接続と、Azure Key Vault のカスタマーマネージドキーへのアクセスには、読み取りのアクセス許可が必要です。
Azure Storage を使用してデバッグセッションデータ、エンリッチメントキャッシュ、およびナレッジストア内の長期的なコンテンツストレージをホストする AI エンリッチメント機能には、書き込みアクセス許可が必要です。

次の手順はロールの割り当てのワークフローを示しています。この例は、Azure OpenAI 用です。その他の Azure リソースについては、「Azure Storage への接続」、「Azure Cosmos DB への接続」、「Azure SQL への接続」を参照してください。

Azure アカウントを使用して Azure portal にサインインし、Azure OpenAI リソースに移動します。
左側のメニューから [アクセスの制御] を選択します。
[追加] を選択し、[ロールの割り当ての追加] を選択します。
[職務権限ロール] で、[Cognitive Services OpenAI ユーザー] を選択し、[次へ] を選択します。
[メンバー] の下で [マネージド ID] を選択し、[メンバー] を選択します。
サブスクリプションとリソースの種類 (Search Service) でフィルター処理し、検索サービスのマネージド ID を選択します。
[レビューと割り当て] を選択します。

接続文字列の例

検索サービス用のマネージド ID を定義してロールの割り当てを付与した後は、他の Azure リソースの一意のリソース ID を使用するように送信接続を変更できます。さまざまなシナリオの接続文字列の例を次に示します。

これらの接続には、一般公開されている REST API バージョンと Azure SDK パッケージを使用できます。

ヒント

これらのオブジェクトのほとんどは Azure portal で作成できます。システムまたはユーザー割り当てマネージド ID のいずれかを指定して、JSON 定義を表示して接続文字列を取得します。

BLOB データソース (システム):

インデクサーデータソースには、データソースへの接続方法を決定する "credentials" プロパティが含まれています。次の例は、ストレージアカウントの一意のリソース ID を指定する接続文字列を示しています。

Microsoft Entra ID は、検索サービスのシステムマネージド ID を使用して要求を認証します。接続文字列にコンテナーが含まれることに注意してください。データソース定義では、接続文字列ではなく、コンテナー名が "container" プロパティ (表示されていません) で指定されます。

"credentials": {
    "connectionString": "ResourceId=/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Storage/storageAccounts/{storage-account-name};"
    }

BLOB データソース (ユーザー):

Azure Storage への検索要求は、ユーザー割り当てマネージド ID でも作成できます。検索サービスのユーザー ID は、"identity" プロパティで指定されます。

"credentials": {
    "connectionString": "ResourceId=/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Storage/storageAccounts/{storage-account-name};"
    },
  . . .
"identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"
  }

ナレッジストア:

ナレッジストアの定義は、Azure Storage への接続文字列が含まれます。接続文字列は、ストレージアカウントの一意のリソース ID です。文字列には、パスにコンテナーまたはテーブルが含まれています。これらは、接続文字列ではなく、埋め込みプロジェクション定義で定義されます。

"knowledgeStore": {
  "storageConnectionString": "ResourceId=/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Storage/storageAccounts/storage-account-name};"
}

エンリッチメントキャッシュ:

インデクサーは、キャッシュされたエンリッチメントに使用されるコンテナーを作成、使用、および記憶します。コンテナーをキャッシュ接続文字列に含める必要はありません。オブジェクト ID は、Azure portal の検索サービスの [ID] ページで確認できます。

"cache": {
  "enableReprocessing": true,
  "storageConnectionString": "ResourceId=/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Storage/storageAccounts/{storage-account-name};"
}

デバッグセッション:

デバッグセッションは Azure portal で実行され、セッションの開始時に接続文字列を取得します。次の例のような文字列を貼り付けることができます。

"ResourceId=/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Storage/storageAccounts/{storage-account-name}/{container-name};",

カスタムスキル:

カスタムスキルは、カスタムコードをホストしている Azure 関数またはアプリのエンドポイントをターゲットとします。

uri は、関数またはアプリのエンドポイントです。
authResourceId は、マネージド ID を使用して接続するように検索サービスに指示し、ターゲットの関数またはアプリのアプリケーション ID をプロパティの中に渡します。

{
  "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
  "description": "A custom skill that can identify positions of different phrases in the source text",
  "uri": "https://contoso.count-things.com",
  "authResourceId": "<Azure-AD-registered-application-ID>",
  "batchSize": 4,
  "context": "/document",
  "inputs": [ ... ],
  "outputs": [ ...]
}

Azure OpenAI 埋め込みスキルと Azure OpenAI ベクター化:

AI 検索の Azure OpenAI 埋め込みスキルとベクター化は、埋め込みモデルをホスティングする Azure OpenAI サービスのエンドポイントを対象とします。エンドポイントは、Azure OpenAI 埋め込みスキル定義またはAzure OpenAI ベクター化定義で指定されます。

システムマネージド ID は、次の例の中で示すように、"apikey" と "authIdentity" が空の場合に自動的に使用されます。 "authIdentity" プロパティは、ユーザー割り当てマネージド ID にのみ使用されます。

システムマネージド ID の例:

{
  "@odata.type": "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill",
  "description": "Connects a deployed embedding model.",
  "resourceUri": "https://url.openai.azure.com/",
  "deploymentId": "text-embedding-ada-002",
  "modelName": "text-embedding-ada-002",
  "inputs": [
    {
      "name": "text",
      "source": "/document/content"
    }
  ],
  "outputs": [
    {
      "name": "embedding"
    }
  ]
}

システム割り当てマネージド ID 用に構成されたベクトライザーの例を次に示します。ベクトライザーは検索インデックス内で指定されます。

 "vectorizers": [
    {
      "name": "my_azure_open_ai_vectorizer",
      "kind": "azureOpenAI",
      "azureOpenAIParameters": {
        "resourceUri": "https://url.openai.azure.com",
        "deploymentId": "text-embedding-ada-002",
        "modelName": "text-embedding-ada-002"
      }
    }
  ]

ユーザー割り当てマネージド ID の例:

"apiKey" が空で、かつ有効な "authIdentity" が指定されている場合は、ユーザー割り当てマネージド ID が使用されます。

{
  "@odata.type": "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill",
  "description": "Connects a deployed embedding model.",
  "resourceUri": "https://url.openai.azure.com/",
  "deploymentId": "text-embedding-ada-002",
  "modelName": "text-embedding-ada-002",
  "inputs": [
    {
      "name": "text",
      "source": "/document/content"
    }
  ],
  "outputs": [
    {
      "name": "embedding"
    }
  ],
  "authIdentity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/<subscription_id>/resourcegroups/<resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<user-assigned-managed-identity-name>"
   }
}

ユーザー割り当てマネージド ID 用に構成されたベクトライザーの例を次に示します。ベクトライザーは検索インデックス内で指定されます。

 "vectorizers": [
    {
      "name": "my_azure_open_ai_vectorizer",
      "kind": "azureOpenAI",
      "azureOpenAIParameters": {
        "resourceUri": "https://url.openai.azure.com",
        "deploymentId": "text-embedding-ada-002",
        "modelName": "text-embedding-ada-002"
        "authIdentity": {
            "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
            "userAssignedIdentity": "/subscriptions/<subscription_id>/resourcegroups/<resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<user-assigned-managed-identity-name>"
          }
      }
    }
  ]

ファイアウォールアクセスを確認する

Azure リソースがファイアウォールの背後にある場合は、検索サービスからと Azure portal からの要求を許可する受信規則があることを確認します。

Azure Blob Storage または Azure Data Lake Storage Gen2 への同じリージョン接続の場合は、システムマネージド ID と信頼されたサービスの例外を使用します。必要に応じて、要求を許可するようにリソースインスタンスルールを構成できます。
その他のすべてのリソースと接続については、Azure AI 検索からの要求を許可する IP ファイアウォール規則を構成します。詳細については、「Azure ネットワークセキュリティ機能によって保護されたコンテンツへのインデクサーのアクセス」に関する記事を参照してください。

次の方法で共有

Azure AI 検索でマネージド ID を使用して接続するように検索サービスを構成する

前提条件

サポートされるシナリオ

システムマネージド ID を作成する

ユーザー割り当てマネージド ID を作成する

ロールの割り当て

接続文字列の例

ファイアウォールアクセスを確認する

関連項目

フィードバック

その他のリソース

次の方法で共有

Azure AI 検索でマネージド ID を使用して接続するように検索サービスを構成する

前提条件

サポートされるシナリオ

システム マネージド ID を作成する

ユーザー割り当てマネージド ID を作成する

ロールの割り当て

接続文字列の例

ファイアウォール アクセスを確認する

関連項目

フィードバック

その他のリソース

システムマネージド ID を作成する

ファイアウォールアクセスを確認する