应用开发 —— 从 Authing 开始
本文使用 Authing 实现一个基于 Web 的登录退出应用，同时为了简单起见，本文不使用任何高级前端框架。
开发前准备
学习目标
预备知识
所需工具
可以在本地运行的 Web 服务器（比如：npm install http-server -g）
第零步：注册 Authing 账号并创建一个应用
第一步：配置一个基本的 HTML 页面和 CSS
创建一个空白的 HTML 文档用来编写 Authing 程序：
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Authing Hello World</title>
<style>
.btn {
background-color: #45bbee;
border: none;
border-radius: 4px;
padding: 5px 10px;
color: #fff;
}
.btn:hover {
background-color: #45aaff;
cursor: pointer;
}
</style>
</head>
<body>
<script src="https://cdn.jsdelivr.net/npm/jquery"></script>
<script>
// Custom Codes
</script>
</body>
</html>
示例中使用了 jQuery。
本教程只是为了演示，因此我们没选择其他更加高级的框架，这可以让我们专注于 Authing 本身。
第二步：增加登录状态 UI 元素
增加一段 HTML 到 HTML 页面中，用处是显示已经登录用户的用户名和完整用户信息（一段 JSON 字符串），并且又一个「退出」按钮可以用来退出。
<div id="logout" style="display: none">
你已登录，用户名为：<span id="user"></span>。
<div>
完整用户信息：
<code id="userInfo"></code>
</div>
<button class="btn" id="logout-btn" style="margin-top:11px">退出</button>
</div>
第三步：增加 Authing 身份认证表单
<script src="https://cdn.jsdelivr.net/npm/@authing/guard@1.9.10/dist/Guard.umd.min.js">
</script>
将脚本文件放到入口脚本之前即可。
使用该库可以生成一个登录表单，其样式如下图所示：
调用方法非常简单，代码如下所示：
const form = new Guard('userPoolId', {
// 时间戳，不填则默认生成当前时间戳
timestamp: Math.round(new Date() / 1000),
// 随机数，不填则默认生成随机数
nonce: Math.ceil(Math.random() * Math.pow(10, 6)),
// 设置登录表单标题
title: '第一个应用',
// 小程序扫码登录配置
qrcodeScanning: {
redirect: false,
}
});
所需参数解释如下：
timestamp：当前时间戳 Math.round(new Date() / 1000)
qrcodeScanning
redirect: 是否执行跳转（在用户后台配置的 URL），若值为 false，用户数据可通过 .on('authenticated') 监听函数得到.
userPoolId 参数获取方式如下：
第四步：监听登录成功事件并显示用户名
登录成功的事件名称为「authenticated」：
const form = new Guard('userPoolId', {
// 时间戳，不填则默认生成当前时间戳
timestamp: Math.round(new Date() / 1000),
// 随机数，不填则默认生成随机数
nonce: Math.ceil(Math.random() * Math.pow(10, 6)),
// 设置登录表单标题
title: '第一个应用',
// 小程序扫码登录配置
qrcodeScanning: {
redirect: false,
}
});
form.on('authenticated', function(user) {
// 成功登录后的回调事件，参数 user 为用户数据
localStorage.setItem('userInfo', JSON.stringify(user)); // 存储用户 id 到 localStorage 中
localStorage.setItem('userId', user._id); // 存储用户 id 到 localStorage 中
localStorage.setItem('username', user.username); // 存储用户 username 到 localStorage 中
localStorage.setItem('token', user.token); // 存储用户的 JWT Token 到 localStorage 中
form.hide(); // 为了简单起见，这里在登录成功后直接隐藏表单，在 React 或 Vue 应用中，你可以执行路由跳转或其他业务
showLoginStatus(); // 改变 UI 状态，显示用户名和完整的用户 JSON 信息
});
const showLoginStatus = () => {
$('#logout').show(); // 显示退出按钮
$('#user').html(localStorage.getItem('username')); // 显示用户名
$('#userInfo').html(localStorage.getItem('userInfo')); // 显示完整的用户信息
}
第五步：调试登录/注册功能
到第四步为止，恭喜你已经完成了登录和注册功能，现在让我们运行程序体验一下。
调试 Authing 程序需要启动一个 Web 服务器，推荐 http-server，如果你还未安装 http-server，那么请使用下面的命令进行安装：
$ npm install http-server -g
安装完成后请进入项目根目录然后执行以下命令：
如果你看到下列输出（端口可能不同），那么代表已经启动成功：
Starting up http-server, serving ./
Available on:
http://127.0.0.1:8080
http://192.168.0.103:8080
Hit CTRL-C to stop the server
现在让我们用浏览器打开 http://127.0.0.1:8080，应该可以看到如下界面：
此时，请先点击「注册」按钮注册一个账户：
登录完成后可以看到如下信息：
登录后能看到此界面表明已经调试成功了。
第六步：为退出按钮增加事件
到上一步，我们完成了登录功能并体验了流程，下面，我们还需要支持退出功能：
退出功能需要用到 authing 对象的 logout 方法，authing 对象需要在 authing-load 事件中获取，代码如下：
form.on('authing-load', async function(authing) {
// Authing 实例加载成功后的回调函数，参数 authing 为 authing 对象
// 使用 checkLoginStatus 方法判断当前的登录状态，需要使用 await
// 如已经登录则隐藏登录框并显示当前的用户信息
// 这段代码的作用是用户如果已经登录，那么刷新后还可以看到自己的用户信息
const token = localStorage.getItem('token')
const result = await authing.checkLoginStatus(token);
if (result.status) {
// 隐藏登录框
form.hide();
// 显示用户基础信息
showLoginStatus();
}
// 使用 jQuery 监听退出按钮的点击事件
$('#logout-btn').click(async function() {
// 使用 logout 方法，并传入用户的 userId 进行退出
await authing.logout(localStorage.getItem('userId'));
alert('退出成功');
// 刷新页面，此时可以重新看到登录框
location.reload();
});
})
最后，我们来测试下退出功能。
请打开浏览器，刷新页面，点击「退出」，稍等片刻后可以看到页面弹出了下面这个提示：
点击弹出对话框的「OK」或「确认」按钮后可以看到页面重新启用了登录框：
恭喜你，到此为止，你已经学会了如何使用 Authing 开发第一个应用。
若你想要了解更多 Guard 的使用方法，下面有几个链接可供参考：
接下来你可能还需要
使用 Authing 实现单点登录：
学习 Authing 的基础知识以及我们会用到的专业术语：
使用 Authing 实现单点登录：
控制台是你管理所有 Authing 资源的地方，了解 Authing 控制台各模块包含的内容和你可以在控制台中做的事情：
了解 Authing 提供的多种部署模型，以帮助你选择该以怎样的形式部署 Authing：
