Portal協(xié)議分析

1、文檔可自由編輯打印AC、Portal 與 AAA交互協(xié)議分析文檔可自由編輯打印上海寰創(chuàng)通信科技有限公司文檔可自由編輯打印文檔更新記錄文檔更新記錄日期更新人版本備注2009-2-13齊霄鵬2009-2-16齊霄鵬文檔可自由編輯打印目錄目錄1PORTAL 協(xié)議協(xié)議概述協(xié)議協(xié)議概述 .52PORTAL 協(xié)議報(bào)文格式協(xié)議報(bào)文格式 .53PORTAL 協(xié)議報(bào)文字段說(shuō)明協(xié)議報(bào)文字段說(shuō)明 .54與與 PORTAL 交互中報(bào)文填充說(shuō)明交互中報(bào)文填充說(shuō)明 .64.1REQ_CHALLENGE.64.2ACK_CHALLENGE.74.3REQ_AUTH.84.4ACK_AUTH.84.5AFF_ACK_AUTH

2、.95與與 3A 相關(guān)的交互中報(bào)文填充說(shuō)明相關(guān)的交互中報(bào)文填充說(shuō)明.105.1ACCESS_REQUEST.105.2ACCOUNTING-REQUEST/START.105.3ACCOUNTING-REQUEST/INTERIM-UPDATE.115.4ACCOUNTING-REQUEST/STOP.116HTTP REQUEST PORTAL-URL.11文檔可自由編輯打印1Portal 協(xié)議協(xié)議概述協(xié)議協(xié)議概述AC 與 Portal Server 之間通過(guò) Portal 協(xié)議交互。2Portal 協(xié)議報(bào)文格式協(xié)議報(bào)文格式VerTypePap/ChapRsvSerialNoReqID012

3、3468UserIPUserPortErrCodeAttrNum57Attr .3Portal 協(xié)議報(bào)文字段說(shuō)明協(xié)議報(bào)文字段說(shuō)明VerVer 字段是協(xié)議的版本號(hào)，長(zhǎng)度為 1 字節(jié)，目前定義的值為 0 x01。TypeType 字段定義報(bào)文的類(lèi)型，長(zhǎng)度為 1 字節(jié)。Pap/ChapPap/Chap 字段定義此用戶(hù)的認(rèn)證方式，長(zhǎng)度為 1 字節(jié)，只對(duì) Type 值為 0 x03 的認(rèn)證請(qǐng)求報(bào)文有意義：chap 方式認(rèn)證（0 x00） 、Pap 方式認(rèn)證（0 x01） 。RsvRsv 目前是保留字段，長(zhǎng)度為 1 字節(jié)，在所有報(bào)文中值為 0。SerialNoSerialNo 字段是報(bào)文的序列號(hào)，長(zhǎng)度為

4、2 字節(jié)，由 Portal Server 隨機(jī)生成；由Portal Server 發(fā)給 AC 的報(bào)文；每一個(gè)由 AC 設(shè)備發(fā)給 Portal Server 的響應(yīng)報(bào)文的SerialNo 必須和 Portal Server 發(fā)送的相應(yīng)請(qǐng)求報(bào)文的 SerialNo 一樣。ReqIDReqID 字段長(zhǎng)度 2 個(gè)字節(jié)，AC 隨機(jī)生成。UserIPUserIP 字段為 Portal 用戶(hù)的 IP 地址，長(zhǎng)度是 4 字節(jié)，由 Portal Server 根據(jù)獲得的IP 地址填寫(xiě)，必填項(xiàng)。UserPortUserPort 字段目前沒(méi)有用到，長(zhǎng)度為 2 字節(jié)，在所有報(bào)文中其值為 0。ErrCodeErrCod

5、e 字段和 Type 字段一起表示一定的意義，長(zhǎng)度為 1 字節(jié)。AttrNumAttrNum 字段表示其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性） ，其值在所有的報(bào)文中都要根據(jù)具體情況賦值。Attr文檔可自由編輯打印Attr 字段（屬性字段）是一個(gè)可變長(zhǎng)字段，由多個(gè)屬性依次鏈接而成，每個(gè)屬性的格式為 TLV，如圖：AttrTypeAttrLenAttrValue.012屬性字段中每個(gè)屬性說(shuō)明如下：（1）屬性類(lèi)型（AttrType）Attr(屬性字段)AttrType屬性值長(zhǎng)度屬性含義UserName0 x01=253 （可變） 隨e行用戶(hù)名，具體為：

