張 楠

（上海航空工業(yè)（集團(tuán)）有限公司，上海 200000）

0 引言

隨著制造型企業(yè)的業(yè)務(wù)不斷拓展及生產(chǎn)制造工藝的升級。承載企業(yè)各業(yè)務(wù)運(yùn)轉(zhuǎn)的企業(yè)業(yè)務(wù)管理系統(tǒng)也逐漸增多。為避免出現(xiàn)信息孤島，方便管理決策，基于高內(nèi)聚和低耦合的軟件開發(fā)思想，各個(gè)系統(tǒng)之間的信息交互大多利用接口的方式加以實(shí)現(xiàn)。而隨著發(fā)布的接口和對已發(fā)布接口調(diào)用情況大量增長，如果沒有對接口進(jìn)行系統(tǒng)性管理，當(dāng)遇到接口遷移及接口升版的時(shí)候就需要收集接口調(diào)用的情況，及時(shí)通知調(diào)用系統(tǒng)做出相應(yīng)變更，這樣接口遷移升版的成本就會大大提高。當(dāng)接口調(diào)用異?；蛘呓涌谡{(diào)試時(shí)，如果沒有接口日志存在，定位問題位置也變得很困難。當(dāng)需要實(shí)時(shí)開放某個(gè)接口對某系統(tǒng)調(diào)用權(quán)限時(shí)，如果沒有相應(yīng)的權(quán)限管理，也無法通過配置的方式實(shí)時(shí)響應(yīng)。因此建立一套能夠管理接口信息、接口權(quán)限及接口調(diào)用記錄的接口管理系統(tǒng)是非常有必要的。

接口管理的主要目的是提高接口的開發(fā)人員、運(yùn)維人員和方案人員的工作效率，使他們都專注于自己擅長做的事情。開發(fā)人員只需要開發(fā)接口的實(shí)現(xiàn)邏輯，不需要關(guān)心接口的權(quán)限；運(yùn)維人員只需要在管理界面配置各個(gè)接口對于各個(gè)系統(tǒng)的訪問權(quán)限，不需要再聯(lián)系開發(fā)人員修改代碼，也不需要重啟整個(gè)服務(wù)；方案人員通過接口的信息管理和調(diào)用記錄管理可以清晰直觀的了解到接口運(yùn)行的現(xiàn)狀，能夠?qū)涌趦?yōu)化遷移造成的影響有更準(zhǔn)確的評估。

REST 是一種新的互聯(lián)網(wǎng)應(yīng)用架構(gòu)。REST 充分利用HTTP 的優(yōu)勢，以資源為核心，將資源的CRUD 操作（create 添加數(shù)據(jù)、read 讀取數(shù)據(jù)、update 修改數(shù)據(jù)、delete 刪除數(shù)據(jù)）映射為HTTP 的GET、PUT、POST、DELTE 等方法。由于REST 式的Web 服務(wù)提供了統(tǒng)一的接口和資源定位，簡化了Web 服務(wù)接口的設(shè)計(jì)和實(shí)現(xiàn)，降低了web 服務(wù)的復(fù)雜度，它最大的優(yōu)勢就是無需引入笨重的SOAP 協(xié)議，無需建立龐大的XML 消息，可以很好地支持緩存，具有無狀態(tài)性，保持請求調(diào)用彼此獨(dú)立[1]。因此，可以利用REST 架構(gòu)發(fā)布接口，通過AOP（即面向切面編程）在系統(tǒng)底層添加權(quán)限攔截及日志記錄，再利用Spring 多數(shù)據(jù)源技術(shù)連通各個(gè)數(shù)據(jù)源，實(shí)現(xiàn)對接口信息、數(shù)據(jù)、權(quán)限、日志的統(tǒng)一管控，達(dá)到方便開發(fā)人員開發(fā)、方便運(yùn)維人運(yùn)維、方便方案人員統(tǒng)覽全局的效果。形成了企業(yè)內(nèi)部的接口網(wǎng)，為后續(xù)新系統(tǒng)的開發(fā)，舊系統(tǒng)的改造都提供了極大的便利和支持。

1 接口管理實(shí)現(xiàn)

1.1 接口調(diào)用安全設(shè)計(jì)

接口是基于系統(tǒng)之間高內(nèi)聚，低耦合的開發(fā)思想用于系統(tǒng)間信息交互的工具，接口調(diào)用最核心的問題就是數(shù)據(jù)安全問題。因此，我設(shè)計(jì)的統(tǒng)一的接口管控系統(tǒng)必須要有一套完善的安全機(jī)制保證接口數(shù)據(jù)傳輸?shù)陌踩浴?/p>

外部系統(tǒng)調(diào)用開發(fā)人員發(fā)布的接口時(shí)，系統(tǒng)會自動校驗(yàn)以下權(quán)限保證接口數(shù)據(jù)的安全。整個(gè)調(diào)用檢驗(yàn)過程如圖1 所示，外部系統(tǒng)需要經(jīng)過系統(tǒng)合法性校驗(yàn)，系統(tǒng)IP校驗(yàn)，接口訪問權(quán)限校驗(yàn)三重校驗(yàn)才能訪問到指定接口。

