Microsoft Foundry のカスタマー マネージド キーを構成する

リソースの作成時に、ウィザードでは、ユーザー割り当てマネージド ID またはシステム割り当てマネージド ID を使用するように指示されます。 また、キーが格納されているキー コンテナーまたは Managed HSM を選択する方法についても説明します。

既存の Foundry リソースを更新する場合は、次の手順を使用して CMK を有効にします。

1. Azure ポータルで Foundry リソースを開きます。

2. リソース管理>Encryption に移動します。

3. 暗号化の種類として Customer-Managed キー を選択します。

4. キー ストアの URL (キー コンテナーの URL または Managed HSM URL) とキー名を入力します。

5. [保存] を選択します。

構成を確認するには、 Resource Management>Encryption に移動し、 Customer-Managed キー がアクティブな暗号化の種類として表示され、キー ストアとキー名が表示されていることを確認します。

Bicepや ARM などのテンプレートを使用して CMK を有効にすることもできます。 アカウントの encryption プロパティで、 keySource を Microsoft.KeyVault に設定し、キー ストアの URI とキー名を keyVaultPropertiesで指定します。 keyVersion プロパティは省略可能です。

ユーザー割り当てマネージド ID を使用する場合は、 identityClientId もその ID のクライアント ID に設定します。 この値は、キーにアクセスするときに使用する ID をリソースに指示します。

ユーザー割り当て管理されたID

ユーザー割り当て ID を使用すると、Foundry リソースを作成する前にキー ストアへのアクセス権を付与できるため、単一のデプロイで十分です。

resource account 'Microsoft.CognitiveServices/accounts@2026-05-01' = {
  name: aiFoundryName
  location: location
  kind: 'AIServices'
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      '${userAssignedIdentityId}': {}
    }
  }
  properties: {
    encryption: {
      keySource: 'Microsoft.KeyVault'
      keyVaultProperties: {
        keyVaultUri: keyVaultUri
        keyName: keyName
        keyVersion: keyVersion // Optional — omit to enable automatic key rotation.
        identityClientId: userAssignedIdentityClientId
      }
    }
  }
}

完全な例については、 ユーザー割り当て ID を持つカスタマー マネージド キーを参照してください。

システムによって割り当てられた管理されたID

システム割り当てマネージド ID を使用する場合、リソースが作成されるまで ID は存在しません。 2 つのデプロイを使用して CMK を構成します。

1. SystemAssigned ID を使用し、encryption プロパティを使用せずに Foundry リソースを作成します。 このデプロイでは、システム割り当て ID がプロビジョニングされます。

2. システム割り当て ID にキー コンテナーへのアクセス権を付与し、リソースを更新して encryption プロパティを追加します。

リソースを作成した後、マネージド ID のプリンシパル ID が反映されるまでしばらく待ってから、Key Vault のアクセス許可を割り当ててください。 ロールの割り当てが失敗した場合は、数分待ってから再試行してください。

Bicepアプローチでは、2 つのファイルを使用します。main.bicepは暗号化なしでリソースを作成し、updateEncryption.bicepはキー コンテナーへのアクセスを許可し、暗号化を適用します。

// main.bicep — First deployment: create the resource with SystemAssigned identity
resource account 'Microsoft.CognitiveServices/accounts@2026-05-01' = {
  name: aiFoundryName
  location: location
  identity: {
    type: 'SystemAssigned'
  }
  kind: 'AIServices'
  sku: {
    name: 'S0'
  }
  properties: {
    publicNetworkAccess: 'Enabled'
    allowProjectManagement: true
    customSubDomainName: aiFoundryName
    disableLocalAuth: false
  }
}

// Second deployment: grant key vault access and apply encryption
module encryptionUpdate 'updateEncryption.bicep' = {
  name: 'updateEncryption'
  params: {
    aiFoundryName: account.name
    aiFoundryPrincipal: account.identity.principalId
    keyVaultName: keyVaultName
    keyVaultUri: keyVaultUri
    keyName: keyName
    keyVersion: keyVersion
    location: location
  }
}

updateEncryption.bicep モジュールは、キー コンテナーのアクセス許可を付与し、既存のリソースに暗号化を適用します。 次の両方のアクセス許可モデルがサポートされています。

• Azure RBAC: Key Vault Crypto User ロールをシステム割り当て ID に割り当てます。
• コンテナー アクセス ポリシー: システム割り当て ID に get、 wrapKey、および unwrapKey のアクセス許可を付与します。

完全な例については、 システム割り当て ID を持つカスタマー マネージド キーを参照してください。

デプロイ後、CMK 暗号化が適用されていることを確認します。 次のコマンドを実行し、keySource が、キー コンテナー URI とキー名を指定した Microsoft.KeyVault に置き換えられていることを確認します。

az cognitiveservices account show \
  --name <resource-name> \
  --resource-group <resource-group> \
  --query properties.encryption

システム割り当て ID シーケンスにAzure CLIを使用することもできます。

# First deployment: create the resource with system-assigned identity (no encryption)
az cognitiveservices account create \
  --name <resource-name> \
  --resource-group <resource-group> \
  --location <location> \
  --kind AIServices \
  --sku S0 \
  --assign-identity

# Retrieve the system-assigned identity principal ID
principalId=$(az cognitiveservices account show \
  --name <resource-name> \
  --resource-group <resource-group> \
  --query identity.principalId -o tsv)

# Grant key vault access (RBAC model)
az role assignment create \
  --role "Key Vault Crypto User" \
  --assignee-object-id $principalId \
  --assignee-principal-type ServicePrincipal \
  --scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.KeyVault/vaults/<key-vault-name>

# Or grant key vault access (access policy model)
# az keyvault set-policy \
#   --name <key-vault-name> \
#   --object-id $principalId \
#   --key-permissions get wrapKey unwrapKey

# Second deployment: update the resource to enable CMK encryption
az cognitiveservices account update \
  --name <resource-name> \
  --resource-group <resource-group> \
  --encryption "{\"keySource\":\"Microsoft.KeyVault\",\"keyVaultProperties\":{\"keyVaultUri\":\"https://<key-vault-name>.vault.azure.net\",\"keyName\":\"<key-name>\",\"keyVersion\":\"<key-version>\"}}"

# Verify that CMK encryption is enabled
az cognitiveservices account show \
  --name <resource-name> \
  --resource-group <resource-group> \
  --query properties.encryption