管理多租户

更新时间: 2025-02-18 09:00:47
编辑

此模块可以进行多租户场景下的租户管理和身份源连接管理等操作。

请使用以下方式使用该模块：

import { ManagementClient } from "authing-js-sdk";
const managementClient = new ManagementClient({
  userPoolId: "YOUR_USERPOOL_ID",
  secret: "YOUR_USERPOOL_SECRET",
});

managementClient.tenant.list; // 获取用户池下的租户列表
managementClient.tenant.create; // 创建租户
managementClient.tenant.update; // 修改租户
managementClient.tenant.delete; // 删除租户

获取用户池下的租户列表

获取用户池下租户列表。

managementClient.tenant.list(params);

参数

参数类型必填描述
params.pagestring否分页参数，页数。
params.limitstring否分页参数，每页显示个数。当参数 limit = -1 时，将返回所有数据

示例

const tenants = await managementClient.tenant.list();

const tenants = await managementClient.tenant.list({ page: 1, limit: 10 });

返回值

参数类型描述
listobject array租户列表
totalCountnumber总条数

示例数据

{
  "list": [
    {
      "id": "619b07312d6b99e1af7d8e4e",
      "createdAt": "2021-11-22T02:57:53.426Z",
      "updatedAt": "2021-11-22T02:57:53.426Z",
      "userPoolId": "619b014f144de0ffc38b869d",
      "name": "示例名称",
      "logo": "https://files.authing.co/user-contents/photos/bd5bd9c3-3be8-475f-b8f5-752751d91bb6.png",
      "description": null,
      "css": null,
      "ssoPageCustomizationSettings": null,
      "defaultLoginTab": "password",
      "defaultRegisterTab": "email",
      "passwordTabConfig": [Object],
      "loginTabs": [Array],
      "registerTabs": null,
      "extendsFields": null
    }
  ],
  "totalCount": 1
}

根据 ID 查询租户详情

根据 ID 查询租户详情

managementClient.tenant.details(tenantId);

参数

参数类型必填描述
tenantIdstring是租户 ID

示例

const tenant = await managementClient.tenant.details("租户 ID");

返回值

{
  "id": "619b07312d6b99e1af7d8e4e",
  "createdAt": "2021-11-22T02:57:53.426Z",
  "updatedAt": "2021-11-22T02:57:53.426Z",
  "userPoolId": "619b014f144de0ffc38b869d",
  "name": "示例名称",
  "logo": "https://files.authing.co/user-contents/photos/bd5bd9c3-3be8-475f-b8f5-752751d91bb6.png",
  "description": null,
  "css": null,
  "ssoPageCustomizationSettings": null,
  "defaultLoginTab": "password",
  "defaultRegisterTab": "email",
  "passwordTabConfig": {
    "enabledLoginMethods": [
      "username-password",
      "email-password",
      "phone-password"
    ]
  },
  "loginTabs": ["phone-code", "password"],
  "registerTabs": null,
  "extendsFields": null,
  "apps": [
    {
      "qrcodeScanning": [Object],
      "id": "619b0150216449466e8728e9",
      "createdAt": "2021-11-22T02:32:48.435Z",
      "updatedAt": "2021-11-22T02:58:28.862Z",
      "userPoolId": "619b014f144de0ffc38b869d",
      "protocol": "oidc",
      "isOfficial": false,
      "isDeleted": false,
      "isDefault": false,
      "isDemo": true,
      "name": "示例应用名称",
      "description": null,
      "secret": "48b90d4f2add0bde9f3ceafa3606dac7",
      "identifier": "p12jzu-demo",
      "jwks": [Object],
      "ssoPageCustomizationSettings": null,
      "logo": "https://files.authing.co/authing-console/default-app-logo.png",
      "redirectUris": [Array],
      "logoutRedirectUris": [],
      "initLoginUrl": null,
      "oidcProviderEnabled": true,
      "oauthProviderEnabled": false,
      "samlProviderEnabled": false,
      "casProviderEnabled": false,
      "registerDisabled": false,
      "loginTabs": [Array],
      "passwordTabConfig": [Object],
      "defaultLoginTab": "password",
      "registerTabs": [Array],
      "defaultRegisterTab": "email",
      "ldapConnections": null,
      "adConnections": [],
      "extendsFieldsEnabled": false,
      "extendsFields": [],
      "ext": null,
      "css": null,
      "oidcConfig": [Object],
      "oidcJWEConfig": null,
      "samlConfig": null,
      "oauthConfig": [Object],
      "casConfig": null,
      "showAuthorizationPage": false,
      "enableSubAccount": false,
      "enableDeviceMutualExclusion": false,
      "loginRequireEmailVerified": false,
      "agreementEnabled": false,
      "isIntegrate": false,
      "ssoEnabled": false,
      "template": null,
      "skipMfa": false,
      "casExpireBaseBrowser": false,
      "appType": "INDIVIDUAL",
      "permissionStrategy": [Object]
    }
  ]
}

创建租户

创建租户

managementClient.tenant.create(options);

参数

参数类型必填描述
options.namestring是租户名称
options.appIdsstring是应用 ID，支持关联多个应用，使用英文逗号分隔
options.logostring否头像地址，通过图片上传接口中的 url 值。可不传，有值时必须为 URL 格式的字符串，不能为空字符串
options.descriptionstring否租户描述

示例

const tenant = await managementClient.tenant.create({
  name: "搜索",
  appIds: "619b64e4ccc0467dcba00920",
});

返回值

