charging和billing的余額操作DCC接口

1、精選優(yōu)質文檔-傾情為你奉上Billing與Charging的余額操作DCC接口1. Billing與Charging的DCC在Diameter基礎協(xié)議上擴展的應用協(xié)議Diameter Credit Control Application參數(shù)定義1.1. DiameterIETF的AAA工作組同意將Diameter協(xié)議作為下一代的AAA協(xié)議標準。Diameter(為直徑，意為著Diameter協(xié)議是RADIUS協(xié)議的升級版本)協(xié)議包括基本協(xié)議，NAS(網(wǎng)絡接入服務)協(xié)議，EAP(可擴展鑒別)協(xié)議，MIP(移動IP)協(xié)議，CMS(密碼消息語法)協(xié)議等。Diameter協(xié)議支持移動IP、NAS請求和

2、移動代理的認證、授權和計費工作，協(xié)議的實現(xiàn)和RADIUS類似，也是采用AVP，屬性值對(采用Attribute-Length-Value三元組形式)來實現(xiàn)，但是其中詳細規(guī)定了錯誤處理, failover機制,采用TCP協(xié)議，支持分布式計費，克服了RADIUS的許多缺點，是最適合未來移動通信系統(tǒng)的AAA協(xié)議。接口概述傳統(tǒng)的用于完成計費功能的Radius以前的方式采用遠程訪問撥號用戶服務RADIUS(Remote Access Dial up User Service)；Raduis英文原意為半徑，原先的目的是為撥號用戶進行鑒別和計費。后來經(jīng)過多次改進，形成了一項通用的鑒別計費協(xié)議-RADIUS

3、(遠端鑒權撥入用戶服務- Remote Authentication Dial In User Service)協(xié)議，以其簡單安全，易于管理，擴展性好，而得到廣泛應用。但是由于協(xié)議本身的缺陷，比如基于UDP的傳輸、簡單的丟包機制、沒有關于重傳的規(guī)定和集中式計費服務，都使得它不太適應當前網(wǎng)絡的發(fā)展，需要進一步改進。隨著新的接入技術的引入和移動網(wǎng)絡的快速擴容，對AAA啥意思，AAA協(xié)議指的是Authentication（鑒別），Authorization（授權），Accounting（計費）。協(xié)議提出了新的要求，使得傳統(tǒng)的RADIUS結構的缺點日益明顯。目前3G網(wǎng)絡正逐步向全IP網(wǎng)絡演進，不僅在核

4、心網(wǎng)絡使用支持IP的網(wǎng)絡實體，在接入網(wǎng)絡也使用基于IP的技術，而且移動終端也成為可激活的IP客戶端。這就需要采用新一代的AAA協(xié)議Diameter。Diameter基礎協(xié)議為各種認證、授權和計費業(yè)務提供了安全、可靠、易于擴展的框架。以此為基礎定義Diameter應用，只需要定義應用協(xié)議的應用標識、參與通信的網(wǎng)絡功能實體、相互通信的功能實體間的消息內(nèi)容以及協(xié)議過程，就可以完全依賴Diameter基礎協(xié)議完成特定的接入和應用業(yè)務。Diameter協(xié)議具有如下特性： (1)擁有良好的失敗機制，支持失敗替代(failover)和失敗回溯(faiback)；(2)擁有快速檢測到對端不可達的能力； (3)

5、擁有更好的包丟棄處理機制，Diameter協(xié)議要求對每個消息進行確認；(4)可以保證數(shù)據(jù)體的完整性和機密性； (5)支持端到端安全，支持TLS和IPSec； (6)為每個會話進行認證/授權，以保證安全性； 在Diameter基礎協(xié)議上擴展的應用協(xié)議Diameter Credit Control Application，定義了針對預付費用戶的計費機制，采用信用額度控制實現(xiàn)了基于會話及事件的計費，解決了對于預付費的計費需求。1.2. DCC消息結構定義DiameterCC協(xié)議的消息結構如下，這些字段是以網(wǎng)絡字節(jié)順序傳送的。0123012345670123456701234567012345671V

