GenAuth DocsDocuments
Concepts
User Guide
Development Integration
AgentAuth
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Concepts
User Guide
Development Integration
AgentAuth
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Old version
  • Single Page Web Application

  • Mobile and Client Applications

  • Standard Web Application

  • Framework Integration

  • Others

    • Single Sign-On (SSO)
    • WeChat Mini Program
    • WeChat Web Login
    • Radius
    • Error Codes
  1. Development Integration
  2. /
  3. Others
  4. /
  5. Radius

¶ Radius 服务器搭建步骤

Update time: 2025-07-23 07:34:21
Edit

¶ 第一步:下载 GenAuth Radius Agent (opens new window)


¶ 第二步:安装 GenAuth Radius Agent

  • 首先要准备一台支持 java 的服务器用来安装 GenAuth Radius Agent

  • 确保设备安装了 java 11 或以上版本

  • 将步骤一下载的安装包拷贝至设备文件系统,如:/root/radius/AuthingRadius.jar


¶ 第三步:在 GenAuth 控制台创建 Radius 应用

在 GenAuth 控制 应用 -> 单点登录 SSO 页面点击「添加应用」

找到 Radius 应用,点击进入创建界面,然后点击「获取应用」

填写应用名

点击「下一步」,可以看到需要的配置信息

点击「完成」,进入访问授权,给用户授权访问权限


¶ 第四步:配置 GenAuth Radius Agent

cd 到目标设备上 Agent 所在目录,创建 config.json,填入以下配置信息:

{
  "scheme": "https",
  "port": 1812,
  "userPoolId": "your authing user pool id",
  "appId": "your authing radius app id",
  "sharedSecret": "copy from your authing radius app in authing console",
  "authingHost": "core.genauth.ai",
  "publicKey": "replace_with_your_on_premise_authing_public_key"
}
参数名类型说明默认值
scheme字符串发送给 authing 的请求 shemehttps
port整数Radius 服务端口,需要和 Radius 客户端应用程序的设置匹配1812
userPoolId字符串authing 用户池 id
appId字符串authing radius 应用 id
sharedSecret字符串authing radius 应用的 SharedSecret
authingHost字符串若私有化部署了 authing,需要填写私有化的域名core.genauth.ai
publicKey字符串authing 服务的公钥。在私有化部署场景需要指定。若使用 SaaS 版本,请删掉本字段SaaS 版本默认值

¶ 第五步:配置服务器证书

GenAuth Radius Agent 支持协议包括:

  • PAP
  • EAP-GTC
  • EAP-TTLS-PAP
  • EAP-TTLS-GTC

若使用 PAP、EAP-GTC 协议,则不涉及证书问题,可以跳过此步骤。

若使用 EAP-TTLS-PAP、EAP-TTLS-GTC 协议,则要求配置服务器证书。

首先在 AuthingRadius.jar 所在目录创建文件夹,命名为 cer,然后将证书以及私钥通过 openssl 命令转为 der 格式,拷贝到 cer 目录下。证书的文件名为:server.der;私钥的文件名为:server_pri.der

如果没有自己的证书,可以使用 zip 包里面的自签名证书


¶ 第六步:启动 GenAuth Radius Agent

在 GenAuth Radius Agent 所在目录下,运行

java -jar AuthingRadius.jar

¶ 第七步:测试 / 验证 Radius 服务

可以用支持 Radius 的设备 / 应用程序进行测试。也可以下载我们的 GenAuth Radius 测试客户端 (opens new window)

在本机,cd 到我们的测试客户端所在目录,运行:

java -jar AuthingRadiusClient.jar your_agent_ip your_secret username password

示例:

java -jar AuthingRadiusClient.jar 192.168.1.100 1234567890 test 123456

¶ Best Practice

  1. 让 Agent 以 Daemon 进程方式运行。Linux 系统下面运行:
nohup java -jar AuthingRadius.jar > /dev/null &
  1. 对 config.json 的任何修改都需要重启 Agent。注意需要先退出运行的 Agent,否则会报端口被占用。在 Linux 系统下,可以考虑使用类似下面的脚本:
kill -9 `lsof -t -i:1812`
nohup java -jar AuthingRadius.jar > /dev/null &
echo
  1. Agent 日志和 Agent 在同一目录下,文件名:radius.log
Previous article: WeChat Web Login Next article: Error Codes
  • 第一步:下载 GenAuth Radius Agent
  • 第二步:安装 GenAuth Radius Agent
  • 第三步:在 GenAuth 控制台创建 Radius 应用
  • 第四步:配置 GenAuth Radius Agent
  • 第五步:配置服务器证书
  • 第六步:启动 GenAuth Radius Agent
  • 第七步:测试 / 验证 Radius 服务
  • Best Practice

User identity management

Integrated third-party login
Customized authentication process

Enterprise internal management

Single sign-on
Multi-factor authentication
Permission management

Developer

Development Documentation
GitHub (opens new window)

Company

official@genauth.ai
16th Floor, Building B, Beichen Century Center, Chaoyang District, Beijing (Total)
Room 406, 4th Floor, Block B, No. 200, Tianfu Fifth Street, High-tech Zone, Chengdu (Branch)

© Beijing Steamory Technology Co., Ltd.