圖1 接口調(diào)用過程圖

（1）系統(tǒng)合法性校驗(yàn)，系統(tǒng)合法性校驗(yàn)主要是校驗(yàn)外部系統(tǒng)是否在接口系統(tǒng)中注冊，且在有效期范圍內(nèi)，并且驗(yàn)證此次調(diào)用使用的用戶名和密碼是否合法, 防止接口被非法系統(tǒng)匿名調(diào)用。

（2）系統(tǒng)IP 校驗(yàn)，系統(tǒng)IP 校驗(yàn)主要是校驗(yàn)外部系統(tǒng)是否為指定服務(wù)器IP 地址段訪問，防止非法系統(tǒng)盜取注冊系統(tǒng)的用戶名密碼后非法調(diào)用接口數(shù)據(jù)。

（3）接口訪問權(quán)限校驗(yàn)，接口訪問權(quán)限校驗(yàn)主要是校驗(yàn)外部系統(tǒng)是否具有訪問某具體接口的權(quán)限，如圖2所示，每個(gè)外部系統(tǒng)可以在接口管理系統(tǒng)中注冊多個(gè)用戶，每個(gè)用戶可以訪問多個(gè)發(fā)布的接口地址，這樣就可以實(shí)現(xiàn)每個(gè)接口可以授權(quán)給多個(gè)不同的外部系統(tǒng)，每個(gè)外部系統(tǒng)也可以訪問多個(gè)不同的接口。

圖2 調(diào)用系統(tǒng)與接口關(guān)系圖

1.2 接口系統(tǒng)功能設(shè)計(jì)

接口管理主要功能包括接口信息管理、接口權(quán)限管理和接口日志管理三個(gè)部分。如圖3 所示。

圖3 功能模塊示意圖

（1）接口信息管理包括接口基本信息管理、接口調(diào)用系統(tǒng)管理和接口說明文檔管理，這樣就可以讓管理人員對整個(gè)接口系統(tǒng)的所有接口的信息有一個(gè)整體了解。其中，

接口基本信息的管理,即接口的地址、開發(fā)者、發(fā)布狀態(tài)等信息的管理。

接口調(diào)用系統(tǒng)管理即注冊在接口系統(tǒng)的外部調(diào)用系統(tǒng)的信息管理，主要包括調(diào)用系統(tǒng)的IP 地址段、調(diào)用系統(tǒng)的描述、調(diào)用系統(tǒng)的注冊有效時(shí)間等信息。

接口說明文檔管理即接口的邏輯說明文檔，調(diào)用Demo 文檔的管理。

（2）接口日志管理包括請求記錄日志管理、請求異常日志管理、請求耗時(shí)日志，這是接口系統(tǒng)在底層切面上對每次接口http 調(diào)用請求做了的日志輸出，開發(fā)人員在開發(fā)接口邏輯的時(shí)候就不需要在關(guān)心日志的輸出問題了。日志記錄的入?yún)ⅰ⒊鰠?、?bào)錯信息和耗時(shí)在接口調(diào)試或者日常運(yùn)維中是個(gè)很有用的工具，方便接口調(diào)試，快速定位問題。此外，通過基于收集到的日志數(shù)據(jù)，還可以用于接口運(yùn)行情況的展示監(jiān)控，管理人員可以很直觀的了解到接口運(yùn)行的狀況是否良好。

（3）接口權(quán)限管理包括登錄授權(quán)、IP 授權(quán)、接口訪問授權(quán)，這個(gè)在上文已經(jīng)做了詳細(xì)描述，這里就不再贅述了。

2 結(jié)語

制造型企業(yè)的業(yè)務(wù)系統(tǒng)種類繁多，為了避免信息孤島，使用接口打通各個(gè)系統(tǒng)間的信息流是必需的[2]。企業(yè)內(nèi)部接口的數(shù)量龐大，如果把接口的管理分散在各個(gè)系統(tǒng)或以文檔的形式對接口進(jìn)行管理，沒有形成一個(gè)整體統(tǒng)一的接口管理，那么無論是新的系統(tǒng)調(diào)用、接口發(fā)布，還是舊的接口升級，都會因?yàn)槿狈φw上的管控而產(chǎn)生大量接口聯(lián)調(diào)工作，甚至因?yàn)樾畔⑹占蝗畔⑹占氖杪?dǎo)致接口傳輸不通，數(shù)據(jù)傳輸錯誤等問題。這是接口管理的一個(gè)很大的痛點(diǎn)。因此，對于這類比較容易被忽視的接口信息在企業(yè)內(nèi)部做統(tǒng)一管控是一個(gè)必然。本研究只是對企業(yè)統(tǒng)一接口管理理念的一次探索嘗試，雖然對于數(shù)據(jù)的傳輸安全，接口執(zhí)行的效率等方面的考慮還不是很完善，但是在實(shí)際應(yīng)用中對于開發(fā)、運(yùn)維、實(shí)施等工作的效率提升是顯而易見的。