6、ersionMessage Length2command flagsCommand-Code3Application-ID4Hop-by-Hop Identifier5End-to-End Identifier6AVPAVP（Attribute Value Pair）s.NAVPs其中，AVP結構為：0123012345670123456701234567012345671AVP Code2VMPrRrrrAVP Length3Vendor-ID (opt)4Data.NData說明：在消息體定義中，類型域中的OctetStringN（N為整數(shù)），由基本類型OctetString派生出來，限制

7、長度不大于N；必選屬性域“M”表示該AVP在消息中必選，“C”表示該AVP在消息中條件可選。AVP名稱前面的*表示該AVP是可重復的。對于AVP的M位屬性和Vendor-ID定義參見接口總冊。1.3. CCR和CCA消息定義1.3.1. Credit-Control-Request消息定義 <CCR> := < Diameter Header: 272, REQ, PXY > < Session-Id > Origin-Host Origin-Realm Destination-Realm Auth-Application-Id Service-Contex

8、t-Id CC-Request-Type CC-Request-Number Destination-Host User-Name Origin-State-Id Event-Timestamp * Subscription-Id Termination-Cause Requested-Action Multiple-Services-Indicator * Multiple-Services-Credit-Control Service-Information * AVP AVP名稱AVP代碼數(shù)據(jù)類型必選屬性描述Session-Id263UTF8StringMDiameter會話ID。格式：

9、<DiameterIdentity><high 32 bits><low 32 bits><optional value><DiameterIdentity>同Origin-Host。<high 32 bits>表示系統(tǒng)當前時間的10進制字符串。<low 32 bits>表示循環(huán)遞增，初始值為0，系統(tǒng)重新啟動時設置為0。<optional value>保留。以上各字段以“;”字符相隔。例如：C;523 Origin-Host264DiameterIdentityM發(fā)出Diameter消息的主機Ori

10、gin-Realm296DiameterIdentityM發(fā)出Diameter消息的主機所在的域Destination-Host293DiameterIdentityC目的主機Destination-Realm283DiameterIdentityM目的主機所在的域Auth-Application-Id258Unsigned32M用于重認證/授權的應用唯一標識。DCCA 4Service-Context-Id461UTF8StringM一個DCC業(yè)務的唯一標識（可擴展）。余額管理：ABMCC-Request-Type416EnumeratedM請求類型。1：INITIAL_REQUEST2：U

11、PDATE_REQUEST3：TERMINATION_REQUEST4：EVENT_REQUESTCC-Request-Number415Unsigned32M請求流水號，用于唯一標識Diameter會話的一個請求。User-Name1UTF8StringCNAI格式的用戶名稱。Origin-State-Id278Unsigned32COrigin-Host的狀態(tài)ID。Event-Timestamp55TimeC事件發(fā)生的時間。*Subscription-Id443GroupedM用于標識業(yè)務簽約方終端用戶的信息。呼叫流程時填寫計費方信息該AVP組包含：Subscription-id-type

12、Subscription-id-dataSubscription-Id-Type450EnumeratedMEND_USER_E164：0END_USER_IMSI：1END_USER_SIP_URI：2END_USER_NAI：3END_USER_PRIVATE：4 Subscription-Id-Data444UTF8StringM終端用戶標志。Termination-Cause295EnumeratedC說明：用于指示Diameter客戶端會話終止的原因。定義了如下的值：DIAMETER_LOGOUT 1用戶發(fā)起的中斷。DIAMETER_SERVICE_NOT_PROVIDED 2當用戶

13、在接收到授權應答消息之前斷開時使用本值。DIAMETER_BAD_ANSWER 3表示Diameter客戶端收到的授權應答未被成功處理。DIAMETER_ADMINISTRATIVE 4因為管理原因，如接收到Abort-Session-Request消息等，用戶沒有獲得接入授權或連接被斷開。DIAMETER_LINK_BROKEN 5與用戶的通信突然斷開。DIAMETER_AUTH_EXPIRED 6因為授權的會話時間到期，用戶的接入終止。DIAMETER_USER_MOVED 7用戶正在接受其它Diameter客戶端的服務。DIAMETER_SESSION_TIMEOUT 8用戶的會話超時，

