Azure API Management（2）建立 Product/User/Subscription/体验Developer Portal

本文介绍以下内容：

1. 管理员（也就是API的提供者）从Azure Portal 导入后端API

2. 管理员在Azure Portal 对导入的API进行设置，好比增长流控等功能

3. 管理员在Azure Portal建立一个包含一组或多组API的产品并发布

4. 管理员在Azure Portal发布开发人员门户（一般该步骤仅执行一次）

5. 用户从开发人员门户自主注册或者从管理员从Azure Portal上注册用户

6. 管理员从Azure门户上为用户建立订阅

7. 用户在开发人员门户学习如何调用API并作测试

8. 用户在本身的业务系统中调用API

 

 

视频介绍：

https://www.51azure.cloud/post/2020/8/7/azure-api-management-2-create-product-user-subscription-and-try-developer-portal

 

 

 

---

图文介绍：

 

几个重要的概念：

 

1. API

导入或者在Azure Portal上建立的 一组API或者多组API，例如导入了一组订单相关API和一组库存相关API；

 

2.产品

产品包含至少一组API，一般产品把多组API打包在一块儿，造成一个包含多种功能的一个集合，例如：定义了一个产品“进销存”，该产品包含一组 订单相关的API和一组库存相关的API；

 

3.用户

这里的用户一般指使用API Management 的人员，其中包含要调用你发布的API的开发人员。

 

4.组

组指的用户组，一个组能够包含多个成员，也就是包含多个“用户”，系统内置了“Administrator”，“Developer”，“Guests”三个组。

5.订阅

订阅决定了哪一个”用户“能够调用哪一个“API”或者哪一个“产品”。

订阅是绑定到“用户”上的，订阅能控制某个API或某个产品。

6.开发人员门户（developer portal）

一般状况下，开发人员门户是提供给“用户”，也就是要调用你API的人员使用的一个门户网站。

用户能够在这个网站维护本身的帐号信息，查看本身的订阅信息，查看API文档/在线测试API。

默认状况下，他的url后半部分为：developer.azure-api.net;

能够在开发人员门户上提交注册信息，根据配置，可能须要审核或自动完成审核，而后便成了“用户”，用户能够根据API及产品是否须要订阅或者订阅权限调用对应的API。

在开发人员门户上自主注册的用户，默认自动分配到“Developer”组中。

 

 

---

 

一般总体的使用流程是：

 

1. 管理员（也就是API的提供者）从Azure Portal 导入后端API

2. 管理员在Azure Portal 对导入的API进行设置，好比增长流控等功能

3. 管理员在Azure Portal建立一个包含一组或多组API的产品并发布

4. 管理员在Azure Portal发布开发人员门户（一般该步骤仅执行一次）

5. 用户从开发人员门户自主注册或者从管理员从Azure Portal上注册用户

6. 管理员从Azure门户上为用户建立订阅

7. 用户在开发人员门户学习如何调用API并作测试

8. 用户在本身的业务系统中调用API

 

---

 

1.管理员（也就是API的提供者）从Azure Portal 导入后端API

上一讲分享的内容中，咱们已经完成了API的导入，本文再也不赘述，若是您还没有完成API导入，请参照《Azure API Management（1）Create APIM And Add First API,建立Azure APIM并添加后端API》

 

---

 

2.管理员在Azure Portal 对导入的API进行设置，好比增长流控等功能

流控等功能咱们在之后的章节中介绍，本文能够跳过这个步骤。

 

---

 

3.管理员在Azure Portal建立一个包含一组或多组API的产品并发布

注意：

3处的状态为“未发布”，未发布的产品不会在开发者门户中看到。稍后须要执行”发布产品“操做后，才会出如今开发者门户中；

3处的“须要订阅”若是不勾选，则用户在开发者门户中无需订阅便可进行该产品关联api的调用；

5处的API能够选择多个或者一个；

 

产品建立完成后，默认的访问控制组在“Administrator”中，若是须要被“开发者么户”中建立的用户访问，则须要添加“developers”组，由于从门户自主注册的用户，默认为“developers”组：

 

发布产品，只有发布后的产品，才会显示在开发人员门户中：

 

 

---

 

4.管理员在Azure Portal发布开发人员门户（一般该步骤仅执行一次）

注意：若是不开启cors，则用户在开发人员门户上没法测试api调用。

 

---

 

5.用户从开发人员门户自主注册或者从管理员从Azure Portal上注册用户

点击开发人员门户能够进入开发人员门户，此时是管理员默认登陆对门户的编辑模式，须要切换浏览器，才能以新的用户session访问开发人员门户：

 

点击右上角注册：

默认注册使用邮箱和密码方式：

在邮箱中查收验证邮件并验证邮箱：

 

登陆开发人员门户：

登陆成功，看到以下页面：

 

查看profile：

注意，此时新用户并无任何subscription，稍后咱们将在Azure Portal 为用户添加订阅。

 

---

 

6.管理员从Azure门户上为用户建立订阅

在Azure Poral中查看刚注册成功的用户：

用户即开发人员，也就是要使用你api的人员；

从developer portal自主建立的用户，默认在 “developer”组中。

 

 

为用户建立分配订阅：

在用户页面点击订阅，添加订阅：

 

 

新建订阅能够产品级别或者API级别的订阅，本例选择产品级别的订阅，并选择刚才发布的产品。

 

在下拉列表中选择刚才发布的产品，而后建立订阅。

用户能够在开发人员门户中查看管理员为你分配的订阅：

在developer portal 中查看分配的订阅：

 

---

 

 

7.用户在开发人员门户学习如何调用API并作测试

在开发人员portal中进行api测试：

 

subscription key 在建立时是有做用范围的，本例中，咱们将subscription key 的权限绑定到 “new-product”上，所以，该key在其余product或者其为包含在“new-product”里的api，都是无效的：

以下图，咱们用subscription key对 echo api进行访问，结果为 401：

 

 

---

 

8. 用户在本身的业务系统中调用API

针对多语言的示例代码，将代码集成到本身的业务系统中，完成API调用开发。

 

---

声明：

 

点击可查阅本站文章目录 《文章分类目录》

本站全部内容仅表明我的观点，如与官文档冲突，请以官方文档为准。

可在本页面下方留言或经过下方联系方式联系我：

微信：wxyusz；邮箱：shuzhen.yu@foxmail.com

欢迎关注公众号“云计算实战”，接收最新文章推送。