Authing 文档

# 导入导出用户

# 使用 Excel 导入用户

在 用户管理 - 用户列表 页面，点击右上角的 导入 按钮，选择 通过 Excel 导入：

下载好 Excel 模版，修改过后，点击上传或者拖拽 Excel 文件，即可完成用户导入。

# 通过代码导入用户

# 第一步：关闭频繁注册限制

开始导入用户前，请进入设置 -> 安全信息，关闭「频繁注册限制」，导入完毕后再开启。

# 第二步：编写密码函数计算（可选）

如果你的用户数据表中密码字段是明文，可以跳过此步骤；如果是密文，需要进入扩展能力 -> 自定义密码加密开启选项并编写用于加密和验证密码的函数。

# 第三步：导出你的用户数据

请将你的用户数据导出为 JSON 格式，内容为一个数组，每个元素是一个对象，其中一个元素对应一条用户的信息，例如：

[
  {
    "uid": "1",
    "nickname": "zhang",
    "account_id": "zhang",
    "mail": "test1@123.com",
    "password": "$2b$12$nCa3WDbsc3tvM57ifzjwrOAGGuNK7EPV0R17WKcW6f13NZvX97yLe",
    "phone": "13100000001"
  },
  {
    "uid": "2",
    "nickname": "wang",
    "account_id": "wang",
    "mail": "test2@123.com",
    "password": "$2b$12$HGloOlfz1HzD0v/r5m1r7OCMcx6X85eC5.At3Ckxe.Jn/u/Za/yy2",
    "phone": "13100000002"
  },
  {
    "uid": "3",
    "nickname": "zhao",
    "account_id": "zhao",
    "mail": "test3@123.com",
    "password": "$2b$12$ia1oUZZFbEUpLvuqUsKideQq9lVkf2kq9vFaTvp7dlfeCx8UlTmDu",
    "phone": "13100000003"
  }
]

# 第四步：导入用户数据到 Authing

如果你没有 NodeJS 环境，需要先安装 NodeJS (opens new window)。

创建一个 index.js 文件。

将以下 js 脚本粘贴到 index.js：

const fs = require("fs");
const path = require("path");

const Authing = require("authing-js-sdk");
const secret = "xxxxxxxxxxxxxxxxxxx";
const clientId = "xxxxxxxxxxxxxxxxxxx";

// 如果文件较大建议分批次读入
// 请将用户信息与本文件保存在同一个目录，文件内容为用户数据的数组 JSON，一个元素为一个用户的信息对象
let users = fs.readFileSync(path.resolve('users.json'), { encoding: "utf8" });
users = JSON.parse(users);
async function main() {
	const authing = new Authing({
	    userPoolId: clientId,
	    secret
	});


  for (let i = 0; i < users.length; i++) {
  	let yourUser = users[i];
    try {
      // 在此完成字段对齐
      let registerResult = await authing.register({
        /**
         * 开启这个开关，password 字段会直接写入 Authing 数据库，Authing 不会再次加密此字段
         * 如果你的密码不是明文存储，你应该保持开启，并编写密码函数计算
         */
        keepPassword: true,
        nickname: yourUser.nickname,
        password: yourUser.password,
        email: yourUser.mail,
        phone: yourUser.phone,

        // 存储原始数据，以备使用
        oauth: JSON.stringify(yourUser),
        // 如果有微信、微博等注册方式应该也要填一下，这里对具体业务绑定性挺强的
        // registerMethod 可选值为 default:username-password social:qq social:dingtalk social:weibo oauth:github oauth:wechat oauth:wxapp
        registerMethod: yourUser.githubId
          ? "oauth:github"
          : "default:username-password"
      });
      if (!registerResult._id) {
        throw Error("注册失败");
      }
    } catch (err) {
      console.log(err);
      // 将导入失败的用户写入文件
      fs.writeFileSync(path.resolve('users_failed.json'), JSON.stringify(yourUser) + "\n", {
        flag: "a"
      });
    }
  }
}

main();

复制完成后请对字段进行对齐，再执行

$ npm install authing-js-sdk
$ node index.js

代码可在 Github 查看：users-migration (opens new window)

遇到问题？联系我们 (opens new window)，Feel free to talk.

# 导出用户为 Excel

在 用户管理 - 用户列表 页面，点击右上角的 导出 按钮，选择 导出选中用户 或 导出全部用户：

之后你可以在导出历史页面查看导出进度：

点击下载按钮，即可下载导出的 Excel:

← 搜索用户 →