基础概念

学习 Authing 的基础知识以及我们会用到的一些术语。

在科技领域，学习新知识最大的障碍就来自于「术语」，当你试图去了解一个新概念时，大量的术语将会对你的理解造成阻碍。本文将会解释 Authing 中的常用术语，以期能帮助你尽快熟悉在 Authing 中涉及到的知识。

本文将介绍用户池、账户、通信、域名和第三方登录等概念，如果你对这些概念比较熟悉，可以放心跳过本章。

我们会假设有一家名为「非凡」的科技公司，其公司人数有 300 多人，这家公司想使用 Authing 对他们的 Web 应用进行用户名密码和微信认证，同时希望能管理自己内部的软件系统，实现员工对内部软件的单点登录。

用户池

注册完 Authing 账户后，你看到的是一个空白的列表页，此时你需要创建一个用户池。拥有了一个用户池之后你可以授权其他应用（第三方应用或者你自己写的应用）读取用户数据，授权协议支持 OAuth2.0、OIDC、SAML 和 LDAP。

创建应用时可以选择如下四种类型：

每一个用户池都有一个唯一的 userPoolId，比如「5cc59bdf1bbaf0188cce6d84」，这个 userPoolId 是不可修改的，主要用来标识你的用户池；除了 userPoolId ，每一个用户池还有一个 secret，userPoolId 和 secret 可以在代码层面授权开发者访问用户池内的用户数据（包含注册、登录、退出、修改资料、删除用户等操作）。

userPoolId 和 secret 在控制台中的查看位置如下图所示：

如上图所示，如果你的 secret 不小心泄漏，可以通过「刷新」按钮重置 secret。但是请注意，如果你在某些程序中使用了该 secret，那么使用该 secret 的程序也必须要手动更新 secret，否则会造成该程序的「身份认证功能」毁坏。

在本文的例子中，「非凡科技」有一个 Web 应用，所以他选择的应用类型为「Web」，并为此应用取名为「非凡科技用户池」。

如果你有很多独立的系统，那么可以创建多个「用户池」来分割用户，如果你想多个应用共用一个用户池，请先学习我们的单点登录概念。

账号

账号是你创建的用户池中的单个用户。每一个账号都有一个唯一的 _id，你在使用 Authing 时可以将此 _id 存入你自己的数据库中，然后与自己的具体业务进行联表。

单个账号可以使用四种基础方式进行登录：

邮箱 - 密码登录
手机 - 验证码登录
小程序扫码登录
社会化网络登录（微信登录、Github 登录等）

你可以在控制台中创建用户：

在本文的例子中，「非凡科技」创建了一个邮箱为「test@feifantech.com」的账号用来测试 Authing 的账号系统。

在「原始 JSON 数据」选项卡中可以看到一段用来表示该账号的 JSON 数据：

{
	"_id": "5e3f8211abc507cd902f2b3c",
	"email": "test@feifantech.com",
	"phone": "",
	"emailVerified": false,
	"username": "tester",
	"nickname": "",
	"unionid": null,
	"openid": null,
	"company": "",
	"photo": "https://usercontents.authing.cn/authing-avatar.png",
	"browser": "",
	"device": "",
	"registerInClient": "5cce4aa83ed9f97b4dfd95f0",
	"registerMethod": "default:username-password",
	"oauth": "",
	"token": null,
	"tokenExpiredAt": "Invalid date",
	"loginsCount": 0,
	"lastLogin": "2020-02-09T11:52:49+08:00",
	"lastIP": null,
	"signedUp": "2020-02-09T11:52:49+08:00",
	"blocked": false,
	"isDeleted": false,
	"group": {
		"_id": "5a597f35085a2000144a10ef",
		"name": "default",
		"descriptions": "default",
		"createdAt": "2018-01-13T11:38:29+08:00"
	},
	"clientType": null,
	"userLocation": [],
	"userLoginHistory": {
		"totalCount": 0,
		"list": []
	},
	"systemApplicationType": null
}

用户组和权限

Authing 中可以配置每个账号所属的用户组和用户组权限，如果你想深入使用用户组和权限请参考用户权限一章。

消息

消息是 Authing 提供的邮件发送和短信发送能力。

在 Authing 中，使用邮箱注册的用户在注册成功后会收到两封邮件，一封是「欢迎邮件」，另一封是「用来验证邮箱是属于注册者自己的验证邮件」，这由 Authing 的邮件服务器进行发送。

如果你想修改邮件模版，可以选择「邮件模版」进行配置。

如果你想邮件发送服务器，可以选择「第三方邮件服务」进行配置。

此外，如果用户使用手机 - 验证码登录，那么其背后的短信发送也由 Authing 完成，Authing 的短信发送能力依赖于第三方短信服务。

在本文的例子中，「非凡科技」修改了邮件模版，将邮件主题「你已成功注册 {{ client_name }}」修改为了「欢迎注册 {{ client_name }}」。

Authing 的邮件模版支持宏命令，可以包括以下宏：

{{ client_name }}：邮件正文中的 {{ client_name }} 会被替换成当前应用的名称；
{{ time }}：邮件正文中的 {{ time }} 会被替换为当前时间；
{{ client_description }}：邮件正文中的 {{ client_description }} 会被替换成当前应用的描述（在应用配置中可进行修改）；
{{ user_email }}：邮件正文中的 {{ user_email }} 会被替换成当前注册用户的邮箱。