配置 FreeRADIUS

优质

小牛编辑

144浏览

2023-12-01

FreeRADIUS是通过修改配置文件来配置的. 这些文件的位置依赖于FreeRADIUS是怎样被安装的:

如果你安装发行版提供的标准FreeRADIUS包, 在CentOS和SLES上, 将会在/etc/raddb. 在Ubuntu上将会在/etc/freeradius.
如果你使用发行版的包管理系统从源码编译和安装FreeRADIUS, 在CentOS和SLES上, 将也会在/etc/raddb. 在Ubuntu上将会在/etc/freeradius.
如果你通过configure, make, make install来编译和安装FreeRADIUS, 他将会在/usr/local/etc/raddb.

写明的命令假定FreeRADIUS的配置目录为你的当前工作目录.

确保你是root用户为了能够编辑配置文件.
FreeRADIUS包括一个默认的客户端叫做localhost. 这个客户端被在localhost上RADIUS客户端程序所使用来帮助排查问题和测试. 确认下面的入口存在在clients.conf文件中:

client localhost {
    ipaddr = 127.0.0.1
    secret = testing123
    require_message_authenticator = no
    nastype = other
}

定义Alice作为一个FreeRADIUS测试用户. 添加下面的行到users文件的顶部. 确定第二行和第三行前面由一个单一的tab键缩进:

"alice" Cleartext-Password := "passme"
    Framed-IP-Address = 192.168.1.65,
    Reply-Message = "Hello, %{User-Name}"

以debug模式启动FreeRADIUS. 使用启动脚本来关闭FreeRADIUS来确保没有其他实例在运行. 在Ubuntu中我们这样做:

# /etc/init.d/freeradius stop
# freeradius -X

你也可以使用更暴力的方法: kill -9 $(pidof freeradius) 或者 killall freeradius在Ubuntu上和kill -9 $(pidof radius)或者killall radiusd在CentOS和SLES上, 如果启动脚本没能停止FreeRADIUS.

确保FreeRADIUS已经正确的启动通过确认在你的屏幕上的最后一行是: Ready to process requests. 如果这个没有发生, 阅读FreeRADIUS的debug输出.
使用下面的命令来Authenticate Alice.

radtest alice passme 127.0.0.1 100 testing123

FreeRADIUS的debug输出将会展示Access-Request包到达并且FreeRADIUS服务器如何响应这个请求.
radtest将也会显示FreeRADIUS服务器的回复:

Sending Access-Request of id 17 to 127.0.0.1 port 1812
    User-Name = "alice"
    User-Password = "passme"
    NAS-IP-Address = 127.0.0.1
    NAS-Port = 100
rad_recv: Access-Accept packet from host 127.0.0.1 port 1812, id=147, length=40
    Framed-IP-Address = 192.168.1.65
    Reply-Message = "Hello, alice"

发生了什么?

我们已经在FreeRADIUS上创建了一个测试用户. 我们也使用radtest命令作为一个客户端到FreeRADIUS服务器来测试authentication.

让我们详细描述一些有趣和重要的点.

配置FreeRADIUS

FreeRADIUS服务器的配置逻辑上划分为不同的文件. 这些文件被修改来配置某个功能, 组件或者FreeRADIUS模块. 然而有一个主配置文件包含各种子配置文件, 叫做radiusd.conf.

默认的配置适合大多数安装. 只需要非常少修改来使FreeRADIUS在你的环境有用.

客户端

尽管在FreeRADIUS服务器的配置目录内有许多文件, 只有少量将来需要修改的. clients.conf文件是用来定义到FreeRADIUS服务器的客户端的.

在一个NAS可以使用FreeRADIUS服务器之前, 他必须被定义为在FreeRADIUS服务器上的一个客户端. 让我们看一些关于客户端定义的要点.

Sections

一个客户端通过一个client section定义. FreeRADIUS使用section来分组和定义许多东西. 一个section以一个关键字开始表示section名称. 然后跟着一个封闭的大括号. 在封闭的括号内部有许多配置指定到这个section. section可以被嵌套.

有时section的关键字跟着一个单一的词来区分通一个类型的不同的section. 这允许我们在clients.conf中有不同客户端入口. 每一个客户端有一个简短的名称来区分他和其他的.

clients.conf文件不是唯一的文件, client section可以被定义, 尽管他是常用和最符合逻辑的地方. 下图显示在一个server section内嵌套定义的客户端.

nested_client_definitions_inside_a_server_section

客户端标识

FreeRADIUS服务器通过他的IP地址标识一个客户端. 如果一个不知道的客户端发送给服务器一个请求, 这个请求将会被默默忽略.

