CDMA1X对AAA的要求.doc

中国联合通信有限公司CDMA 1X分组网对AAA系统要求1新增加的功能要求：22AAA系统与支撑系统的接口22.1AAA系统与CDMA专业子计费系统的流量话单接口22.2AAA系统与CDMA专业计费子系统的联机指令接口52.2.1联机指令消息接口方式52.2.2联机指令批文件接口方式62.2.3联机指令消息体和文件体内容8中国联合通信有限公司2002年11月发布1 新增加的功能要求：1. AAA要同时支持根据IMSI和域名来进行漫游识别；2. AAA支持根据业务标识（如用户名=WAP）将计费请求转发给业务网关；3. AAA支持根据业务标识（如用户名=WAP）给用户分配不同的IP地址池；4. AAA根据UDR产生的原始话单中每条记录增加话单序列号、漫游标识以及两个预留字段共四个属性。AAA需要判断出是本地、漫游出、漫游入不同的话单类型，并进行标识。5. AAA与专业计费子系统的联机指令支持消息接口和文件接口两种方式。消息接口基于TCP协议，处理单条联机指令；文件接口基于FTP协议，处理批量联机指令。2 AAA系统与支撑系统的接口2.1 AAA系统与CDMA专业子计费系统的流量话单接口AAA系统定时在指定目录下生成原始计费文件，CDMA专业计费子系统定时到AAA系统指定目录采集原始话单。接口采用文件方式，文件包括文件头和文件体两部分。n 原始话单文件头序号属性名最大长度备注1.记录类型CHAR (2)首纪录=012.文件序列号CHAR (4)从0001开始排序，排满后重置3.文件版本号CHAR (2)004.文件产生日期CHAR (8)YYYYMMDD5.首次会话日期CHAR (8)YYYYMMDD6.首次会话时间CHAR (6)HHMMSS7.末次会话日期CHAR (8)YYYYMMDD8.末次会话时间CHAR (6)HHMMSS9.话单总记录数CHAR (10)右对齐，左补010.换行CHAR (1)n 原始话单文件体：包括增加字段后的原始话单，每条话单中包括的属性如下所示。序号属性名最大长度备注1.序列号CHAR (10)连续的话单序列号2.Accounting Status TypeCHAR (10)1开始话单；2结束话单；3中间话单；3.MSIDCHAR (15)IMSI4.IP AddressCHAR (15)十进制表示：如5.NAICHAR (64)用户上网帐号6.Account Session IDCHAR (8)标识一个会话连接7.Correlation ID CHAR (8)标识一个PPP连接8.Session ContinueCHAR (10)标识当前Accounting Stop是否为一个连接的结束, 为0时表示结束，1时表示继续，只出现在结束话单中。9.MIP Home AgentCHAR (15)HA的IP地址10.PDSN/FA Address CHAR (15)普通用户为PDSN地址，VPN业务时该值为VPN网关的IP地址11.Serving PCFCHAR (15)PCF地址12.BSIDCHAR (12)SID+NID+BSC ID 13.User Zone CHAR (10)用户所在区域标识14.Forward Mux Option CHAR (10)前向复用选项15.Reverse Mux OptionCHAR (10)反向复用选项16.Service OptionCHAR (10)CDMA 1X数据业务为3317.Forward Traffic Type CHAR (10)正向通信类型有主要和备用两个信道，0Primary，1Secondary18.Reverse Traffic TypeCHAR (10)反向通信类型有主要和备用两个信道0Primary，1Secondary19.Fundamental Frame SizeCHAR (10)基本信道帧大小0不确定，15，220ms20.Forward Fundamental RCCHAR (10)正向基本资源等级21.Reverse Fundamental RCCHAR (10)反向基本资源等级22. IP TechnologyCHAR (10)IP技术类型1Simple IP 2Mobile IP23.Compulsory Tunnel IndicatorCHAR (10)强制隧道类型0无隧道；1非安全隧道2安全隧道24.Release IndicatorCHAR (10)发送Accounting stop的原因25.DCCH Frame FormatCHAR (20)专用控制信道帧格式26.Data Octet Count (Terminating)CHAR (10)发送给用户的字节数27.Data Octet Count (Originating)CHAR (10)用户发起的字节数28.Bad PPP Frame Count,CHAR (10)被PDSN丢弃的坏帧。29.Event TimeCHAR (10)开始话单中为会话开始的时间，结束话单中为会话结束的时间，从1970年1月1日00：00：00起的秒数30.Active TimeCHAR (10)PCF端统计的会话时长（秒数）31.Number of Active TransitionsCHAR (10)一次PPP连接中从休眠状态到激活状态转换的次数32.SDB Octet Count (Terminating)CHAR (10)用户通过SDB（突发短数据）方式接受的字节数33.SDB Octet Count (Originating)CHAR (10)用户通过SDB（突发短数据）方式发送的字节数34.Number of SDBs (Terminating)CHAR (10)用户接受到的SDB（突发短数据）的次数35.Number of SDBs (Originating)CHAR (10)用户发送的SDB（突发短数据）的次数36.Number of HDLC layer bytes receivedCHAR (10)PDSN收到的HDLC（高级数据链路层的字节数）37.In-Bound Mobile IP Signaling Octet CountCHAR (10)移动IP信令流量，用户接收到的MIP信令字节数38.Outbound Mobile IP Signaling Octet CountCHAR (10)移动IP信令流量，用户发送的MIP信令字节数39.IP Quality of Service (QOS)CHAR (10)IP网络的用户质量等级码（目前用的多是Best Effort）40.Airlink Quality of Service (QOS)CHAR (10)无线链路质量等级码41.Airlink Record TypeCHAR (10)1连接建立；2激活开始；3激活结束；4SDB纪录42.R-P Session IDCHAR (10)RP会话ID43.Airlink Sequence NumberCHAR (10)无线链路序列号44.Mobile Originated / Mobile Terminated IndicatorCHAR (10)0发起；1结束45.MDNCHAR (20)用户手机号46.漫游标识CHAR (1)0：本地；1：漫入；2：漫出; 2省际漫出; 3国际漫入；4国际漫出47.未用CHAR (10)预留48.未用CHAR (10)预留49.计费容器不定长50.换行1nn 文件存放的根目录：CdmaRUDR_datn 文件命名：文件产生的时间（精确到年月日时分）+序列号（4位）n AAA系统输出的原始话单文件的产生时间以分钟为单位定时产生，不考虑文件大小，产生的时间间隔可配置，缺省设置为10分钟，如果没有话单要求能够产生空文件。n AAA上既要有话单FTP目录，又要有话单备份目录。n 原始话单文件采用ASCII文本格式，每条话单的属性值按顺序排列，各属性间使用t分隔，在生成计费记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。n 文件中一行作为一条计费记录，各条计费记录之间用换行符作为分隔并在计费文件中连续书写，文件不定长。2.2 AAA系统与CDMA专业计费子系统的联机指令接口联机指令接口是根据综合营业子系统对CDMA 1X手机用户的开通/变更等请求对AAA系统中的用户信息进行更新。联机指令接口支持消息和文件两种接口方式消息接口处理单条联机指令，由专业计费子系统将综合营业子系统发起的工单请求进行协议转换、指令翻译，转化为AAA系统能识别的指令，发送给AAA系统，AAA系统处理后返回结果信息。若检查不通过（包括消息头、消息体错误、不能识别的消息类型等）或处理不通过，应立即把错误类型和错误描述返回给专业计费子系统。AAA系统消息联机指令724小时侦听指定的端口。文件接口处理多条联机指令，AAA系统定时到计费系统指定目录下采集批文件，检查文件的正确性后（文件名、文件头等），对每条记录进行处理，每条纪录的处理方法根据请求类型来决定。根据处理结果生成完全正确、部分错误、完全错误、查询结果四种文件，放回专业计费子系统不同目录下。2.2.1 联机指令消息接口方式联机指令消息包括消息头、消息体两部分。n 消息头序号名称最大长度备 注1.头段标识3字符串（MHF）2.版本信息5字符串（默认 00000）3.发起方系统代码3字符串（专业计费子系统）4.接收方系统代码3字符串（AAA系统）5.请求的日期时间14字符串（yyyymmddhhmmss）6.序列号(流水号)16数字串7.请求优先级2数字串（内容见请求类型定义）8.请求类型6字符串9.信息体长度4数字串n 消息体 消息体可变长，包含若干消息单元，格式为：参数名1=值1t参数名2=值2t.参数名n值n。参数之间无顺序，其中参数名中不能有空格，参数之间的分隔符用t进行分隔。例如：Username=user1tPassword=user1。 每个参数值的位数最大不超过定义的字节数。 消息单元若是必需（M），则这类消息单元必需出现在请求中，若没出现，联机指令模块将拒绝此请求。消息单元若是可选（O），则这类消息单元可选出现在请求中。消息单元若是依赖（C），则这类消息单元是否必须出现由某个其他消息单元的取值决定。2.2.2 联机指令批文件接口方式n 联机指令批文件目录AAA在专业计费子系统指定目录下采集请求文件，再将存放结果的回执文件放回专业计费子系统。一个请求文件中可以有多种请求类型，但查询请求记录单独放在一个请求文件中。 存放请求文件工作目录：/interface/lianji/aaa/request 存放正确回执文件工作目录：/interface/lianji/aaa/response/right 存放完全错误回执文件工作目录：/interface/lianji/aaa/response/bad 存放部分错误回执文件工作目录：/interface/lianji/aaa/response/semiwrong 存放查询结果回执文件工作目录：/interface/lianji/aaa/response/query n 联机指令批文件命名批文件名按如下规则命名：yyyymmddnnnnn.ttt yyyymmdd 为年月日。 nnnnn 是5位序列号，每天从“00001”开始，到达”99999”后又从“00001”开始。 ttt表示文件类型，req表示请求，res表示请求结果。每一个req文件都应该有一个res文件与其对应。联机指令请求文件和回执文件都包括文件头、文件体两部分。n 请求文件头序号名称字节数类型内容版本信息5字符串默认 00000发起方系统代码3字符串字符串（专业计费子系统）接收方系统代码3字符串字符串（AAA系统）请求的日期时间14字符串yyyymmddhhmmss序列号(流水号)4数字串请求总数10数字串换行1字符串n 请求文件体请求文件体中每条请求之间用n分隔、每条纪录中的信息单元按顺序定长排列。工单请求 1的工单号 CHAR(16)请求类型 CHAR(6)信息单元 见2.2.3文件体内容nn 回执文件头序号名称字节数类型内容版本信息5字符串默认 00000发起方系统代码3字符串字符串（专业计费子系统）接收方系统代码3字符串字符串（AAA系统）请求的日期时间14字符串yyyymmddhhmmss文件状态1字符串N:正常R：记录级错；F：文件级错处理总数4数字串前补零正确处理总数4数字串前补零换行1字符串n 回执文件体对于完全正确和完全错误的回执文件，只有文件头没有文件体；对于记录级错误的回执文件，包括文件头和文件体两部分，在文件体中列出错误的请求工单号及反馈结果代码。错误工单请求 1的工单号 CHAR(16)错误工单请求1的反馈结果代码 CHAR(4)nn 查询结果回执文件包括文件头和文件体两部分，文件体格式如下查询请求 1的工单号 CHAR(16)查询请求1的反馈结果 见2.2.3文件体内容n2.2.3 联机指令消息体和文件体内容 登录请求 输入消息（SLOGIN）序号标识名称M/O类型最大字节数备注1.ADMIN系统用户名MChar64AAA系统主机用户名2.PASSWD密码MChar64对应的密码 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注1.RTCODE反馈结果代码MNumber4见返回代码定义2.RTDESC反馈结果信息OChar60 说明：专业计费子系统与AAA系统建立TCP连接，发送的第一个消息应是登录消息，登录成功确认后方可向AAA系统发送其它请求消息。 创建NAI请求 输入消息 (CRTNAI) 序号标识名称M/O类型最大字节数备注1.NAIUSERNAMENAI用户名MChar32用户的登录帐号，不能含#$2.PASSWORD口令MChar103.NAIGROUPIDNAI业务组标识MNumber10由AAA系统创建，营帐系统与其同步4.SERVICETYPE服务标识MNumber5见后文说明5.NAIBUREAUIDNAI归属地标识MNumber36.SERVICESTATUSNAI用户名启用状态MNumber20:正常状态；1：非正常状态7.IMSIJUDGEIDIMSI鉴权标识Mchar10:True;1:False8.NAITYPENAI类别Mchar10:普通用户； 1：VPN用户。9.DOMAIN域名Ochar32VPN用户域名信息10.IMSIIMSIMchar15当IMSI鉴权标识=True，11和12项不能为空。11.MDNMDNMChar20同上12.MAXCON最大并发个数限制ONumber5值为零时，表示无限制13.IPADDR用户静态IP地址OChar15限定用户只能使用指定的IP14.IPQOSIPQoS等级Onumber5 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注1.RTCODE反馈结果代码MNumber4见返回代码定义2.RTDESC反馈结果信息OChar60 说明：创建一个NAI用户信息 删除NAI请求 输入消息(DLTNAI)序号标识名称M/O类型字节数备注a)NAIUSERNAME用户名MChar32用户的登录帐号，不能含#$ 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注a)RTCODE反馈结果代码MNumber4见返回代码定义b)RTDESC反馈结果信息OChar60 说明：删除一个NAI用户 修改NAI请求 输入消息(CHGNAI)序号标识名称M/O类型最大字节数备注a)NAIUSERNAMENAI用户名MChar32用户的登录帐号，不能含#$b)NEWUSERNAME更新后的用户名OChar32c)NAIGROUPIDNAI业务组标识ONumber10由AAA系统创建，营帐系统与其同步d)SERVICETYPE服务标识ONumber5见后文说明e)NAIBUREAUIDNAI归属地标识ONumber3f)SERVICESTATUSNAI用户名启用状态ONumber20:正常状态；1：非正常状态g)IMSIJUDGEIDIMSI鉴权标识Ochar10:True;1:Falseh)NAITYPENAI类别Ochar10:普通用户； 1：VPN用户。i)DOMAIN域名Ochar32VPN用户域名信息j)IMSIIMSIOchar15当IMSI鉴权标识=True时，11和12项不能为控k)MDNMDNOChar20同上l)MAXCON最大并发个数限制ONumber5值为零时，表示无限制m)IPADDR用户静态IP地址OChar15限定用户只能使用指定的IPn)IPQOSIPQoS等级Onumber5 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注a)RTCODE反馈结果代码MNumber4见返回代码定义b)RTDESC反馈结果信息OChar60 说明：修改一个NAI用户的信息，除了密码的修改可在其他消息中实现外，NAI用户的信息都可以修改，包括用户名的更改。AAA处理时只修改出现在此消息中的属性。 NAI信息查询请求 输入消息(QUINFO)序号标识名称M/O类型最大字节数备注a)NAIUSERNAMENAI用户名MChar32用户的登录帐号 输出消息(USIRSP) 序号标识名称M/O类型最大字节数备注a)NAIUSERNAMENAI用户名MChar32用户的登录帐号b)PASSWORD口令MChar10c)NAIGROUPIDNAI业务组标识MNumber10由AAA系统创建，营帐系统与其同步d)SERVICETYPE服务标识MNumber5见后文说明e)NAIBUREAUIDNAI归属地标识MNumber3f)SERVICESTATUSNAI用户名启用状态MNumber20:正常状态；1：非正常状态g)IMSIJUDGEIDIMSI鉴权标识Mchar10:True;1:Falseh)NAITYPENAI类别Mchar10:普通用户；1：集团用户；2：VPN用户。i)DOMAIN域名Ochar32域名信息j)IMSIIMSIOchar15k)MDNMDNOChar20l)MAXCON最大并发个数限制ONumber5值为零时，表示无限制m)IPADDR用户静态IP地址OChar15限定用户只能使用指定的IPn)IPQOSIPQoS等级Onumber5 说明：根据NAI用户名查询用户信息。 NAI修改密码请求 输入消息（CHGPWD）序号标识名称M/O类型最大字节数备注a)NAIUSERNAMENAI用户名MChar32用户的登录帐号b)PASSWORD口令MChar10c)NEWPASSWORD用户新口令MChar10 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注a)RTCODE反馈结果代码MNumber4见返回代码定义b)RTDESC反馈结果信息OChar60 说明：修改NAI用户密码。 已有NAI申请新的服务 输入消息（ADDSRV）序号标识名称M/O类型最大字节数备注c)NAIUSERNAMENAI用户名MChar32用户的登录帐号d)SERVICETYPE新增加的服务标识MNumber5见后文说明 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注1.RTCODE反馈结果代码MNumber4见返回代码定义2.RTDESC反馈结果信息OChar60 说明：已有用户可以申请一个新的业务，SERVICETYPE字段的值标识一个新申请的业务代号。 已有NAI撤销某项服务 输入消息（DLTSRV）序号标识名称M/O类型最大字节数备注1.NAIUSERNAMENAI用户名MChar32用户的登录帐号2.SERVICETYPE撤消的服务标识MNumber5见后文说明 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注e)RTCODE反馈结果代码MNumber4见返回代码定义f)RTDESC反馈结果信息OChar60 说明：已有用户可以撤销一个已有的业务，SERVICETYPE字段的值标识一个撤销的业务代号。 创建IMSI与MDN关系消息体 输入消息(CRIMSI)序号标识名称M/O类型最大字节数备注g)IMSIIMSIMchar15h)MDNMDNMchar20i)STATUS状态MChar10：正常；1：不可用j)USERTYPE用户类型Mchar20:普通;1:PPC;2:WVPN;3:IVPN 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注1.RTCODE反馈结果代码MNumber4见返回代码定义2.RTDESC反馈结果信息OChar60 说明：在AAA系统上建立IMSI和MDN的对应关系，以及该用户的状态和用户类型信息。0 删除IMSI与MDN的对应关系 输入消息(DLIMSI)序号标识名称M/O类型最大字节数备注1.IMSIIMSIOchar15两者必具其一2.MDNMDNOchar20 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注k)RTCODE反馈结果代码MNumber4见返回代码定义l)RTDESC反馈结果信息OChar60 说明：删除IMSI和MDN的对应关系。1 修改MDN信息消息体 输入消息(CHIMSI)序号标识名称M/O类型最大字节数备注m)MDNMDNMchar20n)STATUS状态MChar10：正常；1：不可用o)USERTYPE用户类型Mchar20:普通;1:PPC;2:WVPN;3:IVPN 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注1.RTCODE反馈结果代码MNumber4见返回代码定义2.RTDESC反馈结果信息OChar60 说明：在AAA系统上修改MDN的对应的状态和用户类型信息。2 查询IMSI与MDN的对应关系 输入消息(QUIMSI)序号标识名称M/O类型最大字节数备注1.IMSIIMSIOchar15两者必具其一2.MDNMDNOchar20 输出消息 (IMSRSP) 序号标识名称M/O类型最大字节数备注1.IMSIIMSIMchar152.MDNMDNMchar203.STATUS状态MChar10：正常；1：不可用4.USERTYPE用户类型Mchar20:普通;1:PPC;2:WVPN;3:IVPN 说明：查询IMSI和MDN的对应关系的信息。3 换卡 输入消息（CHGTNL）序号标识名称M/O类型最大字节数备注1.NEWIMSIIMSIMchar152.MDNMDNMchar203.STATUS状态MChar10：正常；1：不可用 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注1.RTCODE反馈结果代码MNumber4见返回代码定义2.RTDESC反馈结果信息OChar60 说明：根据MDN修改IMSI。4 改号 输入消息（CHGMDN）序号标识名称M/O类型最大字节数备注1.IMSIIMSIMchar152.NEWMDNMDNMchar203.STATUS状态MChar10：正常；1：不可用 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注p)RTCODE反馈结果代码MNumber4见返回代码定义q)RTDESC反馈结果信息OChar60 说明：根据IMSI修改MDN。5 预退网 输入消息（PREQUT）序号标识名称M/O类型最大字节数备注1.MDNMDNMchar202.STATUS状态MChar10：正常；1：不可用 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注r)RTCODE反馈结果代码MNumber4见返回代码定义s)RTDESC反馈结果信息OChar60 说明：预退网是手机用户正式退网前的一个操作，将该用户IMSI和对应NAI的状态置为不可用。6 退网 输入消息（FRMQUT）序号标识名称M/O类型最大字节数备注1.NEWIMSIIMSIMchar152.MDNMDNMchar203.STATUS状态MChar10：正常；1：不可用 输出消息（FEBRSP）序号标识名称M/O类型最大字节数备注t)RTCODE反馈结果代码MNumber4见返回代码定义u)RTDESC反馈结果信息OChar60 说明：用户退网时将用户MDN与IMSI对应关系删除，以及删除与其相对应的NAI用户记录。7 VP