Azure API Management （2）體驗(yàn)開(kāi)發(fā)者門(mén)戶(hù),微軟azure云虛擬服務(wù)器-ESG跨境

Azure API Management （2）體驗(yàn)開(kāi)發(fā)者門(mén)戶(hù),微軟azure云虛擬服務(wù)器

Azure API Management （2）體驗(yàn)開(kāi)發(fā)者門(mén)戶(hù)

于書(shū)振

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

幾個(gè)重要的概念

1.API

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

2.產(chǎn)品

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

3.用戶(hù)

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

4.組

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

5.訂閱

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

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

6.開(kāi)發(fā)人員門(mén)戶(hù)（developer portal）

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

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

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

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

在開(kāi)發(fā)人員門(mén)戶(hù)上自主注冊(cè)的用戶(hù)，默認(rèn)自動(dòng)分配到“Developer”組中。

通常整體的使用流程是：

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

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

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

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

用戶(hù)從開(kāi)發(fā)人員門(mén)戶(hù)自主注冊(cè)或者從管理員從Azure Portal上注冊(cè)用戶(hù)

管理員從Azure門(mén)戶(hù)上為用戶(hù)創(chuàng)建訂閱

用戶(hù)在開(kāi)發(fā)人員門(mén)戶(hù)學(xué)習(xí)如何調(diào)用API并做測(cè)試

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

01

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

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

02

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

流控等功能我們?cè)谝院蟮恼鹿?jié)中介紹，本文可以跳過(guò)這個(gè)步驟。

03

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

注意：

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

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

5處的API可以選擇多個(gè)或者一個(gè)；

產(chǎn)品創(chuàng)建完成后，默認(rèn)的訪(fǎng)問(wèn)控制組在“Administrator”中，如果需要被“開(kāi)發(fā)者么戶(hù)”中創(chuàng)建的用戶(hù)訪(fǎng)問(wèn)，則需要添加“developers”組，因?yàn)閺拈T(mén)戶(hù)自主注冊(cè)的用戶(hù)，默認(rèn)為“developers”組：

發(fā)布產(chǎn)品，只有發(fā)布后的產(chǎn)品，才會(huì)顯示在開(kāi)發(fā)人員門(mén)戶(hù)中：

04

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

注意：如果不開(kāi)啟cors，則用戶(hù)在開(kāi)發(fā)人員門(mén)戶(hù)上無(wú)法測(cè)試api調(diào)用。

05

用戶(hù)從開(kāi)發(fā)人員門(mén)戶(hù)自主注冊(cè)或者從管理員從Azure Portal上注冊(cè)用戶(hù)

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

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

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

在郵箱中查收驗(yàn)證郵件并驗(yàn)證郵箱：

登錄開(kāi)發(fā)人員門(mén)戶(hù)：

登錄成功，看到如下頁(yè)面：

查看profile：

注意，此時(shí)新用戶(hù)并沒(méi)有任何subscription，稍后我們將在Azure Portal為用戶(hù)添加訂閱。

06

管理員從Azure門(mén)戶(hù)上為用戶(hù)創(chuàng)建訂閱

在Azure Poral中查看剛注冊(cè)成功的用戶(hù)：

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

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

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

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

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

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

用戶(hù)可以在開(kāi)發(fā)人員門(mén)戶(hù)中查看管理員為你分配的訂閱：

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

07

用戶(hù)在開(kāi)發(fā)人員門(mén)戶(hù)學(xué)習(xí)如何調(diào)用API并做測(cè)試

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

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

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

08

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

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

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

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

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

https://mvp.microsoft.com/zhcn

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