14、服務已經(jīng)終止Requested-Action436EmumeratedC如果CCR命令中CC-Request-Type的值設置為EVENT_REQUEST，則Requested_Action AVP中包含了所要請求的行為。DIRECT_DEBITING 0REFUND_ACCOUNT 1CHECK_BALANCE 2PRICE_ENQUIRY 3 REQUEST_BALANCE 4 （余額申請）AGGREGATE_ENQUIRY 5 (累計量查詢)Multiple-Services-Credit-Control456GroupedC包含多業(yè)務獨立信用控制相關的AVP。目前每個實例攜帶一個業(yè)務。

15、Requested-Service-Unit437GroupedC請求使用單元 CC-Time420Unsigned32C請求使用的時間。單位：秒。 CC-Money413GroupedC說明：該值給出了指定貨幣的金額總數(shù)。 Unit-Value445GroupedM說明：十進制的數(shù)值。由Value-Digits，Exponent組合表示具體的一個指數(shù)形式的數(shù)。 Value-Digits447Integer64M說明：包含數(shù)值的有效數(shù)字（不包括原數(shù)值中的小數(shù)點）。如果由于小數(shù)點不存在而導致與原數(shù)值大小不同，則必須在Exponent中填入十的指數(shù)。例如，表示0.05這個數(shù)， Value-Digi

16、ts AVP 必須設置成5，而Exponent AVP值必須設置成-2。 Exponent429Integer32C說明：Unit-Value中的指數(shù)部分。如果Exponent缺失，必須認為指數(shù)為0。 Currency-Code425Unsigned32C說明：貨幣代碼。指明了金錢單位所使用了哪種貨幣。在 ISO 4217 standard ISO4217，定義了具體的值。 CC-Total-Octets421Unsigned64C已使用的上下行總字節(jié)數(shù)。 CC-Input-Octets412Unsigned64C從終端用戶收到的已使用字節(jié)數(shù)。 CC-Output-Octets414Unsig

17、ned64C發(fā)送到終端用戶的已使用字節(jié)數(shù)。 CC-Service-Specific-Units417Unsigned64C已使用的特定業(yè)務單元數(shù)，出現(xiàn)在某些業(yè)務的授權單元不是以時間或流量為計量單位的情況。 *Used-Service-Unit446GroupedC從上一次測算結束點開始所測算出的已使用單元總數(shù)。 Reporting-Reason872EnumeratedC3GPP擴展，指明為單個或多個類型的配額上報使用情況的原因。 Tariff-Change-Usage452EmumeratedC定義了在一個報告周期中發(fā)生費率切換時，所使用的單元是在費率切換前、后，或者跨越不同的費率。如果該A

18、VP被忽略，表明沒用費率切換發(fā)生。 CC-Time420Unsigned32C已使用的時間。單位：秒。 CC-Total-Octets421Unsigned64C已使用的上下行總字節(jié)數(shù)。 CC-Input-Octets412Unsigned64C從終端用戶收到的已使用字節(jié)數(shù)。 CC-Output-Octets414Unsigned64C發(fā)送到終端用戶的已使用字節(jié)數(shù)。 CC-Service-Specific-Units417Unsigned64C已使用的特定業(yè)務單元數(shù)。 Service-Identifier439Unsigned32C業(yè)務識別標識。 Reporting-Reason872Enum

19、eratedC3GPP擴展，指明為單個或多個類型的配額上報使用情況的原因。 Trigger1264GroupedC觸發(fā)器。如果存在該參數(shù)但是不包含任何Trigger-Type，則禁止任何觸發(fā)器。 *Trigger-Type870EnumeratedC用于指示單個重授權事件類型。Service-Information873GroupedC業(yè)務信息組 ABM-InformationGroupedC余額管理信息組ABM-Information：AVP名稱AVP代碼數(shù)據(jù)類型必選屬性描述*Request-Current-BalanceGroupedC當前帳戶余額信息 Account-IdUTF8Stri

