快速入门


Switch to English Edition of Quick Start

本入门指导将安装一个单节点(主节点)的Janusec应用网关(网关WAF).

安装需求


节点 操作系统 数据库
主节点 CentOS/RHEL 7, 或 Debian 9, x86_64, 使用 systemd PostgreSQL 9.3 / 9.4 / 9.5 / 9.6 / 10
从节点 CentOS/RHEL 7, 或 Debian 9, x86_64, 使用 systemd 不需要

本入门只安装一个主节点,不安装从节点,如需扩展,可参考安装一节。

安装


步骤 1: 下载

$cd ~
$wget https://www.janusec.com/download/janusec-latest.tar.gz
$tar zxf ./janusec-latest.tar.gz

步骤 2: 安装

请切换到root用户并运行 install.sh , janusec应用网关将安装在目录: /usr/local/janusec/

$su
#cd janusec-0.9.3
#./install.sh

选择 1. Master Node, 然后安装程序会:

  • 将所需文件复制到 /usr/local/janusec/
  • 将服务配置文件复制到系统服务目录
  • 将Janusec应用网关服务设置为自动启动,但首次安装时不会启动,需要在配置完成后手工启动一次.
步骤 3: 配置

PostgreSQL没有包含在发布包中,需要自行准备PostgreSQL数据库、用户名 、口令,可参考运维管理中的PostgreSQL安装。
现在我们假设您已经安装好了PostgreSQL,且数据库已创建,用户名和口令已准备好。
然后编辑 /usr/local/janusec/config.json :

{
    “node_role”: “master”,
    “master_node”: {
        “admin_http_listen”: “:9080”,
        “admin_https_listen”: “:9443”,
        “database”: {
            “host”: “127.0.0.1”,
            “port”: “5432”,
            “user”: “your_postgresql_user”,
            “password”: “your_postgresql_password”,
            “dbname”: “janusec
        }
    },
    “slave_node”: {
        “node_key”: “”,
        “sync_addr”: “”
    }
}

步骤 4: 启动网关并测试

#systemctl start janusec.service

打开浏览器(比如Chrome),使用如下地址:

http://您的网关IP地址:9080/

这是Janusec应用网关的第一个管理地址(后面可启用安全的管理地址)。
默认用户名:admin
默认口令:J@nusec123

配置数字证书 (如使用HTTPS,必选)


如果仅使用HTTP,不使用HTTPS,可跳过此步骤;但强烈建议配置证书并启用HTTPS。

使用浏览器打开 http://您的网关IP地址:9080/ 并添加一张数字证书。 如果您还没有数字证书,可以从Let's Encrypt申请免费的数字证书,或者让Janusec生成一张自签名的数字证书(自签名证书仅用于测试用途)。

配置Web应用 (必选)


使用浏览器打开 http://您的网关IP地址:9080/ 并添加一个应用.
填写应用名称、实际服务器的 IP:端口 等信息。

修改DNS或Hosts (必选)


生产环境,需要将修改DNS将您的域名指向网关地址。
测试环境,可直接修改您本地电脑的hosts文件: C:\Windows\System32\drivers\etc\hosts.

验证


配置完成后,验证网关是否正常工作。
打开浏览器,访问: http://your_domain_name/

https://your_domain_name/ .
如果可以正常访问,表明网关已正常工作。

WAF验证


检验WAF(Web应用防火墙)是否工作正常。 可使用如下测试用例:

http://your_domain_name/.svn/entries
http://your_domain_name/test?id=1 and 1=1

阻断效果:
WAF

©Janusec All Rights Reserved.      Contact: support#janusec.com    QQ Group: 776900157