{
  "userPoolId": "619b014f144de0ffc38b869d",
  "name": "搜索",
  "createdAt": "2021-11-22T09:38:05.696Z",
  "updatedAt": "2021-11-22T09:38:05.696Z",
  "id": "619b64fd2cfccd07a8296839",
  "logo": null,
  "description": null,
  "css": null,
  "ssoPageCustomizationSettings": null,
  "defaultLoginTab": "password",
  "defaultRegisterTab": "email",
  "passwordTabConfig": null,
  "loginTabs": null,
  "registerTabs": null,
  "extendsFields": null,
  "apps": [
    {
      "qrcodeScanning": [Object],
      "id": "619b64e4ccc0467dcba00920",
      "createdAt": "2021-11-22T09:37:40.422Z",
      "updatedAt": "2021-11-22T09:37:40.462Z",
      "userPoolId": "619b014f144de0ffc38b869d",
      "protocol": "oidc",
      "isOfficial": false,
      "isDeleted": false,
      "isDefault": false,
      "isDemo": false,
      "name": "搜索网",
      "description": null,
      "secret": "1f264d7d4b2dd2d4996ad7185c45a6f9",
      "identifier": "search",
      "jwks": [Object],
      "ssoPageCustomizationSettings": null,
      "logo": "https://files.authing.co/authing-console/default-app-logo.png",
      "redirectUris": [Array],
      "logoutRedirectUris": [],
      "initLoginUrl": null,
      "oidcProviderEnabled": true,
      "oauthProviderEnabled": false,
      "samlProviderEnabled": false,
      "casProviderEnabled": false,
      "registerDisabled": false,
      "loginTabs": [Array],
      "passwordTabConfig": [Object],
      "defaultLoginTab": "password",
      "registerTabs": [Array],
      "defaultRegisterTab": "email",
      "ldapConnections": null,
      "adConnections": [],
      "extendsFieldsEnabled": false,
      "extendsFields": [],
      "ext": null,
      "css":
        "/* \n" +
        "  Edit login page css\n" +
        "  eg：\n" +
        "  .authing-guard-layout {\n" +
        "    background: black !important;\n" +
        "  }\n" +
        "  Change the background color\n" +
        "*/",
      "oidcConfig": [Object],
      "oidcJWEConfig": null,
      "samlConfig": null,
      "oauthConfig": [Object],
      "casConfig": null,
      "showAuthorizationPage": false,
      "enableSubAccount": false,
      "enableDeviceMutualExclusion": false,
      "loginRequireEmailVerified": false,
      "agreementEnabled": false,
      "isIntegrate": false,
      "ssoEnabled": false,
      "template": null,
      "skipMfa": false,
      "casExpireBaseBrowser": false,
      "appType": "INDIVIDUAL",
      "permissionStrategy": [Object]
    }
  ]
}

修改租户

修改租户

managementClient.tenant.update(tenantId, options);

参数

参数类型必填描述
tenantIdstring是租户 ID
options.namestring否租户名称
options.appIdsstring否应用 ID，支持关联多个应用，使用英文逗号分隔
options.logostring否logo 图标地址，图片上传接口中的 url 值
options.descriptionstring否租户描述

示例

const tenant = await managementClient.tenant.update(
  "6194aeee9ccea057e89738f0",
  {
    name: "qq",
  }
);

返回值

boolean : true / false

删除租户

删除租户

managementClient.tenant.delete(tenantId);

参数

参数类型必填描述
tenantIdstring是租户 ID

示例

const tenant = await managementClient.tenant.delete("6194c58fa1a910549fc62aa5");

返回值

{
  "code": 200,
  "message": "删除租户成功"
}

配置租户品牌化

配置租户品牌化

managementClient.tenant.config(tenantId, options);

参数

参数类型必填描述
tenantIdstring是租户 ID
options.cssstring否自定义 CSS
options.ssoPageCustomizationSettingsobject否ssoPageCustomizationSettings 对象的内容包含以下参数
ssoPageCustomizationSettings.autoRegisterThenLoginboolean否将注册和登录合并
ssoPageCustomizationSettings.hideForgetPasswordboolean否隐藏忘记密码按钮
ssoPageCustomizationSettings.hideIdpboolean否隐藏企业身份源登录
ssoPageCustomizationSettings.hideSocialLoginboolean否隐藏社会化登录按钮

示例

const tenant = await managementClient.tenant.config(
  "6194aeee9ccea057e89738f0",
  { css: ".btnId {\n text-color: #FF00EE}" }
);

返回值

boolean: true / false;

获取租户成员列表

获取租户成员列表

managementClient.tenant.members(tenantId, options);

参数

参数类型必填描述
tenantIdstring是租户 ID
options.pagestring否分页参数，页数。
options.limitstring否分页参数，每页显示个数。当参数 limit = -1 时，将返回所有数据

示例

const tenant = await managementClient.tenant.members(
  "6194aeee9ccea057e89738f0"
);

const tenant = await managementClient.tenant.members(
  "6194aeee9ccea057e89738f0",
  { page: 1, limit: 10 }
);

返回值

  • list 成员列表
  • totalCount 总条数

示例数据