20、ngM帳戶ID Account-Book-TypeUTF8StringM帳本類型 BalanceInteger64M帳本余額數(shù)值（單位為分）Effect-DateTimeM帳本生效時間Expire-DateTimeM帳本實效時間*Report-Aggregate-InfoGroupedC累計量信息 Aggregate-Type-IdUTF8StringM累計量類型標識 Aggregate-Cycle-IdUTF8StringM累計周期標識 Aggregate-AmountInteger64M累計量數(shù)值1.3.2. Credit-Control-Answer消息定義 <CCA> :=

21、 < Diameter Header: 272, PXY > < Session-Id > Result-Code Origin-Host Origin-Realm Auth-Application-Id CC-Request-Type CC-Request-Number CC-Session-Failover * Multiple-Services-Credit-Control Cost-Information Credit-Control-Failure-Handling Direct-Debiting-Failure-Handling * Redirect-Hos

22、t Redirect-Host-Usage Redirect-Max-Cache-Time * Failed-AVP Service-Information * AVP AVP名稱AVP代碼數(shù)據(jù)類型必選屬性描述Session-Id263UTF8StringMDiameter會話ID。Result-Code268Unsigned32MResult-Code數(shù)據(jù)域包括一個由INAN管理的32位地址空間表示錯誤。1xxx: Informational2xxx: Success3xxx: Protocol Errors4xxx: Transient Failures5xxx: Permanent Fa

23、ilureOrigin-Host264DiameterIdentityM發(fā)出Diameter消息的主機。Origin-Realm296DiameterIdentityM發(fā)出Diameter消息的主機所在的域。Auth-Application-Id258Unsigned32M用于重認證/授權的應用唯一標識。 DCCA 4CC-Request-Type416EnumeratedM請求類型。1：INITIAL_REQUEST2：UPDATE_REQUEST3：TERMINATION_REQUEST4：EVENT_REQUEST CC-Request-Number415Unsigned32M請求流水號

24、，用于唯一標識Diameter會話的一個請求。CC-Session-Failover418EnumeratedC標明是否支持在一個CC會話進行過程中將CC消息流轉向備用服務器。*Multiple-Services-Credit-Control456GroupedC包含多業(yè)務獨立信用控制相關的AVP。 Granted-Service-Unit431GroupedC包含允許DCC客戶端給終端用戶提供服務的單元總數(shù)，當這些單元被用完后，DCC客戶端必須向DCC服務器申請新的配額，或者停止向終端用戶提供服務。 Tariff-Time-Change451TimeC費率切換機制對于客戶端和服務器是可選的，

25、且不在基于連續(xù)時間的業(yè)務中使用。 CC-Time420Unsigned32C分配的時間。單位：秒。 CC-Total-Octets421Unsigned64C分配的上下行總字節(jié)數(shù)。 CC-Input-Octets412Unsigned64C分配的上行字節(jié)數(shù)。 CC-Output-Octets414Unsigned64C分配的下行字節(jié)數(shù)。 CC-Service-Specific-Units417Unsigned64C分配使用的特定業(yè)務單元數(shù)。 *Service-Identifier439Unsigned32C業(yè)務識別標識，通過Service-Context-ID和Service-Identifi

26、er的組合可以唯一標識該請求相關的業(yè)務。 Validity-Time448Unsigned32C該AVP由DCC服務器發(fā)送給DCC客戶端，包含所分配的業(yè)務單元的有效時間，以秒計。 Result-Code268Unsigned32C該AVP顯示一個特定的請求是成功完成或者是出現(xiàn)錯誤。 Final-Unit-Indication430GroupedC指示在CCA消息（或者AA應答）中Granted-Service-Unit包含業(yè)務的最后單元數(shù)。當這些單元用完后，DCC客戶端負責執(zhí)行在Final-Unit-Action中指定的行為。 Final-Unit-Action449EnumeratedC指示