6、“用戶(hù)手機(jī)號(hào)碼”；全國(guó)/省內(nèi)預(yù)付費(fèi)卡用戶(hù)名稱(chēng)：13位數(shù)字；為滿(mǎn)足國(guó)際漫游的需要，支持253字節(jié)的長(zhǎng)用戶(hù)名。PassWord0 x02=16（可變）用戶(hù)提交的明文密碼Challenge0 x0316（固定） Chap方式加密的魔術(shù)字ChapPassWord0 x0416（固定）經(jīng)過(guò)Chap方式加密后的密碼（2）屬性長(zhǎng)度（AttrLen）AttrLen 字段表示屬性的長(zhǎng)度，長(zhǎng)度為 1 字節(jié)，其值是整個(gè)屬性三個(gè)字段AttrType、AttrLen、AttrValue 的長(zhǎng)度之和。（3）屬性值（AttrValue）AttrValue 的值為具體的屬性值，比如用戶(hù)名、口令等，長(zhǎng)度有些可變，有些固定，但最

7、長(zhǎng)不超過(guò) 253（255-2）字節(jié)4與與 Portal 交互中報(bào)文填充說(shuō)明交互中報(bào)文填充說(shuō)明4.1REQ_CHALLENGE序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)）值值說(shuō)明說(shuō)明1Ver10 x01協(xié)議版本號(hào)2Type10 x01報(bào)文類(lèi)型3Pap/Chap1無(wú)意義定義用戶(hù)的認(rèn)證方式4Rsv10保留字段5SerialNo2隨機(jī)報(bào)文的序列號(hào)，Portal Server 隨機(jī)生成，同一個(gè)認(rèn)證流程中所有報(bào)文的 SerialNo 相同6ReqID20該字段無(wú)意義7UserIP4IP由 Portal Server 根據(jù)獲得的 IP地址填寫(xiě)，必填8UserPort20保留字段9ErrCode10該字段

8、無(wú)意義10AttrNum10其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）文檔可自由編輯打印4.2ACK_CHALLENGE序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)）值值說(shuō)明說(shuō)明1Ver10 x01協(xié)議版本號(hào)2Type10 x02報(bào)文類(lèi)型3Pap/Chap1無(wú)意義定義用戶(hù)的認(rèn)證方式4Rsv10保留字段5SerialNo2同 4.1 中的SerialNo相同報(bào)文的序列號(hào)，與 Type 字段的值等于 0 x01 的報(bào)文相同6ReqID2Chap方式：隨機(jī)Pap方式：無(wú)意義，0Chap 方式：AC 隨機(jī)生成，AC設(shè)備的請(qǐng)求 Challenge 響應(yīng)報(bào)文

9、中把該 ReqID 的值告訴Portal Server7UserIP4IP由 Portal Server 根據(jù)獲得的IP 地址填寫(xiě)，必填8UserPort20保留字段9ErrCode10:請(qǐng)求challenge成功1:請(qǐng)求challenge拒絕2:鏈接已建立3:有一個(gè)用戶(hù)在認(rèn)證4:請(qǐng)求challenge失敗與 Type 字段一起表示一定的意義，AC 設(shè)備通知 Portal Server10AttrNum11其后可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示最多可有 255 個(gè)屬性）11AttrType10 x03屬性類(lèi)型（Challege）12AttrLenth118整個(gè)屬性三個(gè)字段At

10、trType、AttrLen、AttrVal文檔可自由編輯打印ue 的長(zhǎng)度之和13AttrValue16具體的屬性值，Chap 方式加密的魔術(shù)字4.3REQ_AUTH序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)）值值說(shuō)明說(shuō)明1Ver10 x01協(xié)議版本號(hào)2Type10 x03報(bào)文類(lèi)型3Pap/Chap1Chap:0 x00Pap:0 x01定義用戶(hù)的認(rèn)證方式4Rsv10保留字段5SerialNo2隨機(jī)報(bào)文的序列號(hào)，Portal Server 隨機(jī)生成6ReqID2Chap方式：和Type值為2 的報(bào)文中此字段的值相同Pap方式：無(wú)意義，07UserIP4IP由 Portal Server 根

11、據(jù)獲得的IP 地址填寫(xiě)，必填8UserPort20保留字段9ErrCode10字段無(wú)意義10AttrNum13其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）11AttrType10 x01屬性字段類(lèi)型（UserName）12AttrLenth1=255屬性長(zhǎng)度13AttrValue=253隨 e 行用戶(hù)名14AttrType10 x02屬性字段類(lèi)型（PassWord）15AttrLenth1=18屬性長(zhǎng)度16AttrValue=16用戶(hù)提交的明文密碼17AttrType10 x03屬性字段類(lèi)型（Challenge）18AttrLenth118屬性長(zhǎng)度1

12、9AttrValue16Chap 方式加密的魔術(shù)字文檔可自由編輯打印4.4ACK_AUTH序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)）值值說(shuō)明說(shuō)明1Ver10 x01協(xié)議版本號(hào)2Type10 x04報(bào)文類(lèi)型3Pap/Chap1無(wú)意義定義用戶(hù)的認(rèn)證方式4Rsv10保留字段5SerialNo2同 4.3 中的SerialNo相同報(bào)文的序列號(hào)，與 Type 字段的值等于 0 x03 的報(bào)文相同6ReqID2Chap方式：和Type值為2 的報(bào)文中此字段的值相同Pap方式：無(wú)意義，07UserIP4IP由 Portal Server 根據(jù)獲得的IP 地址填寫(xiě)，必填8UserPort20保留字段9E

