suqin-aad

suqin的一款插件, 使其支持Azure AD账号体系的通讯录操作.

主要功能

• 对Group的增删改查操作
• 对User的增删改查操作, 该资源在API中使用member进行描述

API列表

read API

• 查询成员列表readMembers
• 查询成员详情readMember
• 校验用户是否存在verifiyMember
• 查询群组列表readGroups
• 查询群组详情readGroup
• 查询指定用户所属部门readMemberBelong

write API

• 创建成员createMember
• 删除成员deleteMember
• 修改成员updateMember
• 创建群组createGroup
• 删除群组deleteGroup
• 修改群组updateGroup
• 添加群组成员addGroupMember
• 删除群组成员deleteGroupMember

使用方法

const Suqin = require('suqin');
const AAD = require('suqin-aad');

const directories = new Suqin();

const opts = {
  tenlentId: 'your tenlentId',
  clientId: 'your clientId',
  userName: 'your userName',
  userPassword: 'your userPassword',
  baseUrl: 'chinacloudapi.cn',
  name: 'AAD',
};

const azureAD = new AAD(opts);

directories.use(azureAD);

// member为您要创建的成员, 其数据结构请参考AzureAD Graph API reference
directories.createMember('AAD', member)
  .then(res => res.data, err => err.data);

directories.readMembers('AAD')
  .then(res => res.data, err => err.data);

注意事项

• 全部代码使用ES6进行编写, 您可能需要babel的协助
• 执行测试时请先行配置以下环境变量
  • AAD_TENLENT_ID Azure AD 租户ID
  • AAD_CLIENT_ID Azure AD 应用客户端ID
  • AAD_USER_NAME Azure AD 用户名
  • AAD_USER_PASSWORD Azure AD 用户密码
  • AAD_BASE_URL Azure AD Graph API 主域
  • AAD_NAME 本插件在suqin体系内的注册名

参考资料

• Azure AD Graph API reference