Azure API Management （2）體驗開發(fā)者門戶,微軟azure云搭建服務(wù)器-ESG跨境

Azure API Management （2）體驗開發(fā)者門戶,微軟azure云搭建服務(wù)器

Azure API Management （2）體驗開發(fā)者門戶

于書振

原國家電網(wǎng)公司特高壓電力專家,原中國聯(lián)通5G創(chuàng)新中心高級解決方案經(jīng)理，國內(nèi)較早實施5G智慧港口和邊緣計算的新基建踐行者。十余年特高壓/智慧城市/5G/云計算/物聯(lián)網(wǎng)等領(lǐng)域的工作經(jīng)驗，Microsoft Certified Azure Solutions Architect Expert，Microsoft Certified Azure IoT Developer Specialty，Microsoft Certified Trainer，2020年被評為微軟MVP。他熱心社區(qū)奉獻(xiàn)，運(yùn)營公眾號“云計算實戰(zhàn)”分享接地氣的Azure IoT和AI實戰(zhàn)內(nèi)容，同時為每一個實戰(zhàn)內(nèi)容制作了15分鐘左右的視頻講解發(fā)布在B站和其博客https://www.51azure.cloud

幾個重要的概念

1.API

導(dǎo)入或者在Azure Portal上創(chuàng)建的一組API或者多組API，例如導(dǎo)入了一組訂單相關(guān)API和一組庫存相關(guān)API；

2.產(chǎn)品

產(chǎn)品包含至少一組API，通常產(chǎn)品把多組API打包在一起，形成一個包含多種功能的一個集合，例如：定義了一個產(chǎn)品“進(jìn)銷存”，該產(chǎn)品包含一組訂單相關(guān)的API和一組庫存相關(guān)的API；

3.用戶

這里的用戶通常指使用API Management的人員，其中包含要調(diào)用你發(fā)布的API的開發(fā)人員。

4.組

組指的用戶組，一個組可以包含多個成員，也就是包含多個“用戶”，系統(tǒng)內(nèi)置了“Administrator”，“Developer”，“Guests”三個組。

5.訂閱

訂閱決定了哪個”用戶“可以調(diào)用哪個“API”或者哪個“產(chǎn)品”。

訂閱是綁定到“用戶”上的，訂閱能控制某個API或某個產(chǎn)品。

6.開發(fā)人員門戶（developer portal）

通常情況下，開發(fā)人員門戶是提供給“用戶”，也就是要調(diào)用你API的人員使用的一個門戶網(wǎng)站。

用戶可以在這個網(wǎng)站維護(hù)自己的賬號信息，查看自己的訂閱信息，查看API文檔/在線測試API。

默認(rèn)情況下，他的url后半部分為：developer.azureapi.net;

可以在開發(fā)人員門戶上提交注冊信息，根據(jù)配置，可能需要審核或自動完成審核，然后便成了“用戶”，用戶可以根據(jù)API及產(chǎn)品是否需要訂閱或者訂閱權(quán)限調(diào)用對應(yīng)的API。

在開發(fā)人員門戶上自主注冊的用戶，默認(rèn)自動分配到“Developer”組中。

通常整體的使用流程是：

管理員（也就是API的提供者）從Azure Portal導(dǎo)入后端API

管理員在Azure Portal對導(dǎo)入的API進(jìn)行設(shè)置，比如增加流控等功能

管理員在Azure Portal創(chuàng)建一個包含一組或多組API的產(chǎn)品并發(fā)布

管理員在Azure Portal發(fā)布開發(fā)人員門戶（通常該步驟僅執(zhí)行一次）

用戶從開發(fā)人員門戶自主注冊或者從管理員從Azure Portal上注冊用戶

管理員從Azure門戶上為用戶創(chuàng)建訂閱

用戶在開發(fā)人員門戶學(xué)習(xí)如何調(diào)用API并做測試

用戶在自己的業(yè)務(wù)系統(tǒng)中調(diào)用API

01

管理員（也就是API的提供者）從Azure Portal導(dǎo)入后端API

上一講分享的內(nèi)容中，我們已經(jīng)完成了API的導(dǎo)入，本文不再贅述，如果您尚未完成API導(dǎo)入，請參照《Azure API Management（1）Create APIM And Add First API,創(chuàng)建Azure APIM并添加后端API》

02

管理員在Azure Portal對導(dǎo)入的API進(jìn)行設(shè)置，比如增加流控等功能

流控等功能我們在以后的章節(jié)中介紹，本文可以跳過這個步驟。

03

管理員在Azure Portal創(chuàng)建一個包含一組或多組API的產(chǎn)品并發(fā)布

注意：

