创建新用户 API

Automation Anywhere Automation 360

关闭内容

内容

打开内容

下载 PDF

创建新用户 API

使用创建用户 API 在 Control Room 中创建新用户。

先决条件

查看和管理用户和角色

对具有以下管理权限的用户进行身份验证：

查看用户

具有这些权限的用户能够创建和管理用户。这些是管理员权限。建议向非管理员用户授予创建和管理用户的有限权限。了解如何创建可分配给用户的具有有限权限的角色。

创建用户: 在 Control Room 中创建新用户。
编辑用户: 编辑 Control Room 中的所有用户，包括由其他管理员创建的用户。
删除用户: 删除 Control Room 中的任何用户。

查看角色

具有此权限的用户可以查看他们有权访问的角色。

管理角色: 用户可以创建、编辑和删除他们有权访问的角色。

查看许可证

具有这些权限的用户可以查看和管理设备许可证。需要设备许可证才能使用户能够执行特定任务。例如，Bot Creators 需要 DEVELOPMENT 设备许可证才能创建 bots。

管理用户的设备许可证: 具有此权限的用户可以将设备许可证分配给其他用户。

最低必需参数

角色：用户必须至少具有一个角色。
基于角色的可访问性允许适当访问相关数据和操作。
在请求正文中，我们分配了此权限 AAE_Basic (ID: 2)
角色和权限
用户名：字符串（最多 255 个）
电子邮件：必须符合标准电子邮件格式（username@domain.com）
密码：字符串：长度为 8-15 个字符。允许字符：a-z、A-Z、0-9、@、-、_、!、#、$、%、& 和 .（句点）

参数(可选)

"enableAutoLogin"：true
"username"："AnyUser"
"firstName"："Tester"
"lastName"："Writer"
"email"："username@mydomain.com"
"password"："anypassword"
"description"："Testing User Management APIs"
"licenseFeatures"：[ DEVELOPMENT, RUNTIME, IQBOTRUNTIME, ANALYTICSCLIENT, ANALYTICSAPI ]
可以在没有分配的设备许可证的情况下创建用户。存在角色和权限为特定用户和角色启用权限的功能。

URL：http://<your_control_room_url>/v1/usermanagement/users
用您的 Control Room URL 替换尖括号中的内容。
Method：POST
使用随 Control Room 安装的 Swagger 测试 API。查看可用 API：http://<your_control_room_url>/swagger/
您还可以使用 REST 客户端来完成此任务。

过程

将认证令牌添加到请求标头。
使用 POST 方法和端点 URL：<your_control_room_url>/v1/usermanagement/users

在请求正文中，输入必填和可选参数。

对于基于 SAML 的单点登录 (SSO) 或 Active Directory (AD) 访问，不需要密码。数据库身份验证时必须提供密码。

请求正文：

{
 {
  "roles": [
    {
      "id": 2
    }
  ],
  "domain": "string",
  "email": "ad@ma.com",
  "enableAutoLogin": true,
  "username": "mdadmin1",
  "firstName": "MDadmin2",
  "lastName": "ADadmin",
  "description": "string",
  "disabled": true,
  "password": "changeme",
  "licenseFeatures": [
    "DEVELOPMENT"
  ]
}

发送请求

响应正文：

{
    "id": 2075,
    "username": "mdadmin1",
    "domain": "string",
    "firstName": "MDadmin2",
    "lastName": "ADadmin",
    "version": 0,
    "principalId": 2075,
    "deleted": false,
    "roles": [
        {
            "name": "AAE_Basic",
            "id": 2,
            "version": 0
        }
    ],
    "sysAssignedRoles": [],
    "groupNames": [],
    "permissions": [
        {
            "id": 7526,
            "action": "viewuserrolebasicinfo",
            "resourceId": null,
            "resourceType": "usermanagement"
        },
        {
            "id": 7,
            "action": "run",
            "resourceId": null,
            "resourceType": "repositorymanager"
        },
        {
            "id": 94,
            "action": "view",
            "resourceId": null,
            "resourceType": "botstore"
        },
        {
            "id": 61,
            "action": "createstandard",
            "resourceId": null,
            "resourceType": "credentialattribute"
        },
        {
            "id": 92,
            "action": "view",
            "resourceId": null,
            "resourceType": "packagemanager"
        },
        {
            "id": 97,
            "action": "register",
            "resourceId": null,
            "resourceType": "devices"
        },
        {
            "id": 29,
            "action": "view",
            "resourceId": null,
            "resourceType": "repositorymanager"
        },
        {
            "id": 120,
            "action": "view",
            "resourceId": null,
            "resourceType": "dashboard"
        }
    ],
    "licenseFeatures": [
        "DEVELOPMENT"
    ],
    "emailVerified": false,
    "passwordSet": false,
    "questionsSet": false,
    "enableAutoLogin": true,
    "disabled": true,
    "clientRegistered": false,
    "description": "string",
    "createdBy": 1513,
    "createdOn": "2020-11-20T20:17:26Z",
    "updatedBy": 1513,
    "updatedOn": "2020-11-20T20:17:26Z",
    "publicKey": null,
    "appType": null,
    "routingName": null,
    "appUrl": null,
    "email": "ad@ma.com"
}

REST API 用 HTTP 响应代码响应每个请求。有关响应代码的详细信息，请参阅 API 响应代码。

发送反馈