27、DCC客戶端當用戶帳戶余額無法支付業(yè)務費用時將采取的行動。 Redirect-Server434GroupedC包含重定向服務器。 Redirect-Address-Type433EmumeratedM定義了Redirect-Server-Address中提供的地址類型。 Redirect-Server-Address435UTF8StringM定義了重定向服務器。 Time-Quota-Threshold868Unsigned32C包含以秒計的門限。如果收到Time-Quota-Threshold，DCC客戶端在剩余配額低于Time-Quota-Threshold定義的門限值時將向服務器端發(fā)

28、起CCR重新授權申請新的配額。在重新授權過程中，DCC客戶端將允許用戶繼續(xù)使用業(yè)務，直到先前的配額全部用完。 Volume-Quota-Threshold 869Unsigned32C包含以字節(jié)計的門限值。 Unit-Quota-Threshold1226Unsigned32C包含以特定業(yè)務單元計的門限值。 Quota-Holding-Time871Unsigned32C配額占用時間，單位為秒。 Quota-Consumption-Time881Unsigned32C配額空耗時間，單位為秒。 Trigger1264GroupedC觸發(fā)器。如果存在該參數(shù)但是不包含任何Trigger-Type，則

29、禁止任何觸發(fā)器。 *Trigger-Type870EnumeratedC用于指示單個重授權事件類型。 PS-Furnish-Charging-Information865GroupedC將OCS返回的特殊數(shù)據(jù)插入到CDR中 3GPP-Charging-Id2OctetStringM計費標識符 PS-Free-Format-Data866OctectStringMOCS返回的特殊數(shù)據(jù) PS-Append-Free-Format-Data867EnumeratedC數(shù)據(jù)處理方式：0 加在后面1 覆蓋Cost-Information423GroupedC業(yè)務相關的費用信息 Unit-Value445

30、GroupedM由Value-Digits，Exponent組合表示具體的一個指數(shù)形式的數(shù) Value-Digits447Integer64M不含小數(shù)點的有效數(shù)值 Exponent429Integer32CUnit-Value的指數(shù)部分 Currency-Code425Unsigned32M貨幣代碼（在ISO4217中定義） Cost-Unit424UTF8StringC計算的單元,可以是分鐘、小時、天、千字節(jié)、兆字節(jié)等等。Credit-Control-Failure-Handling427EnumeratedC從客戶端發(fā)送給服務器的CC消息因為網(wǎng)絡問題而暫時失敗時，CC客戶端使用該AVP中的

31、信息決定下一步如何做。Direct-Debiting-Failure-Handling428EnumeratedC當從CC客戶端發(fā)送到CC服務器的CC消息（Requested-Action AVP 設置為Dierect Debiting）由于網(wǎng)絡故障而臨時失敗時，CC客戶端使用該AVP中的信息來決定下一步的行為。Service-Information873GroupedC業(yè)務信息組 ABM-InformationGroupedC余額管理業(yè)務信息組ABM-Information:AVP名稱AVP代碼數(shù)據(jù)類型必選屬性描述*Granted-Account-BalanceGroupedC授權的帳戶余額

32、信息 Account-IdUTF8StringM帳戶ID Acct-Book-TypeUTF8StringM帳本類型 CC-Money413GroupedC返回的授權量說明：該值給出了指定貨幣的金額總數(shù)。 Unit-Value445GroupedM說明：十進制的數(shù)值。由Value-Digits，Exponent組合表示具體的一個指數(shù)形式的數(shù)。 Value-Digits447Integer64M說明：包含數(shù)值的有效數(shù)字（不包括原數(shù)值中的小數(shù)點）。如果由于小數(shù)點不存在而導致與原數(shù)值大小不同，則必須在Exponent中填入十的指數(shù)。例如，表示0.05這個數(shù)， Value-Digits AVP 必須設

33、置成5，而Exponent AVP值必須設置成-2。 Exponent429Integer32C說明：Unit-Value中的指數(shù)部分。如果Exponent缺失，必須認為指數(shù)為0。 Currency-Code425Unsigned32C說明：貨幣代碼。指明了金錢單位所使用了哪種貨幣。在 ISO 4217 standard ISO4217，定義了具體的值。Eff-DateTimeM帳本生效時間Exp-DateTimeM帳本實效時間*Report-Aggregate-InfoGroupedC累計量信息 Aggregate-Type-IdUTF8StringM累計量類型標識 Aggregate-Cy