{
  "list": [
    {
      "id": "619b7b5b626abd61ffeebd8e",
      "tenantId": "619b64fd2cfccd07a8296839",
      "user": {
        "id": "619b07826feaa09f07b598de",
        "arn": "arn:cn:authing:619b014f144de0ffc38b869d:user:619b07826feaa09f07b598de",
        "userPoolId": "619b014f144de0ffc38b869d",
        "photo": "https://files.authing.co/authing-console/default-user-avatar.png",
        "email": null,
        "emailVerified": false,
        "phone": null,
        "phoneVerified": false,
        "unionid": null,
        "openid": null,
        "username": "zy",
        "nickname": null,
        "country": null,
        "province": null,
        "company": null,
        "loginsCount": 0,
        "lastIp": null,
        "name": null,
        "givenName": null,
        "familyName": null,
        "middleName": null,
        "profile": null,
        "preferredUsername": null,
        "website": null,
        "gender": "U",
        "birthdate": null,
        "zoneinfo": null,
        "address": null,
        "formatted": null,
        "streetAddress": null,
        "region": null,
        "postalCode": null,
        "city": null,
        "blocked": false
      }
    }
  ],
  "listTotal": 1
}

添加租户成员

添加租户成员，仅支持现用户池内存在的用户。

managementClient.tenant.addMembers(tenantId, userIds);

参数

参数类型必填描述
tenantIdstring是租户标识符 ID
userIdsarray string是用户 ID

示例

const tenant = await managementClient.tenant.addMembers(
  "6194aeee9ccea057e89738f0",
  ["619b07ab229e3bfa98e94ee2"]
);

返回值

{
  "id": "619b64fd2cfccd07a8296839",
  "createdAt": "2021-11-22T09:38:05.696Z",
  "updatedAt": "2021-11-22T09:38:05.696Z",
  "userPoolId": "619b014f144de0ffc38b869d",
  "name": "聚合搜索",
  "logo": null,
  "description": null,
  "css": ".btnId {\n text-color: #FF00EE}",
  "ssoPageCustomizationSettings": null,
  "defaultLoginTab": "password",
  "defaultRegisterTab": "email",
  "passwordTabConfig": {
    "enabledLoginMethods": [
      "username-password",
      "email-password",
      "phone-password"
    ]
  },
  "loginTabs": ["phone-code", "password"],
  "registerTabs": null,
  "extendsFields": null,
  "users": [
    {
      "id": "619b07ab229e3bfa98e94ee2",
      "arn": "arn:cn:authing:619b014f144de0ffc38b869d:user:619b07ab229e3bfa98e94ee2",
      "userPoolId": "619b014f144de0ffc38b869d",
      "photo": "https://files.authing.co/authing-console/default-user-avatar.png",
      "email": null,
      "emailVerified": false,
      "phone": null,
      "phoneVerified": false,
      "unionid": null,
      "openid": null,
      "username": "jl",
      "nickname": null,
      "country": null,
      "province": null,
      "company": null,
      "loginsCount": 0,
      "lastIp": null,
      "name": null,
      "givenName": null,
      "familyName": null,
      "middleName": null,
      "profile": null,
      "preferredUsername": null,
      "website": null,
      "gender": "U",
      "birthdate": null,
      "zoneinfo": null,
      "address": null,
      "formatted": null,
      "streetAddress": null,
      "region": null,
      "postalCode": null,
      "city": null,
      "blocked": false
    }
  ]
}

删除租户成员

删除租户成员

managementClient.tenant.removeMembers(tenantId, userId);

参数

参数类型必填描述
tenantIdstring是租户 ID
userIdstring是用户 ID

示例

await managementClient.tenant.removeMembers(
  "619b64fd2cfccd07a8296839",
  "619b07ab229e3bfa98e94ee2"
);

返回值

  • 无返回值

获取身份源列表

获取身份源列表

managementClient.tenant.listExtIdp(tenantId);

参数

参数类型描述
tenantIdstring租户 ID

示例

const result = await managementClient.tenant.listExtIdp(
  "619b07312d6b99e1af7d8e4e"
);

返回值

[
  {
    "id": "619b33a00412723ba777eabf",
    "name": "身份源名称",
    "type": "lark",
    "tenantId": "619b07312d6b99e1af7d8e4e",
    "connections": [
      {
        "id": "619b33a059f92af971ad4042",
        "type": "lark-internal",
        "identifier": "feishuljl",
        "displayName": "身份源连接名称",
        "logo": null,
        "enabled": true
      }
    ]
  }
]

获取身份源详细信息

获取身份源详细信息

managementClient.tenant.extIdpDetail(extIdpId);

参数

参数类型描述
extIdpIdstring身份源 ID

示例

const result = await managementClient.tenant.extIdpDetail(
  "619b33a00412723ba777eabf"
);

返回值

{
  "id": "619b33a00412723ba777eabf",
  "name": "示例名称",
  "type": "lark",
  "connections": [
    {
      "id": "619b33a059f92af971ad4042",
      "type": "lark-internal",
      "identifier": "feishuljl",
      "displayName": "示例名称",
      "fields": {
        "clientSecret": "d1cuu12KrcItRyD6T",
        "clientID": "cli_a196bf9013",
        "displayName": "示例名称"
      },
      "logo": null,
      "userMatchFields": null
    }
  ]
}

创建身份源

创建身份源

managementClient.tenant.createExtIdp(options);

参数

参数类型必填描述
tenantIdstring否租户 ID，如不填则创建个体型身份源
namestring是身份源名称
typestring是身份源类型，可选值如下：
wechat 微信
connectionsobject array是包含任意多个 “连接对象” 的数组，详见下方说明
  • 连接对象：表示属于该身份源的连接，来自同一身份源的不同连接之间的身份信息可以互通
