Node-RED - 二、编辑器添加用户认证

Node-RED - 二、编辑器添加用户认证

Node RED是一种基于流的编程工具，最初由IBM的新兴技术服务团队开发，现在是OpenJS基金会的一部分。
它提供了一个基于浏览器的可视化编辑器面板，在面板中通过拖拽节点的方式可以实现将将硬件设备、API和在线服务连接在一起，面板中大量节点轻松地将流连接在一起，只需单击一下即可将其部署到运行时。

• 详情进入【 官方网站】进行了解

Node-RED系列文章：
1、Node-RED - 一、添加自定义节点
2、Node-RED - 二、编辑器添加用户认证
3、Node-RED - 三、通过接口操作流程

一、准备

1、本例要实现的目标说明

• 一般情况下，Node-RED不会单独做为一个系统来使用，而是与其它业务系统集成使用，通过Node-RED来完成流程的配置，然后与业务系统集成做为一个完整的系统为用户提供完成的服务。

• 本例为Node-RED编辑器页面添加用户认证，这样便于与业务集成，否则没有认证直接集成后，对业务系统的安全造成了极大的威胁。

2、Node-RED系统搭建

参见【Node-RED中添加自定义节点】

3、Node-RED身份认证方式

Node-RED编辑器和Admin Api支持下面两种身份认证方式

• 1、基于用户名、密码和身份认证
• 2、针对任何OAuth/OpenID提供程序（如Twitter或GitHub）的身份验证

※ 说明：
本例中只实现 基于用户名、密码和身份认证，如果想了解基于OAuth/OpenID的身份认证请参见【官方文档-Securing Node-RED】

二、设置身份认证

1、启用身份认证的配置文件

1）、配置文件位置

配置身份认证的配置文件是settings.js，位置是在Node-RED的用户目录

序号	系统	位置
1	Windows	C:\Users\用户名.node-red\settings.js
2	Linux	~/.node-red/settings.js，或/home/用户名/.node-red/settings.js

※ 说明：

• 如果您还未运行Node-RED,在Node-RED的用户目录还没有配置文件，您可以手动复制node-red/packages/node_modules/node-red/settings.js 到目标位置。
• 也可以在在Node-RED启动时，通过命令行参数–settings指定配置文件。

2）、配置文件加载机制

• 当Node-RED启动时，就会从Node-RED的用户目录查找settings.js，如果没有找到，就把默认配置文件复制到Node-RED的用户目录并使用它。
• 或者在Node-RED启动时，通过命令行参数–settings指定不同的配置文件。

2、在编辑器或Admin API上启用身份认证

1）、在配置文件启用身份认证

将setting.js文件中下面的代码解注即可

/** To password protect the Node-RED editor and admin API, the following
 * property can be used. See http://nodered.org/docs/security.html for details.
 */
adminAuth: {
	type: "credentials",
	users: [{
		username: "admin",
        password: "$2a$08$cbwARregfRdxFgxFdeaTMeHM72JXqCG4N78o61aUQg1NvOec3VrLO",
        permissions: "*"
    }]
},

注意：在Node RED的早期版本中，可以使用设置httpAdminAuth在编辑器上启用HTTP基本身份验证。此选项已弃用，不应使用

※ 说明：

• users：是一个用户身份对象数组，可以配置多个身份对象，且每个用户具有不同的权限。
• password：密码是使用bcrypt算法安全散列的，上面是根据下面命令对123456加密后的密码。

2）、生成Hash密码

• 方式一：进入Node-RED安装目录，并通过node -e命令来生成

 node -e "console.log(require('bcryptjs').hashSync(process.argv[1], 8));" 您的密码

• 方式二：如果您是通过安装的方式安装并运行的Node-RED,则可以通过node-red命令来生成

node-red admin hash-pw

三、验证身份认证

1、重启Node-RED

npm run dev

2、Node-RED身份认证

启动成功后通过浏览器访问http://127.0.0.1:1880后，出现了认证画面，输入配置的用户名：admin，密码：123456完成认证


如果账号和密码不对，则提示认证失败，不能进入编辑器

3、Admin Api身份认证

curl http://192.168.0.100:1880/auth/token --data 'client_id=node-red-admin&grant_type=password&scope=*&username=admin&password=123456'

返回值

{
    "access_token": "fQiKsGqSmrei5/57CWxEwNITCE19gJeQAeMv1C2/J5Qm9ouMAZKj1O/v+TtMBxboFow9IrTMwHuHi1GdDKaRw8VYWkTQnVz54iab+wRXhGX0i5wHlUey+TP1kSvaTCtDFbo9btYxhqSd7BWaM30dUXRg0fmJ2qFfna79yezPfls=", 
    "expires_in": 604800, 
    "token_type": "Bearer"
}

如果失败则返回

{
    "error": "invalid_grant", 
    "error_description": "Invalid resource owner credentials"
}

运行截图