创建新的用户 API

Automation 360

关闭内容

内容

打开内容

下载 PDF

创建新的用户 API

使用 Create user API 在 Control Room.

先决条件

查看和管理用户和角色: 使用具有以下管理权限的用户进行身份验证：

查看用户
您需要管理员权限才能创建和管理用户和角色。建议授予非管理员用户创建和管理用户的有限权限。了解如何创建可分配给用户的具有有限权限的角色。
创建用户
中创建新用户 Control Room.
编辑用户
编辑所有用户 Control Room，包括其他管理员创建的用户。
删除用户
删除任何用户 Control Room.
查看角色
拥有此权限的用户可以查看他们有权访问的角色。
管理角色
用户可以创建、编辑和删除他们有权访问的角色。
查看许可证
拥有这些权限的用户可以查看和管理设备许可证。需要设备许可证才能使用户能够执行特定任务。例如， Bot Creators 需要开发设备许可证才能创建 bots.
管理用户设备许可证
拥有此权限的用户可以将设备许可证分配给其他用户。

最低要求参数

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

可选参数

"enableAutoLogin": true
"username": "AnyUser"
"firstName": "Tester"
"lastName": "Writer"
"email": "username@mydomain.com"
"password": "anypassword"
"description": "Testing User Management APIs"
"deviceCredentialAttested": true
"licenseFeatures": [ DEVELOPMENT, CITIZENDEVELOPER, RUNTIME, ATTENDEDRUNTIME, AARIUSER, DISCOVERYBOTANALYZER, DISCOVERYBOTRECORDER, ANALYTICSCLIENT, ANALYTICSAPI ]
无需分配设备许可证即可创建用户。有角色和权限为特定用户和角色启用权限。

网址： http://<your_control_room_url>/v1/usermanagement/users
将尖括号中的内容替换为您的 Control Room 网址。
方法：POST
使用随您的设备安装的 Swagger Control Room 测试 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 响应代码.

发送反馈