参数类型必填描述
typestring是连接类型，可选值如下：
wechat:pc 微信 PC 端网页扫码登录
wechat:mobile 原生 APP 内部调用微信登录
wechat:webpage-authorization 微信浏览器内部网页授权登录
wechatmp-qrcode 接收微信公众号扫码、关注事件，自动创建用户
wechat:miniprogram:default 用户自主开发小程序内部登录
wechat:miniprogram:qrconnect 『Authing 小登录』扫码登录
wechat:miniprogram:app-launch 原生 APP 拉起小登录
identifierstring是连接的唯一标识符
displayNamestring是连接在登录页的显示名称
fieldsobject是连接的详细配置信息
userMatchFieldsstring array否用户表自定义匹配字段（只供前端使用）
logostring否连接的 logo

示例

const result = await managementClient.tenant.createExtIdp({
  tenantId: "619b07312d6b99e1af7d8e4e",
  name: "飞书身份源",
  type: "lark",
  connections: [
    {
      type: "lark-internal",
      identifier: "feishusdk",
      displayName: "飞书身份源连接",
      fields: {
        clientSecret: "d1cuu12KrcItRyD6T",
        clientID: "cli_a196bf9013",
        displayName: "飞书身份源连接",
      },
      userMatchFields: ["ss"],
    },
  ],
});

返回值

{
  "id": "619c84ce946e9c1913247af1",
  "name": "飞书身份源",
  "type": "lark",
  "connections": [
    {
      "id": "619c84ce84aac1e944b05ffe",
      "type": "lark-internal",
      "identifier": "feishusdk1",
      "displayName": "飞书身份源连接",
      "fields": [Object],
      "logo": null,
      "userMatchFields": [Array]
    }
  ]
}

更新身份源

更新身份源

managementClient.tenant.updateExtIdp(extIdpId, options);

参数

参数类型必填描述
extIdpIdstring是身份源 ID
options.namestring是身份源名称

示例

await managementClient.tenant.updateExtIdp("619b399e812c47c972900129", {
  name: "飞书身份源",
});

返回值

  • 无返回值

删除身份源

在某个已有身份源下创建新连接

managementClient.tenant.deleteExtIdp(extIdpId);

参数

参数类型必填描述
extIdpIdstring是身份源 ID

示例

await managementClient.tenant.deleteExtIdp("619b399e812c47c972900129");

返回值

  • 无返回值

创建身份源连接

创建身份源连接

managementClient.tenant.createExtIdpConnection(options);

参数

参数类型必填描述
extIdpIdstring是所属身份源 ID
typestring是连接类型
identifierstring是连接的唯一标识符
displayNamestring是连接在登录页的显示名称
fieldsobject是连接的详细配置信息
userMatchFieldsstring array否用户表自定义匹配字段（只供前端使用）
logostring否连接的 logo

示例