共享密钥(shared secret)

客户端和服务器端也需要有一个共享的密钥, 将会用来加密和解密某些AVPs. User-Password AVP的值使用这个共享密钥加密. 当共享密钥在客户端和服务器端不同时, FreeRADIUS服务器将会检测到他并且当运行的debug模式时警告你.

Failed to authenticate the user.
    WARNING: Unprintable characters in the password. Double-check the shared secret on the server and the NAS!

Message-Authenticator

当定义一个客户端你可以强制在所有请求中出现Message-Authenticator AVP. 由于我们将会使用radtest程序, 没有包含他, 我们对于localhost禁用他, 通过设置require_message_authenticator为no.

Nastype

nastype设置为other. nastype的值将会剧而定checkrad Perl脚本将会如何执行. checkrad是用来决定一个用户是否已经使用一个NAS的资源. 由于localhost没有这个功能或者我们需要定义他为other.

常见错误

如果服务器下线或者从radtest发出的包由于防火墙不能到达服务器, radtest将会尝试3次然后以下面信息放弃

radclient: no response from server for ID 133 socket 3

如果你用普通用户运行radtest, 他可能会抱怨没有权限访问FreeRADIUS字典文件. 这对于普通操作是需要的. 解决这个的方法是修改报告的文件的权限或者用root运行radtest

users文件

用户定义在users文件在FreeRADIUS的配置目录. users文件的内容是用来Authorization和Authentication. 这个文件不仅使用户的来源也是一个简单有效的方式开始. 让我们看一些关于users文件的关键点.

文件模块

files模块(rlm_files)读取users文件的内容来决定是否在Access-Request中指定的用户存在并且授权来使用NAS. 他也决定了什么attribute应该被返回给客户端.

files模块也设置了Auth-Type. 这将会决定要使用的authentication方法. 如果一个用户定义了带有Cleartext-Password check item, 他将会设置Auth-Type = PAP.

files模块也提供其他的模块带有一个值"know good password"如果定义了. 在我们的例子中, 他提供pap模块(rlm_pap)带有值指定在Cleartext-Password check AVP.

PAP 模块

pap模块(rlm_pap)是用来authentication. 如果Auth-Type设置为PAP, 他将会寻找known good password并且将他跟User-Password AVP的值比较. 如果是相同的, 这个模块将会通过authentication请求.

请求可能仍然失败由于在FreeRADIUS authentication 链条的其他模块.

Users文件

users文件不包含任何section像clients.conf. 这是因为他是针对files模块并且不直接跟FreeRADIUS服务器自身相关的.

要在users文件中添加一个入口, 你可以定义一个用户名跟着0个或者更多逗号分隔的检查项. 接着跟着0个或者更多tab缩进的行用逗号分隔的回复项.

我们假定你在使用默认的配置没有对sites-enabled/default虚拟服务器做任何修改. 如果你改了, 例如, 激活了在authorize section下面的unix模块并且Alice也被定义为一个系统用户, 系统用户和他们密码将会是优先的用户而不是在users文件中定义的那个. 结果将会是一个Access-Reject包被返回来回应Access-Request如果在Alice(系统用户)和Alice(在user文件中用户)不同.

Check项目

下面的入口需要Access-Request包, 包含一个AVP对于NAS-IP-Address带有值127.0.0.1.

"alice" Cleartext-Password := "passme", NAS-IP-Address == '127.0.0.1'

radtest程序将会默认设置NAS-IP-Address的值为hostname的IP在/etc/hosts文件中指定的. 后面的章节中你将会看到这个值怎样修改.

一些AVPs有一个特殊的含义和被FreeRADIUS内部使用. 尽管进来的Access-Request没有包含一个AVP叫做Cleartext-Password, 这个files模块内部使用他来调整Auth-Type的值并且来创建一个好的密码, 可以被pap模块使用来authentication.

另一个特殊的AVP的例子是当你想要拒绝或者接受一个基于用户的用户名, 无论他们的密码是什么. 之前的行将会改变为下面中的一个.

"alice" Cleartext-Password := "passme", Auth-Type := Reject
"alice" Cleartext-Password := "passme", Auth-Type := Accept

尽管Auth-Type似乎是一个标准的AVP检查项, 他属于FreeRADIUS内部, 并且是用来控制哪种authentication将会被使用.

回复项

回复项目前面有一行包含用户名和零个或多个检查项目。回复项目使用单个选项卡缩进。多个项目可以放在用逗号分隔的单行上。它们也可以跨越多行，但必须用逗号分隔。