共有プライベート エンドポイント経由でプライベート ネットワーク内の Key Vault にアクセスする

1. Azure portal で、Azure SignalR Service リソースに移動します。

2. [ネットワーク] を選択します。

3. [プライベート アクセス] タブを選択します。

4. [共有プライベート エンドポイント] セクションで [共有プライベート エンドポイントの追加] を選択します。

   

   次の情報を入力します。

   フィールド	説明
   名前	共有プライベート エンドポイントの名前。
   Type	Microsoft.KeyVault/vaults を選択する
   サブスクリプション	Key Vault を含むサブスクリプション。
   リソース	Key Vault リソースの名前を入力します。
   要求メッセージ	「承認してください」と入力します

5. [追加] を選択します。

   

プライベート エンドポイントが正常に追加されると、プロビジョニング状態は [成功] になります。 Key Vault 側でエンドポイントを承認するまで、接続状態は [保留中] になります。

Azure CLI で次の API 呼び出しを行って共有プライベート リンク リソースを作成します。

az rest --method put --uri https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/sharedPrivateLinkResources/kv-pe?api-version=2021-06-01-preview --body @create-pe.json

API への要求本文を表す create-pe.json ファイルの内容は次のとおりです。

{
      "name": "contoso-kv",
      "properties": {
        "privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.KeyVault/vaults/contoso-kv",
        "groupId": "vault",
        "requestMessage": "please approve"
      }
}

発信プライベート エンドポイントを作成するプロセスは長時間実行される (非同期の) 操作です。 すべての非同期 Azure 操作の場合と同様に、PUT の呼び出しでは、次のテキストのような Azure-AsyncOperation ヘッダー値が返されます。

"Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/operationStatuses/c0786383-8d5f-4554-8d17-f16fcf482fb2?api-version=2021-06-01-preview"

この URI を定期的にポーリングして、操作の状態を取得できます。

Azure-AsyncOperationHeader 値に手動でクエリを実行することによって、状態をポーリングできます。

az rest --method get --uri https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/operationStatuses/c0786383-8d5f-4554-8d17-f16fcf482fb2?api-version=2021-06-01-preview

状態が [成功] に変化するまで待ってから次の手順に進みます。

1. Key Vault リソースに移動します。

2. [ネットワーク] を選択します。

3. [プライベート エンドポイント接続] タブを選択します。非同期操作が成功したら、以前の API 呼び出しからの要求メッセージを使用して、プライベート エンドポイント接続に対する要求を行う必要があります。

4. SignalR Service で作成されたプライベート エンドポイントを選択してから、[承認] を選択します。

5. [はい] を選択して接続を承認します。

   

1. プライベート エンドポイント接続を一覧表示します。

   az network private-endpoint-connection list -n <key-vault-resource-name>  -g <key-vault-resource-group-name> --type 'Microsoft.KeyVault/vaults'
   

   保留中のプライベート エンドポイント接続があるはずです。 その ID を書き留めます。

   [
       {
           "id": "<id>",
           "location": "",
           "name": "",
           "properties": {
               "privateLinkServiceConnectionState": {
                   "actionRequired": "None",
                   "description": "Please approve",
                   "status": "Pending"
              }
           }
       }
   ]
   

2. プライベート エンドポイント接続を承認します。

   az network private-endpoint-connection approve --id <private-endpoint-connection-id>
   

az rest --method get --uri https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/sharedPrivateLinkResources/func-pe?api-version=2021-06-01-preview

このコマンドは、接続状態が "properties" セクションに "status" として示されている JSON オブジェクトを返します。

{
      "name": "contoso-kv",
      "properties": {
        "privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.KeyVault/vaults/contoso-kv",
        "groupId": "vaults",
        "requestMessage": "please approve",
        "status": "Approved",
        "provisioningState": "Succeeded"
      }
}

リソースの "プロビジョニング状態" (properties.provisioningState) が Succeeded であり、"接続状態" (properties.status) が Approved である場合、共有プライベート リンク リソースは機能しており、SignalR Service はプライベート エンドポイント経由で通信できます。