34、cle-IdUTF8StringM累計周期標識 Aggregate-AmountInteger64M累計量數(shù)值1.4. DWR和DWA消息定義略1.5. ASR和ASA消息定義略1.6. CER和CEA略1.7. Result-Code定義參考中國聯(lián)通IT系統(tǒng) BSS系統(tǒng)域 在線計費(OCS)接口規(guī)范-接口總冊2. Billing與Charging的接口定義2.1. 省分Charging向總部Billing申請余額2.1.1. 業(yè)務描述在業(yè)務使用、周期性費用扣取等處理中，當省分Charging發(fā)現(xiàn)本地余額不足時，Charging向總部Billing發(fā)送余額申請請求。2.1.2. 接口定義接口名

35、稱 余額申請C2B接口協(xié)議DCC發(fā)起方省分Charging接受方總部Billing2.1.3. 請求參數(shù)(僅列出主要參數(shù))AVP名稱描述Session-IdDiameter會話ID。例如：C;523 CC-Request-Type請求類型。4：EVENT_REQUEST*Subscription-Id用于標識業(yè)務簽約方終端用戶的信息。呼叫流程時填寫計費方信息該AVP組包含：Subscription-id-typeSubscription-id-dataSubscription-Id-TypeEND_USER_E164：0Subscription-Id-Data手機號碼（如：78）Request

36、ed-ActionREQUEST_BALANCE 4 （余額申請）Service-Information業(yè)務信息組 ABM-Information余額管理信息組*Request-Current-Balance當前帳戶余額信息 Account-Id帳戶ID Account-Book-Type帳本類型 Balance帳本余額數(shù)值（單位為分）Effect-Date帳本生效時間Expire-Date帳本實效時間*Report-Aggregate-Info累計量信息 Aggregate-Type-Id累計量類型標識 Aggregate-Cycle-Id累計周期標識 Aggregate-Amount累計量

37、數(shù)值2.1.4. 響應參數(shù)(僅列出主要參數(shù))AVP名稱描述Session-IdDiameter會話ID。Result-CodeResult-Code數(shù)據(jù)域包括一個由INAN管理的32位地址空間表示錯誤。CC-Request-Type請求類型。4：EVENT_REQUEST Service-Information業(yè)務信息組 ABM-Information余額管理業(yè)務信息組*Granted-Account-Balance授權的帳戶余額信息 Account-Id帳戶ID Acct-Book-Type帳本類型 CC-Money返回的授權量說明：該值給出了指定貨幣的金額總數(shù)。 Unit-Value說明：

38、十進制的數(shù)值。由Value-Digits，Exponent組合表示具體的一個指數(shù)形式的數(shù)。 Value-Digits Exponent Currency-CodeEff-Date帳本生效時間Exp-Date帳本實效時間2.2. 總部Billing向省分Charging申請余額2.2.1. 業(yè)務描述在實現(xiàn)跨多個Charging系統(tǒng)共享余額業(yè)務中（例如：A省和B省兩個用戶共享余額），當A省用戶余額不足時，A省Charging向總部Billing申請余額。而總部Billing無余額可用，則向B省用戶申請余額后，再授權給A省用戶使用。2.2.2. 接口定義接口名稱 余額申請B2C接口協(xié)議DCC發(fā)起方總

39、部Billing接受方省分Charging2.2.3. 請求參數(shù)(僅列出主要參數(shù))AVP名稱描述Session-IdDiameter會話ID。例如：C;523 CC-Request-Type請求類型。4：EVENT_REQUEST*Subscription-Id用于標識業(yè)務簽約方終端用戶的信息。呼叫流程時填寫計費方信息該AVP組包含：Subscription-id-typeSubscription-id-dataSubscription-Id-TypeEND_USER_E164：0Subscription-Id-Data手機號碼（如：78）Requested-ActionREQUEST_BALANCE 4 （余額申請）2.2.4. 響應參數(shù)(僅列出主要參數(shù))AVP名稱描述Session-IdDiam