通过共享专用终结点访问专用网络中的密钥保管库

1. 在 Azure 门户中，转到 Azure Web PubSub 资源。

2. 在左侧菜单中选择“网络”。

3. 选择“专用访问”选项卡。

4. 选择“添加共享专用终结点”。

   

5. 对于“名称”，请输入要用于共享专用终结点的名称。

6. 若要选择密钥保管库资源，请完成以下步骤之一：

   • 选择“从资源中选择”，然后从列表中选择资源。
   • 选择“指定资源 ID”并输入密钥保管库资源 ID。

7. 对于“请求消息”，输入“请批准”。

8. 选择 添加 。

   

共享专用终结点资源的预配状态为“成功”。 连接状态为“挂起”，正在等待对目标资源的审批。

可以使用 Azure CLI 进行以下 API 调用，以创建共享专用链接资源。 将值 uri 替换为实际 URI。

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

create-pe.json 文件的内容表示 API 的请求正文：

{
      "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/webpubsub/contoso-webpubsub/operationStatuses/c0786383-8d5f-4554-8d17-f16fcf482fb2?api-version=2022-08-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/webpubsub/contoso-webpubsub/operationStatuses/c0786383-8d5f-4554-8d17-f16fcf482fb2?api-version=2022-08-01-preview

1. 在 Azure 门户中，转到密钥保管库资源。

2. 在左侧菜单中选择“网络”。

3. 选择“专用终结点连接”。

   

4. 选择 Web PubSub 创建的专用终结点。

5. 选择“批准”，然后选择“是”进行确认。

   将专用终结点连接状态更改为“已批准”可能需要几分钟时间。

   

1. 列出专用终结点连接：

   az network private-endpoint-connection list --name <key-vault-resource-name>  --resource-group <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>
   

1. 在 Azure 门户中，转到 Azure Web PubSub 资源。

2. 在左侧菜单中选择“网络”。

3. 选择“共享专用链接资源”。

   

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

此命令会返回 JSON。 系统会在 properties 下的 status 中指明连接状态。

{
      "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，则表示共享专用链接资源正常运行，Web PubSub 可以通过专用终结点进行通信。