Documentation

13. 应用程序

从 automation controller 3.3 开始,提供了为外部应用程序创建和配置基于令牌的身份验证的功能。这使得 ServiceNow 和 Jenkins 等外部应用程序可以更容易地与 automation controller 集成。OAuth 2 可让您在不公开登录信息的情况下使用令牌与应用程序共享某些数据。另外,这些令牌可以被限定为“只读”。您可以创建一个应用程序来代表要集成的外部应用程序,然后使用它为外部应用程序的用户创建需要使用的令牌。

通过把这些令牌与一个应用程序资源相关联,您可以更轻松地管理针对特定应用程序发布的所有令牌。通过对应用程序的令牌进行分离,您可以取消特定应用程序的令牌,而无需撤销系统中的所有令牌。

当把一个外部 web 应用程序与 automation controller 集成时,那个 web 应用程序可能需要为该应用程序上的用户创建 OAuth2 令牌。实现这个目的的首选做法是创建一个带有授权代码(Authorization Code)准许类型的应用程序。这是因为:

  • 外部应用可以使用用户的凭证来获取令牌

  • 对为特定应用程序发布的令牌进行分离,可轻松管理这些令牌(例如,可以删除所有与该应用程序关联的令牌)

13.1. 应用程序入门

点左面导航栏中的 Applications 进入 Applications 页。Applications 页包括了一个可以对其进行搜索的、当前由控制器管理的所有可用应用程序的列表,并可以根据 Name 进行排序。

Applications - home with example apps

如果没有其它应用程序,则只会显示一个添加应用程序信息的灰色框。

_images/apps-list-view-empty.png

13.2. 创建新应用程序

用户的基于令牌的验证可以在 Applications 窗口中进行配置。

  1. 在 automation controller 用户界面中,从左侧导航栏中点 Applications

Applications 窗口将打开。

  1. 点 Applications 窗口右上角的 Add 按钮。

New Application 窗口将打开。

Create application

  1. Create New Application 窗口中输入以下信息:

  • **Name**(必需):为要创建的应用程序提供名称

  • **Description**(可选):为您的应用程序提供简短描述。

  • **Organization**(必需):提供一个与这个应用程序关联的机构

  • **Authorization Grant Type**(必需):从一个准许类型中选择以便用户获取这个应用程序的令牌。请参考 Automation Controller Administration Guide 的 Applications 部分中的 grant types

  • Redirect URIS:提供一组允许的 URI,使用空格分开。如果您指定的准许类型为 Authorization code,则此项是必需的。

  • **Client Type**(必需):选择客户端设备的安全性级别

  1. 完成后,点 SaveCancel 取消更改。保存后,客户端 ID 会显示在弹出窗口中。

_images/apps-client-id-popup.png

13.2.1. Applications - Tokens

选择 Tokens 查看有令牌来访问应用程序的用户列表。

Applications - tokens list

令牌只能访问与其关联的用户有权访问的资源,并可通过指定令牌范围来做进一步限制。

13.2.1.1. 添加令牌

令牌可以通过 Users 屏幕添加,并与一个应用程序关联。指定应用程序可以在用户的令牌设置中直接执行。您可以为 Tokens 配置标签中为*您的*用户创建一个令牌,这意味着只能在您自己的用户屏幕中创建并查看您的令牌。要添加令牌:

  1. 点左侧导航栏中的 Users 显示用户列表,然后点击您的用户来配置 OAuth 2 令牌。

注解

使用 API 或 UI 只能为您自己的用户创建 OAuth 2 Tokens,这意味着您只能访问自己的用户配置集来配置或查看您的令牌。如果您是一个 admin,需要为其他用户创建或删除令牌,请参阅 Automation Controller Administration GuideToken and session management 部分中关于 revoke 和 create 命令的内容。

  1. 在用户档案中点 Tokens 标签页。

当没有令牌时,Tokens 屏幕会提示您添加它们:

_images/users-tokens-empty.png
  1. Add 按钮,打开 Create Token 窗口。

  2. 在 Create Token 窗口中输入以下信息:

  • Application:输入要与您的令牌关联的应用程序名称,或通过点击 search 按钮进行搜索。这会打开一个单独的窗口,允许您从可用选项中选择。如果列表太长,则可以使用搜索栏按名称过滤。如果您想创建一个不和任何应用程序相关联的 Personal Access Token (PAT),请保留此字段为空白。

  • **Description**(可选):为您的令牌提供简短描述。

  • **Scope**(必需):指定此令牌具有的访问级别。

  1. 完成后,点击 Save,或者点 Cancel 取消更改。

保存令牌后,新生成的令牌会显示令牌信息及其过期的时间。

_images/users-token-information-example.png

注解

这是唯一显示令牌值和关联刷新令牌值的时间。

在用户的档案中,分配给它的应用程序及其过期时间显示在令牌列表视图中。

_images/users-token-assignment-example.png

通过 Applications 窗口的 Tokens 标签页可以验证上例中的应用程序的用户带有适当的令牌:

_images/apps-tokens-list-view-example2.png