Opendiameter

简介篇

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