3處的狀態(tài)為“未發(fā)布”，未發(fā)布的產(chǎn)品不會在開發(fā)者門戶中看到。稍后需要執(zhí)行”發(fā)布產(chǎn)品“操作后，才會出現(xiàn)在開發(fā)者門戶中；

3處的“需要訂閱”如果不勾選，則用戶在開發(fā)者門戶中無需訂閱即可進(jìn)行該產(chǎn)品關(guān)聯(lián)api的調(diào)用；

5處的API可以選擇多個或者一個；

產(chǎn)品創(chuàng)建完成后，默認(rèn)的訪問控制組在“Administrator”中，如果需要被“開發(fā)者么戶”中創(chuàng)建的用戶訪問，則需要添加“developers”組，因為從門戶自主注冊的用戶，默認(rèn)為“developers”組：

發(fā)布產(chǎn)品，只有發(fā)布后的產(chǎn)品，才會顯示在開發(fā)人員門戶中：

04

管理員在Azure Portal發(fā)布開發(fā)人員門戶（通常該步驟僅執(zhí)行一次）

注意：如果不開啟cors，則用戶在開發(fā)人員門戶上無法測試api調(diào)用。

05

用戶從開發(fā)人員門戶自主注冊或者從管理員從Azure Portal上注冊用戶

點(diǎn)擊開發(fā)人員門戶可以進(jìn)入開發(fā)人員門戶，此時是管理員默認(rèn)登錄對門戶的編輯模式，需要切換瀏覽器，才能以新的用戶session訪問開發(fā)人員門戶：

點(diǎn)擊右上角注冊：

默認(rèn)注冊使用郵箱和密碼方式：

在郵箱中查收驗證郵件并驗證郵箱：

登錄開發(fā)人員門戶：

登錄成功，看到如下頁面：

查看profile：

注意，此時新用戶并沒有任何subscription，稍后我們將在Azure Portal為用戶添加訂閱。

06

管理員從Azure門戶上為用戶創(chuàng)建訂閱

在Azure Poral中查看剛注冊成功的用戶：

用戶即開發(fā)人員，也就是要使用你api的人員；

從developer portal自主創(chuàng)建的用戶，默認(rèn)在“developer”組中。

為用戶創(chuàng)建分配訂閱：

在用戶頁面點(diǎn)擊訂閱，添加訂閱：

新建訂閱可以產(chǎn)品級別或者API級別的訂閱，本例選擇產(chǎn)品級別的訂閱，并選擇剛才發(fā)布的產(chǎn)品。

在下拉列表中選擇剛才發(fā)布的產(chǎn)品，然后創(chuàng)建訂閱。

用戶可以在開發(fā)人員門戶中查看管理員為你分配的訂閱：

在developer portal中查看分配的訂閱：

07

用戶在開發(fā)人員門戶學(xué)習(xí)如何調(diào)用API并做測試

在開發(fā)人員portal中進(jìn)行api測試：

subscription key在創(chuàng)建時是有作用范圍的，本例中，我們將subscription key的權(quán)限綁定到“newproduct”上，因此，該key在其他product或者其為包含在“newproduct”里的api，都是無效的：

如下圖，我們用subscription key對echo api進(jìn)行訪問，結(jié)果為401：

08

用戶在自己的業(yè)務(wù)系統(tǒng)中調(diào)用API

針對多語言的示例代碼，將代碼集成到自己的業(yè)務(wù)系統(tǒng)中，完成API調(diào)用開發(fā)。

微軟最有價值專家是微軟公司授予第三方技術(shù)專業(yè)人士的一個全球獎項。27年來，世界各地的技術(shù)社區(qū)領(lǐng)導(dǎo)者，因其在線上和線下的技術(shù)社區(qū)中分享專業(yè)知識和經(jīng)驗而獲得此獎項。

MVP是經(jīng)過嚴(yán)格挑選的專家團(tuán)隊，他們代表著技術(shù)最精湛且最具智慧的人，是對社區(qū)投入極大的熱情并樂于助人的專家。MVP致力于通過演講、論壇問答、創(chuàng)建網(wǎng)站、撰寫博客、分享視頻、開源項目、組織會議等方式來幫助他人，并最大程度地幫助微軟技術(shù)社區(qū)用戶使用Microsoft技術(shù)。

更多詳情請登錄官方網(wǎng)站：

https://mvp.microsoft.com/zhcn

特別聲明：以上文章內(nèi)容僅代表作者本人觀點(diǎn)，不代表ESG跨境電商觀點(diǎn)或立場。如有關(guān)于作品內(nèi)容、版權(quán)或其它問題請于作品發(fā)表后的30日內(nèi)與ESG跨境電商聯(lián)系。