13、rrCode10：用戶(hù)認(rèn)證成功1：用戶(hù)認(rèn)證請(qǐng)求被拒絕3：有一個(gè)用戶(hù)在認(rèn)證，青售后再試4：此用戶(hù)認(rèn)證失敗與 Type 字段一起表示一定的意義，AC 設(shè)備通知 Portal Server10AttrNum10其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）4.5AFF_ACK_AUTH序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)）值值說(shuō)明說(shuō)明文檔可自由編輯打印1Ver10 x01協(xié)議版本號(hào)2Type10 x07報(bào)文類(lèi)型3Pap/Chap1無(wú)意義定義用戶(hù)的認(rèn)證方式4Rsv10保留字段5SerialNo2同 4.3 中的SerialNo相同由 Portal S

14、erver 向 AC 設(shè)備發(fā)出的認(rèn)證成功確認(rèn)報(bào)文，與Type 字段的值等于 0 x03 的報(bào)文相同6ReqID2Chap方式：和Type值為2 的報(bào)文中此字段的值相同Pap方式：無(wú)意義，07UserIP4IP由 Portal Server 根據(jù)獲得的IP 地址填寫(xiě)，必填8UserPort20保留字段9ErrCode10字段無(wú)意義10AttrNum10其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）5與與 3A 相關(guān)的交互中報(bào)文填充說(shuō)明相關(guān)的交互中報(bào)文填充說(shuō)明5.1Access_Request序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)） 值（十進(jìn)制）值

15、（十進(jìn)制）說(shuō)明說(shuō)明1AttrNum13其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類(lèi)型（UserName）3AttrLenth1=255屬性長(zhǎng)度4AttrValue=253用戶(hù)名5AttrType12屬性字段類(lèi)型（PassWord）6AttrLenth118=.=130屬性長(zhǎng)度7AttrValue=1616=.=7屬性長(zhǎng)度10AttrValue165=.=247Chap 方式加密的魔術(shù)字文檔可自由編輯打印5.2Accounting-Request/Start序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)） 值（十進(jìn)制）值

16、（十進(jìn)制）說(shuō)明說(shuō)明1AttrNum11其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類(lèi)型（UserName）3AttrLenth1=255屬性長(zhǎng)度4AttrValue=253用戶(hù)名5.3Accounting-Request/Interim-Update序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)） 值（十進(jìn)制）值（十進(jìn)制）說(shuō)明說(shuō)明1AttrNum11其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類(lèi)型（UserName）3AttrLenth1=255屬

17、性長(zhǎng)度4AttrValue=253用戶(hù)名5.4Accounting-Request/Stop序號(hào)序號(hào)參數(shù)名稱(chēng)參數(shù)名稱(chēng)長(zhǎng)度（字節(jié)）長(zhǎng)度（字節(jié)） 值（十進(jìn)制）值（十進(jìn)制）說(shuō)明說(shuō)明1AttrNum11其后便可變長(zhǎng)度的屬性字段屬性的個(gè)數(shù)，長(zhǎng)度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類(lèi)型（UserName）3AttrLenth1=255屬性長(zhǎng)度4AttrValue=253用戶(hù)名6HTTP Request portal-urlHTTP Request portal-url（實(shí)現(xiàn)強(qiáng)制 PORTAL 功能）的相關(guān)參數(shù)當(dāng) AC 實(shí)現(xiàn)強(qiáng)制 Portal 功能時(shí)，要求強(qiáng)制 Po

18、rtal 中包含一下參數(shù)：參數(shù)名稱(chēng)參數(shù)名稱(chēng)參數(shù)取參數(shù)取值值參數(shù)說(shuō)明參數(shù)說(shuō)明認(rèn)證認(rèn)證模式模式作用階段作用階段舉例舉例wlanuserip十進(jìn)制的字符串格式網(wǎng)段在前，主機(jī)在后WLAN用戶(hù)的私網(wǎng)地址，是認(rèn)證Portal與AC之間判別WLAN用戶(hù)的身份識(shí)別碼WEB重定向認(rèn)證頁(yè)面請(qǐng)求時(shí)wlanuserip=4wlanacname十進(jìn)制的字符串格式wlanacname=ACN. .CTY. .PRO. .OPE，屬性名為嚴(yán)重定向認(rèn)證頁(yè)面請(qǐng)求時(shí)wlanacip= ACN. .CTY. .文檔可自由編輯打印參數(shù)名稱(chēng)參數(shù)名稱(chēng)參數(shù)取參數(shù)取值值參數(shù)說(shuō)明參數(shù)說(shuō)明認(rèn)證認(rèn)證模式模式作用階段作用階段舉例舉例格小寫(xiě)，屬性值為按照下列規(guī)定的AC名稱(chēng)。統(tǒng)一規(guī)定全國(guó)AC的編碼，其編碼規(guī)