微软验证服务器,身份验证 - Azure Cognitive Services | Microsoft Docs

您现在访问的是微软AZURE全球版技术文档网站，若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站，请访问 https://docs.azure.cn.

对 Azure 认知服务的请求进行身份验证

11/22/2019

本文内容

对 Azure 认知服务的每个请求都必须包含身份验证标头。 此标头传递订阅密钥或访问令牌，用于验证服务或服务组订阅。 本文介绍三种对请求进行身份验证的方法以及每种方法的要求。

先决条件

在发出请求之前，需要具有 Azure 帐户和 Azure 认知服务订阅。 如果已有帐户，请继续并跳到下一节。 如果还没有帐户，我们会提供指南，可在几分钟内完成设置：创建 Azure 认知服务帐户。

创建帐户后，可以从 Azure 门户获取订阅密钥。

身份验证标头

让我们快速查看可用于 Azure 认知服务的身份验证标头。

标头

说明

Ocp-Apim-Subscription-Key

使用此标头通过特定服务订阅密钥或多服务订阅密钥进行身份验证。

Ocp-Apim-Subscription-Region

只有在使用具有 Translator 服务的多服务订阅密钥时才需要此标头。 使用此标头指定订阅区域。

授权

如果使用的是身份验证令牌，则使用此标头。 以下各节详细介绍了执行令牌交换的步骤。 提供的值遵循以下格式：Bearer 。

使用单服务订阅密钥进行身份验证

第一个选项是使用特定服务(如 Translator)的订阅密钥对请求进行身份验证。 Azure 门户中的密钥可用于已创建的每个资源。 要使用订阅密钥对请求进行身份验证，必须将其作为 Ocp-Apim-Subscription-Key 标头传递。

这些示例请求演示了如何使用 Ocp-Apim-Subscription-Key 标头。 请记住，使用此示例时，需要包括有效的订阅密钥。

这是对必应 Web 搜索 API 的调用示例：

curl -X GET 'https://api.cognitive.microsoft.com/bing/v7.0/search?q=Welsch%20Pembroke%20Corgis' \

-H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' | json_pp

这是对 Translator 服务的示例调用：

curl -X POST 'https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=de' \

-H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \

-H 'Content-Type: application/json' \

--data-raw '[{ "text": "How much for the cup of coffee?" }]' | json_pp

以下视频演示如何使用认知服务密钥。

使用多服务订阅密钥进行身份验证

警告

目前，以下服务不支持多服务密钥：QnA Maker、语音服务、自定义视觉和异常检测器。

此选项