dereknex
3/16/2016 - 10:03 AM

coova-chilli.md

coova-chilli.md
content_copyfile_download
  • Rendered
  • Source

Specs

  • CoovaChilli 是一个开源的软件访问控制工具(access controller), 基于曾经流行的ChilliSpot项目, 并且被原来的ChilliSpot贡献者们维护.
  • CoovaChilli 是一个功能丰富的软件访问控制工具提供一个网页认证(captive portal) / walled-garden 环境和使用RADIUS或者HTTP协议来访问控制(access provisioning)和账户认证(accounting).
  • CoovaChillis是CoovaAP OpenWRT固件的一部分, 专门用于热点.

Details

References

CoovaChilli在很多情况下可以完全取代ChilliSpot, 他基于ChilliSpot 1.0, 集成了1.1的大多数features, 并且添加了许多features和fixes

luci

Content-injection

HS_RADCONF

编译Compile-time options

  • --disable-leakybucket
  • --disable-chillixml: 不使用chillixml (safe to do in most cases)
  • --disable-json
  • --disable-sessgarden: 不支持session walled garden
  • --disable-ieee8021q: Disable support for IEEE 802.1Q (VLAN tagging on dhcpif interface)
  • --enable-proxyvsa: Enable support for VSA(Vendor-Specific Attributes) attribute proxy
  • --enable-largelimits: Enable larger limits for use with non-embedded systems. Bigger memory usage for more users
  • --enable-binstatusfile: Enable support for binary status file. The status bin file saves and restores session state
  • --enable-statusfile: Enable support for status file. The status file is informational only
  • --enable-chilliproxy: Enable support for HTTP AAA Proxy. Required for uamaaaurl
  • --enable-chilliradsec: Enable support for RadSec AAA Proxy. Required SSL support
  • --enable-chilliredir: Enable support for redir server. Required for uamregex
  • --enable-miniportal: Enable support Coova miniportal. Includes a simple haserl captive portal
  • --enable-rtmon: Enable support for route monitoring deamon (experimental)
  • --enable-netnat: Enable net interface nat (experimental)
  • --with-openssl: enable support for OpenSSL. Required for radsec, redirssl, or uamuissl
  • --with-matrixssl: enable support for MatrixSSL. Required for radsec, redirssl, or uamuissl
  • --with-nfqueue: enable support for Netfilter_queue
  • --with-nfcoova: enable support for coova kernel module
  • --with-pcap: enable support for pcap
  • --with-curl: enable support for curl (optional and used with --enable-chilliproxy)
  • --with-mmap: enable support for mmap (experimental)
  • --with-poll: enable support for poll (epoll is auto-detected and used if available)
  • --with-ipc-msg: enable support for msgsnd/msgrcv SV IPC

openwrt上编译配置

  • package/feeds/oldpackages/coova-chilli/Config.in

openwrt上安装

  • opkg install coova-chilli -> 会安装coova-chilli, kmod-tun, librt, libpthread
  • opkg install haserl -> miniportal依赖

config

  • 拷贝 /etc/chilli/defaults 到 /etc/chilli/config, 然后修改config里面配置
  • 启动 /etc/init.d/chilli start 会在 /etc/chilli/ 生成 main.conf, local.conf, hs.conf
  • defaults 中默认认为 eth0 是WAN口, eth1是LAN口, 可以修改HS_WANIF为WAN口, HS_LANIF为LAN口.

--noradallow

获取user/usage信息

UNIX_SOCKET=$(find /var/run -name *sock |grep 'chilli') 
chilli_query -s $UNIX_SOCKET list > /tmp/chilli_clients

改进

  • mobile first design, responsive web design
  • jQuery

官网

solution

漫游

install

配置文件

/etc/chilli.conf

  • main chilli configuration file, 可以包含全部的配置项, 或者包含其他文件. 默认情况下, 这个文件包含3个其他文件: main.conf, hs.conf, 和 local.conf. main.conf 和 hs.conf由functions shell文件中的函数创建, 基于下面提到的配置文件的配置和可能获取配置来自RADIUS server或者URL. local.conf是保留用于location specific configurations.

/etc/chilli/main.conf

  • 包含你的 main coinfigurations

/etc/chilli/hs.conf

  • 包含你的由RADIUS传递的配置(使用Adminstrative-User login)

/etc/chilli/local.conf

  • 任何其他你有可能手动配置为了特殊的安装.

/etc/chilli/defaults

  • 默认被chilli init.d 和 functions scripts使用, 创建实际的配置文件. 可以详细看里面的注释来了解如何配置chilli和相关的脚本和embedded content.

/etc/chilli/config

  • 被chilli init.d 和 functions scripts使用的Location specific configurations. 拷贝上面的defaults, 然后修改.这个文件是在defaults文件之后被加载, 因此, 会覆盖配置.

/etc/chilli/functions

  • 通过加载上面的配置文件来帮助配置chilli, 设置一些默认参数, 并且提供函数来写入main.conf, hs.conf, 和local.conf基于local和possibily centralized RADIUS 服务器或者URL. 见chilli.conf(5)

/etc/init.d/chilli

  • chilli的init.d file默认使用上面的配置来编译一个配置集合在/etc/chilli目录, 利用local configurations和可能来自RADIUS 或一个URL的centralized configurations. 见chilli.conf(5)

/var/run/chilli.sock

  • 用于daemon communication的UNIX socket, 见chilli_query(1)

/var/run/chilli.pid

  • Process ID文件

/etc/chilli/www/

  • chilli serve up的embedded web content的典型目录, 使用一个minimal web server. 一个方便的位置用于splash page, embedded captive portal, 和JSON javascript resources.

知识库

调试

分析

patches

源码与程序对应关系

  • chilli - main.c 主进程
  • chilli_opt - main-opt.c 解析命令行和配置文件参数, 并写入二进制配置文件
  • chilli_query - main-query.c 查询主进程chilli的连接状态
  • chilli_radconfig - main-radconfig.c
  • chilli_response - main-response.c pap或nt的challenge测试

802.1X

company

Refs