监控基于 OAuth 2.0 的 API

第一个获取令牌任务的主要目标是获取应用程序访问服务 API 的访问令牌。 如果成功，可以从服务 API 响应检索访问令牌，并在后续 API 请求中使用。 此外，任务验证为访问令牌交换应用程序授权代码。 如果出现错误，将为设备生成警报。

若要创建设备，请单击 设备管理器 页上 的”新设备 “并选择 HTTP/S 任务。

URL

要设置任务，我们需要向授权服务器生成访问令牌请求。 在URL字段中，以以下格式https://authorization-server.com/oauth/authorize指定 API 授权服务器的 URL。 确切的 URL 取决于要连接到的服务。

SSL/证书检查

启用 SSL 证书检查。

请求类型和发布数据

客户端身份验证参数（客户端ID和客户端密钥）、重定向 URI和授权代码必须在请求中提供给授权服务器。 让我们使用 POST 方法（ 请求类型 字段）发送应用程序详细信息和代码。

在“发布数据”字段中，我们需要指定以下请求正文属性：

• client_id – 应用程序标识符，在您的应用程序在授权服务器首次注册时发出。
• client_secret– 在您的应用程序在授权服务器首次注册时发出。
• 代码– 从授权服务器接收的授权代码。
• grant_type – 必须设置为“authorization_code”。
• redirect_uri – URL 必须与以前在应用程序注册的重定向 URL 匹配。

作为任务执行的结果，我们将从响应正文中的授权服务器接收带有访问令牌的 JSON 响应。

内容验证

为确保服务器响应返回访问令牌和刷新令牌（在访问令牌过期时使用），请指定以下关键字：

• access_token
• refresh_token

要设置其他任务字段（如有必要），请参阅添加/编辑 HTTP（S） 任务。

设置完成后，单击”创建设备“并继续下一步，使用访问令牌实现 API 调用。

当由于获取令牌任务执行而收到具有访问令牌的 API 响应时，我们需要提取令牌来调用服务 API。 例如，我们希望通过请求 /用户端点来检索受监控服务 的用户 列表。

首先，创建一个脚本，从获取令牌任务响应正文中提取令牌到变量。 例如，以下脚本将令牌和令牌类型从基本授权响应传递到令牌授权变量：

string access_token;
string token_type;
string TokenAuthorization;

// get the authorization response from the first task
string json = (Tasks["Get Token"] as Http).body["//*"];

//convert response to the comma separated strings
string[] comas = json.Split(new Char[] { ',' });

// get the access token
int start1 = comas[0].IndexOf(":") + 2;
int length1 = comas[0].Length - start1 - 1;
access_token = comas[0].Substring(start1, length1); 

// get the token type
int start2 = comas[1].IndexOf(":") + 2;
int length2 = comas[1].Length - start2 - 1;
token_type = comas[1].Substring(start2, length2);

// set the TokenAuthorization variable to specify in the data request header 
TokenAuthorization = token_type + " " + access_token;

要向在第一步配置的 API 监视设备添加新任务，：

1. 在” 设备管理器 “页上，单击 中的操作按钮。
2. 在操作菜单上，选择“添加任务“。

URL

在URL字段中，指定从中提取数据所需的服务资源的请求 URI。

SSL/证书检查

启用 SSL 证书检查。

请求类型

选择GET请求类型。

OAuth 2.0 要求在 HTTP GET 请求的授权标头 中传递访问令牌和令牌类型，但您也可以作为 GET 查询字符串或 POST 正文参数提供。

头

使用授权标头名称和令牌授权值添加标头。 要将令牌授权变量转换为动态变量，请单击值字段中的齿轮图标，并在“编辑值”对话框中选择“动态“。

“动态值”字段将用括号标记。

准备脚本

添加要在访问令牌中传递的脚本。

内容验证

要验证使用服务响应返回的数据，还可以指定相应的关键字。 例如，您希望从服务中检索多个用户名。

要设置其他任务字段，请参阅添加/编辑 HTTP（S） 任务。