test('createExtIdpConnection', async t => {
  const result = await managementClient.tenant.createExtIdpConnection({
    extIdpId: '619c917f534a3b8ad988a209',
    type: 'wechatmp-qrcode',
    identifier: 'wechatc2',
    displayName: '微信身份源连接1',
    fields: {'clientSecret':'d1cuu12KrcItRyD6T','clientID':'cli_a196bf9013','displayName':'飞书身份源连接1'},
    userMatchFields: ['ss']
  });

返回值

{
  "id": "619c9490d7b1cec02bf982f6",
  "type": "wechatmp-qrcode",
  "identifier": "wechatc2",
  "displayName": "飞书身份源连接1",
  "fields": {
    "clientSecret": "d1cuu12KrcItRyD6T",
    "clientID": "cli_a196bf9013",
    "displayName": "飞书身份源连接1"
  },
  "logo": null,
  "userMatchFields": ["ss"]
}

更新身份源连接

更新身份源连接

managementClient.tenant.updateExtIdpConnection(extIdpConnectionId, options);

参数

参数类型必填描述
extIdpConnectionIdstring是身份源连接 ID
options.displayNamestring是连接在登录页的显示名称
options.fieldsobject是连接的详细配置信息
options.userMatchFieldsstring array否用户表自定义匹配字段（只供前端使用）
options.logostring否连接的 logo

示例

await managementClient.tenant.updateExtIdpConnection(
  "619c9490d7b1cec02bf982f6",
  {
    displayName: "微信身份源连接2",
    fields: {
      clientSecret: "d1cuu12KrcItRyD6T",
      clientID: "cli_a196bf9013",
      displayName: "飞书身份源连接1",
    },
    userMatchFields: ["ss"],
  }
);

返回值

  • 无返回值

删除身份源连接

删除身份源连接

managementClient.tenant.updateExtIdpConnection(extIdpConnectionId);

参数

参数类型必填描述
extIdpConnectionIdstring是身份源连接 ID

示例

managementClient.tenant.deleteExtIdpConnection("619c9490d7b1cec02bf982f6");

返回值

  • 无返回值

检查连接唯一标识是否已存在

检查连接唯一标识是已存在

managementClient.tenant.checkExtIdpConnectionIdentifierUnique(identifier);

参数

参数类型必填描述
identifierstring是待检查的标识符

示例

managementClient.tenant.checkExtIdpConnectionIdentifierUnique("wechatc4");

返回值

boolean: true - 已存在 / false - 不存在;

开关身份源连接

开关身份源连接

managementClient.tenant.changeExtIdpConnectionState(
  extIdpConnectionId,
  options
);

参数

参数类型必填描述
extIdpConnectionIdstring是身份源连接 ID
appIdstring否应用 ID，应用开关场景必填
tenantIdstring否租户 ID，租户开关场景必填
enabledboolean是是否开启

示例

const result = await managementClient.tenant.changeExtIdpConnectionState(
  "619cc337075fdb26f5fdbfa2",
  {
    tenantId: "619b64fd2cfccd07a8296839",
    enabled: true,
  }
);

返回值

boolean : true - 操作成功 / false - 操作失败

批量关闭身份源连接

批量关闭身份源连接

managementClient.tenant.batchChangeExtIdpConnectionState(extIdpId, options);

参数

参数类型必填描述
extIdpIdstring是身份源 ID
appIdstring否应用 ID，应用开关场景必填
tenantIdstring否租户 ID，租户开关场景必填
enabledboolean是是否开启

示例

const result = await managementClient.tenant.batchChangeExtIdpConnectionState(
  "619c917f534a3b8ad988a209",
  {
    tenantId: "619b64fd2cfccd07a8296839",
    enabled: true,
  }
);

返回值

boolean: true - 操作成功 / false - 操作失败;

租户下创建组织机构

创建组织机构，会创建一个只有一个节点的组织机构。

OrgManagementClient().create(name, description, code, tenantId);

参数

  • name <string> 组织机构名称，该名称会作为该组织机构根节点的名称。
  • description <string> 根节点描述
  • code <string> 根节点唯一标志，必须为合法的英文字符。
  • tenantId <string> 租户 id。

示例

const org = await managementClient.org.create(
  "北京某某公司",
  "北京某某公司有限公司",
  "example",
  "61d6899f58c07514981da4a3"
);

返回值

{
  "id": "61d69c0c4011cffeea9ac887",
  "rootNode": {
    "id": "61d69c0cf11e11e83d64b87b",
    "orgId": "61d69c0c4011cffeea9ac887",
    "name": "北京某某公司",
    "nameI18n": null,
    "description": "北京某某公司有限公司",
    "descriptionI18n": null,
    "order": null,
    "code": "example",
    "root": true,
    "depth": null,
    "path": ["61d69c0cf11e11e83d64b87b"],
    "createdAt": "2022-01-06T07:36:44+00:00",
    "updatedAt": "2022-01-06T07:36:44+00:00",
    "children": []
  },
  "nodes": [
    {
      "id": "61d69c0cf11e11e83d64b87b",
      "orgId": "61d69c0c4011cffeea9ac887",
      "name": "北京某某公司",
      "nameI18n": null,
      "description": "北京某某公司有限公司",
      "descriptionI18n": null,
      "order": null,
      "code": "example",
      "root": true,
      "depth": 0,
      "path": [Array],
      "createdAt": "2022-01-06T07:36:44+00:00",
      "updatedAt": "2022-01-06T07:36:44+00:00",
      "children": []
    }
  ]
}

获取租户下组织机构

获取租户下组织机构

OrgManagementClient().getOrgByTenantId(tenantId);

参数

  • tenantId <string> 租户 Id 。

示例

const result = await managementClient.org.getOrgByTenantId(tenantId);

返回值

[
  {
    "id": "61d699490abab9f144f296cd",
    "createdAt": "2022-01-06T07:24:57.684Z",
    "updatedAt": "2022-01-06T07:24:57.684Z",
    "userPoolId": "61d53225d92b7010a565e668",
    "orgId": "61d6994988de6be5745ee57c",
    "name": "main",
    "nameI18n": null,
    "description": null,
    "descriptionI18n": null,
    "order": null,
    "code": null,
    "leaderUserId": null,
    "__id": null,
    "__parentid": null,
    "__groupid": null,
    "members": [],
    "children": []
  }
]

租户下组织机构的其他操作

获取租户下组织机构后，可通过组织机构 id 对租户下部门进行增删改查或移除成员，具体请参考 管理组织机构模块

示例：增加一个下级节点

const result = await managementClient.org.getOrgByTenantId(tenantId);
if (result) {
  const { id: orgId } = result[0];
  const node = await managementClient.org.addNode(orgId, orgId, {
    name: "运营部门",
  });
}

示例返回值

{
	"nodes": [{
		"code": null,
		"description": null,
		"updatedAt": "2022-01-06T08:35:31+00:00",
		"children": [],
		"order": null,
		"descriptionI18n": null,
		"depth": 1,
		"orgId": "6142c2c41c6e6c6cc3edf8",
		"path": ["6142c2c4f8abf18c6c978b2c", "614c3c5372b6b3f340ab6937"],
		"nameI18n": null,
		"root": false,
		"id": "614c3c5372b6b3f340ab6937",
		"createdAt": "2022-01-06T08:35:31+00:00",
		"name": "add"
	}],
	"rootNode": {
		"code": "codes",
		"description": "",
		"updatedAt": "2022-01-06T10:24:03+00:00",
		"children": ["614c3c5372b6b3f340ab6937", "6142c32360021c1a05081579", "6142e03436f09aa7e66c1935", "6142e0483f54818690c99600", "6142e07e163a22fd3db10e83"],
		"order": null,
		"descriptionI18n": null,
		"depth": null,
		"orgId": "6142c2c41c6e6c6cc3edfd88",
		"path": ["6142c2c4f8abf18c6c978b2c"],
		"nameI18n": null,
		"root": true,
		"id": "6142c2c4f8abf18c6c978b2c",
		"createdAt": "2022-01-06T04:06:28+00:00",
		"name": "xx2"
	},
	"id": "6142c2c41c6e6c6cc3edfd88"
}

授权资源

用户池管理员可以在用户池内定义一套自定义资源，我们把这些资源叫做你的业务资源。比如说你是一家云服务厂商，那么你可以定义的资源有服务器（ecs）、数据库（dbms）、网关（gateway）、对象存储（oss）等；再比如说你是一家多租户类型的在线教育厂商，你可以定义的资源有课程（courses）、文档（docs）等。

客户在你平台购买服务，本质上也是你将这些资源授权给租户管理员的过程。购买服务的客户，还可以通过设置子账号或者添加管理员的形式，将你平台的服务授权给他所在租户内的成员，这本质上是租户管理员把他所被授权的资源二次授权给租户成员的过程。

方法定义

await managementClient.acl.authorizeResources(params);

此接口用于批量给目标对象（用户、角色、分组、组织机构）授权资源，可以用于用户池管理员给租户管理员授权、用户池管理员给租户成员授权、租户管理员给租户成员授权等场景。如果是租户管理员给租户成员授权，接口会校验此此租户管理员自身有没有被授权过这些资源，且租户管理员只能给本租户下的租户成员和组织机构授权，不能垮租户授权。

参数

params 类型定义：

export interface AuthorizeResourcesParams {
  /**
   * 权限分组的 code
   */
  namespace: string;

  /**
   * 租户的 ID。如果是给租户下的用户、组织机构授权，此参数必填。
   */
  tenantId?: string;

  /**
   * 授权项目，每一项分别给不同类型的主体授权不同的资源
   */
  opts: {
    targetType: PolicyAssignmentTargetType;
    targetIdentifiers: string[];
    resources: {
      code: string;
      actions: string[];
      resourceType: ResourceType;
    }[];
  }[];
}

参数释义

参数类型必填描述
namespacestring是资源所在的权限分组 code
tenantIdstring否租户 ID，租户授权场景必填
optsArray是一个数组，数组中的每个元素描述的是需要给什么对象，授权哪些资源
opts.targetTypestring是授权对象的类型，一个资源可以被授权给用户、角色、分组、组织机构（如果是租户内的资源授权，目前只支持授权给用户和组织机构）。可选值为 USER, ROLE, GROUP, ORG。
opts.targetIdentifiersArray是授权目标对象的唯一标志符。如果是用户，为用户 ID；如果是角色，为角色 code；如果是分组，为分组 code；如果是组织机构部门，为部门 ID。
opts.resourcesArray是一个数组，数组中的每个元素描述的是需要授权的资源。code 表示授权资源的标志，可以是一类资源，如 ecs:*，也可以是某个具体的资源，如 ecs:1；actions 表示需要授权的操作；resourceType 指的是这个资源的类型，可选值包含 DATA、API、MENU、UI、BUTTON。

用户池管理员给租户管理员授权资源

用户池管理员给租户管理员授权资源的过程，可以理解为租户在你的平台开通服务，或者体验试用版本的过程。

示例

租户购买了 ID 为 1 的 ECS 服务器，用户池管理员将 ecs:1 资源的 ecs:* 操作（所有 ECS 相关操作）授权给了租户管理员。

import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.acl.authorizeResources({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  opts: [
    {
      targetType: PolicyAssignmentTargetType.User,
      targetIdentifiers: ["TENANT_ADMIN_ID"],
      resources: [
        {
          code: `ecs:1`,
          actions: ["ecs:*"],
          resourceType: ResourceType.Data,
        },
      ],
    },
  ],
});

返回数据

boolean: true - 操作成功 / false - 操作失败;

租户管理员给租户成员授权资源

租户管理员给租户成员授权资源，可以理解为租户管理员把这些资源再分配给租户内的用户、组织机构的过程，使得租户成员可以访问、操作这些资源。租户管理员给租户成员授权资源有两点限制：

  1. 租户管理员只能授权自身被授权过的资源；
  2. 租户管理员只能给本租户内的用户、组织机构进行授权，不能跨租户进行操作。

示例

租户购买了 ID 为 1 的 ECS 服务器后，租户管理员希望授权 IT 部的超级运维人员此台服务器的所有操作，同时授权 IT 部门启动（Start）、停止（Stop）、重启（Restart）、修改基本信息（UpdateBasicInformation）、查询服务器监控信息（ViewMonitoringStatistics）等操作。

  1. 首先使用租户管理员的 token 和租户 ID 初始化 ManagementClient，不再使用用户池全局的 userPoolId 和 secret 进行初始化：
import { ManagementClient } from "authing-js-sdk";

const managementClient = new ManagementClient({
  tenantId: "TENANT_ID",
  accessToken: "租户管理员的 Token",
});
  1. 租户管理员分别对 IT 部的超级运维人员和 IT 部门进行授权
import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.acl.authorizeResources({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  opts: [
    {
      targetType: PolicyAssignmentTargetType.User,
      targetIdentifiers: ["IT 部超级运维人员的 ID"],
      resources: [
        {
          code: `ecs:1`,
          actions: ["ecs:*"],
          resourceType: ResourceType.Data,
        },
      ],
    },
  ],
});

import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.acl.authorizeResources({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  opts: [
    {
      targetType: PolicyAssignmentTargetType.Org,
      targetIdentifiers: ["IT 部门的 ID"],
      resources: [
        {
          code: `ecs:1`,
          actions: [
            "ecs:Start",
            "ecs:Stop",
            "ecs:Restart",
            "ecs:UpdateBasicInformation",
            "ecs:ViewMonitoringStatistics",
          ],
          resourceType: ResourceType.Data,
        },
      ],
    },
  ],
});

而以下操作是不被允许的，因为 ecs:2（ID 为 2 的 ECS 服务器）没有被授权给租户管理员，即此租户没有购买此台服务器：

import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.acl.authorizeResources({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  opts: [
    {
      targetType: PolicyAssignmentTargetType.User,
      targetIdentifiers: ["IT 部超级运维人员的 ID"],
      resources: [
        {
          code: `ecs:2`,
          actions: ["ecs:*"],
          resourceType: ResourceType.Data,
        },
      ],
    },
  ],
});

返回数据

boolean: true - 操作成功 / false - 操作失败;

撤销资源

方法定义

await managementClient.acl.revokeResources(params);

参数

params 类型定义：

export interface RevokeResourcesParams {
  /**
   * 权限分组的 code
   */
  namespace: string;

  /**
   * 租户的 ID。如果是给租户下的用户、组织机构授权，此参数必填。
   */
  tenantId?: string;

  /**
   * 授权项目，每一项分别给不同类型的主体授权不同的资源
   */
  opts: {
    targetType: PolicyAssignmentTargetType;
    targetIdentifiers: string[];
    resources: {
      code: string;
      actions: string[];
      resourceType: ResourceType;
    }[];
  }[];
}

参数释义

参数类型必填描述
namespacestring是资源所在的权限分组 code
tenantIdstring否租户 ID，租户授权场景必填
optsArray是一个数组，数组中的每个元素描述的是需要给什么对象，授权哪些资源
opts.targetTypestring是授权对象的类型，一个资源可以被授权给用户、角色、分组、组织机构（如果是租户内的资源授权，目前只支持授权给用户和组织机构）。可选值为 USER, ROLE, GROUP, ORG。
opts.targetIdentifiersArray是授权目标对象的唯一标志符。如果是用户，为用户 ID；如果是角色，为角色 code；如果是分组，为分组 code；如果是组织机构部门，为部门 ID。
opts.resourcesArray是一个数组，数组中的每个元素描述的是需要授权的资源。code 表示授权资源的标志，可以是一类资源，如 ecs:*，也可以是某个具体的资源，如 ecs:1；actions 表示需要授权的操作；resourceType 指的是这个资源的类型，可选值包含 DATA、API、MENU、UI、BUTTON。

用户池管理员撤销租户管理员的资源

用户池管理员撤销租户管理员的资源权限，此操作可以用于租户服务到期之后、租户发起退款、试用到期等情况。

示例

租户管理员购买了 ecs:1 服务器一年的使用期限，到期之后不再续费，此时用户池管理员可以收回此项权限：

import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.acl.revokeResources({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  opts: [
    {
      targetType: PolicyAssignmentTargetType.User,
      targetIdentifiers: ["TENANT_ADMIN_ID"],
      resources: [
        {
          code: `ecs:1`,
          actions: ["ecs:*"],
          resourceType: ResourceType.Data,
        },
      ],
    },
  ],
});

返回数据

boolean: true - 操作成功 / false - 操作失败;

租户管理员撤销租户成员的资源权限

租户管理员撤销租户成员的资源权限，此操作可以用户租户成员离职、换岗等情况。和授权资源，此操作也有两点限制：必须是租户管理员自身被授予的资源，只能操作本租户下的用户和组织机构。

  1. 首先使用租户管理员的 token 和租户 ID 初始化 ManagementClient，不再使用用户池全局的 userPoolId 和 secret 进行初始化：
import { ManagementClient } from "authing-js-sdk";

const managementClient = new ManagementClient({
  tenantId: "TENANT_ID",
  accessToken: "租户管理员的 Token",
});
  1. IT 部超级运维人员离职之后，撤销他所被授权的资源。
import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.acl.revokeResources({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  opts: [
    {
      targetType: PolicyAssignmentTargetType.User,
      targetIdentifiers: ["IT 部超级运维人员的 ID"],
      resources: [
        {
          code: `ecs:1`,
          actions: ["ecs:*"],
          resourceType: ResourceType.Data,
        },
      ],
    },
  ],
});

返回数据

boolean: true - 操作成功 / false - 操作失败;

获取被授权的资源列表

用户池管理员可以获取租户管理员被授权的资源列表，租户管理员可以获取租户下成员、组织机构部门被授权的资源列表。租户管理员不能获取不在此租户的成员被授权的资源。

方法定义

await managementClient.acl.listAuthorizedResourcesBatch(params);

参数类型

params 类型定义：

export interface ListAuthorizedResourcesBatchParams {
  /**
   * 权限分组的 code
   */
  namespace: string;

  /**
   * 租户的 ID。如果是给租户下的用户、组织机构授权，此参数必填。
   */
  tenantId?: string;

  /**
   * 目标对象列表
   */
  targets: {
    targetType: PolicyAssignmentTargetType;
    targetIdentifier: string;
  }[];

  /** 授权的资源类型 */
  resourceType?: ResourceType;
}

参数

参数类型必填描述
namespacestring是权限分组的 code
tenantIdstring否租户 ID，如果是需要获取用户、组织机构在某个租户下具备的权限，此参数必填。
resourceTypestring否resourceType 指的是这个资源的类型，可选值包含 DATA、API、MENU、UI、BUTTON。
targetsstring是targetType：授权对象的类型，一个资源可以被授权给用户、角色、分组、组织机构（如果是租户内的资源授权，目前只支持授权给用户和组织机构）。可选值为 USER, ROLE, GROUP, ORG。targetIdentifier： 授权目标对象的唯一标志符。如果是用户，为用户 ID；如果是角色，为角色 code；如果是分组，为分组 code；如果是组织机构部门，为部门 ID。

示例

const data = await managementClient.acl.listAuthorizedResourcesBatch({
  namespace: "NAMESPACE_CODE",
  tenantId: "TENANT_ID",
  targets: [
    {
      targetType: PolicyAssignmentTargetType.User,
      targetIdentifier: "USER_ID",
    },
    {
      targetType: PolicyAssignmentTargetType.Group,
      targetIdentifier: "GROUP_CODE",
    },
    {
      targetType: PolicyAssignmentTargetType.Role,
      targetIdentifier: "ROLE_CODE",
    },
    {
      targetType: PolicyAssignmentTargetType.Org,
      targetIdentifier: "NODE_ID",
    },
  ],
});

返回数据

返回数据中的 list 是一个数组，数组的顺序对应传入的 targets，值对应此 target 被授权的资源列表。

示例：

{
  "list": [
    {
      "totalCount": 1,
      "list": [
        {
          "code": "ecs:1",
          "actions": ["ecs:*"]
        }
      ]
    },
     {
      "totalCount": 0,
      "list": []
    },
     {
      "totalCount": 1,
      "list": [
        {
          "code": "ecs:2",
          "actions": ["ecs:Start"]
        }
      ]
    },
     {
      "totalCount": 1,
      "list": [
        {
          "code": "ecs:3",
          "actions": ["ecs:*"]
        }
      ]
    }
  ]
}

判断用户是否能操作某个资源

方法定义

await managementClient.acl.isAllowed(userId, resource, action, options);

参数

参数类型必填描述
userIdstring是用户 ID code
resourcestring是资源描述符，可以是一类资源，如 ecs:*，也可以是具体的某一个资源，如 ecs:1
actionstring是资源对应的操作，如 ecs:Start
options.namespacestring否资源所在的权限分组，如果不填，默认使用「默认权限分组」
options.tenantIdstring是租户 ID，如果是需要获取用户在某个租户下具备的权限，此参数必填。

示例

判断 TENANT_USER_ID 在租户 TENANT_ID 下是否具备资源 ecs:1 的 ecs:Start 操作权限：

import { PolicyAssignmentTargetType } from "authing-js-sdk";

const allowed = await managementClient.acl.isAllowed(
  "TENANT_USER_ID",
  "ecs:1",
  "ecs:Start",
  {
    namespace: "NAMESPACE_CODE",
    tenantId: "TENANT_ID",
  }
);

返回数据

boolean: true - 具备权限 / false - 不具备权限;

设置租户管理员

方法定义

await managementClient.tenant.setTanentAdmin(tenantId, options);

参数

参数类型必填描述
tenantIdstring是租户 ID
options.userIdsstring[]是用户 ID 集合

示例

import { PolicyAssignmentTargetType } from "authing-js-sdk";

test('setTanentAdmin', async t => {
    const result = await managementClient.tenant.setTanentAdmin('619c917f534a3b8ad988a209', {
        userIds:['11','22']
    });
    console.log(result)
    t.assert(result);
});

返回数据

boolean: true - 成功 / false - 失败;

取消租户管理员

方法定义

await managementClient.tenant.deleteTanentAdmin(tenantId, options);

参数

参数类型必填描述
tenantIdstring是租户 ID
options.userIdsstring[]是用户 ID 集合

示例

import { PolicyAssignmentTargetType } from "authing-js-sdk";

test('setTanentAdmin', async t => {
    const result = await managementClient.tenant.deleteTanentAdmin('619c917f534a3b8ad988a209', {
        userIds:['11','22']
    });
    console.log(result)
    t.assert(result);
});

返回数据

boolean: true - 成功 / false - 失败;

更新租户成员

方法定义

await managementClient.tenant.updateTenantMember(tenantId, userId, isEnabled);

参数

参数类型必填描述
tenantIdstring是租户 ID
userIdstring是用户 ID
isEnabledboolean是是否禁用

示例

import { PolicyAssignmentTargetType } from "authing-js-sdk";

test('updateTenantMember', async t => {
    const result = await managementClient.tenant.updateTenantMember('619c917f534a3b8ad988a209', '111',true
    );
    console.log(result)
    t.assert(result);
});

返回数据

boolean: true - 成功 / false - 失败;

批量新增资源

方法定义

await managementClient.tenant.batchInsertResource(options);

参数

参数类型必填描述
codestring是资源 CODE
typestring是资源类型
descriptionstring否资源描述
actions.namestring是操作名称
actions.descriptionstring是操作描述
apiIdentifierstring否是否禁用
namespacestring否资源空间，默认为 default

示例

import { PolicyAssignmentTargetType } from "authing-js-sdk";

test('batchInsertResource', async t => {
    const result = await managementClient.tenant.batchInsertResource({
            bulk: [
                {
                    code: '6666',
                    type: ResourceType.Data,
                    description: "666",
                    actions: [
                        {
                            name: "action666",
                            description: "description666",
                        }
                    ],
                    apiIdentifier : '666',
                    namespace : 'default',
                },

                {
                    code: '777',
                    type: ResourceType.Data,
                    description: "777",
                    actions: [
                        {
                            name: "action777",
                            description: "description777",
                        }
                    ],
                    apiIdentifier : '777',
                    namespace : 'default',
                }
            ]
        }
    );
    console.log(result)
    t.assert(result);
});

返回数据

boolean: true - 成功 / false - 失败;