第一章:紫微道(简介篇)
opendiameter是一个非常优秀的认证计费相关的开源项目,它是Diameter协议(RFC3588)的一个完整C++实现库。opendiameter使用TCP进行传输保证可靠性(Radius协议使用UDP通讯),提供基于Session的C++类供上层应用程序开发时继承和使用。
第二章:白巅道(安装篇)
Opendiameter的最新版是 1.0.7 -I, 这里可以下载:
http://www.opendiameter.org/
在Linux环境下的安装依赖于:
g++ 3.2
Xerces C++XMLParser
ACE库
Boost库
OpenSSL库
Autoconf/Automake
所以请预先安装好ACE库和Boost库,并且设置环境变量:ACE_ROOT, BOOST_ROOT
Opendiameter中使用了大量的ACE库提供的类
运行编译三部曲:
./configure –prefix=/usr/local/opendiameter
Make
Make install
编译完毕可以在/usr/local/opendiameter/目录下看到结果
库文件,比如libdiameter.a等(./lib/)
头文件(./include/)
两个示例程序(./bin/)
示例配置文件(./etc)
第三章:寂玄道(开发篇)
Opendiameter C++ API 开发文档
http://diameter.sourceforge.net/diameter-api/index.html
opendiameter封装机制做的非常地优雅,你可以在下面的图中看到它的框架
最底层是AAA_Application,它负责配置加载,Peer连接,AAA消息路由等。每个Client或者Server必须有一个这个类的对象,也可以有多个,表示一个程序中运行多个diameter实体。AAA_Application对象需要一个ACE库中ACE_Task主动对象来维护运转。再往上就是很多的Session类,分为AAA_ClientSession和AAA_ServerSession类,分别用于不同场合,前者是计费系统的客户端部分,相当于NAS,后者是计费系统的服务器部分。再细分又可分为AuthSession和AcctSession,分别表示认证Session和计费Session,AcctSession需要一个容器类,比如AAA_ClientAcctRecCollector的派生类,作为它的模板参数。
明白这套框架机制之后,就可以动手写基于opendiameter库的客户端和服务器端程序了。
首先创建AAA_Application对象,然后编写相关Session的派生类,处理相关的事件,比如AAA_ServerAuthSession类的处理请求的函数
virtual AAAReturnCode RequestMsg(AAAMessage &msg) {
// all request messages are handled by this function.
// This function can retrun the following values:
// a. AAA_ERR_SUCCESS - client is successfully authenticated
// b. AAA_ERR_INCOMPLETE - auth not yet completed, muti-round
// message trip exchange
// c. AAA_ERR_FAILURE - client authentication failed
// Generally, a server application can send an
// application specific answer message from here
return (AAA_ERR_SUCCESS);
}
经过紫微道,白巅道,寂玄道的艰难PK之后,就可踏入昆仑琼花派,从此成为仙剑弟子,御剑行江湖 J