入门到放弃node系列之express-gateway网关

前言

本文首发公众号 【一名打字员】

网上墙内关于这方面的文章真的很少，本猿也是通过官网一点一点学习，希望能够帮助到大家。express-gateway官网

安装

• 安装Express Gateway

npm install -g express-gateway

• 创建一个项目

eg gateway create

• 初始一些基本信息配置

eg gateway create
 ? What is the name of your Express Gateway? my-gateway
 ? Where would you like to install your Express Gateway? my-gateway
 ? What type of Express Gateway do you want to create? (Use arrow keys)
 ❯ Getting Started with Express Gateway
   Basic (default pipeline with proxy)

• 启动

cd my-gateway && npm start

这样基本的一个项目就已经成型了。

使用方法

指定服务并把API暴露出来（API提供者）

• 第一步

我们会发现，项目中已经把代理了一个现有的服务 https://httpbin.org/ip ,并对其进行管理。它提供了一个json的输出，我们可以展示一下快速网关的功能。访问 https://httpbin.org/ip ，会有以下输出：

{
  "origin": "218.80.1.67"  #自己的IP
}

• 第二步

该服务被指定为快速网关中默认管道的服务端，网关有自己的代理策略，之前的 https://httpbin.org/ip 则是网关设置的一个服务请求。配置在config目录下的 gateway.config.yml 文件。

http:
  port: 8080
admin:
  port: 9876
  hostname: localhost
apiEndpoints:
  api:
    host: localhost
    paths: '/ip'
serviceEndpoints:
  httpbin:
    url: 'https://httpbin.org'
policies:
  - basic-auth
  - cors
  - expression
  - key-auth
  - log
  - oauth2
  - proxy
  - rate-limit
pipelines:
  default:
    apiEndpoints:
      - api
    policies:
    # Uncomment `key-auth:` when instructed to in the Getting Started guide.
    # - key-auth:
      - proxy:
          - action:
              serviceEndpoint: httpbin 
              changeOrigin: true

可以看到这里配置了一个默认的服务端点，网关会在默认代理策略中找到 httmbin 。

• 第三步

接下来我们需要让 httpbin 服务作为一个API端点穿过网关，并当这个API公开时，可以被外部所访问。
在上面的 gateway.config.yml 配置文件中，我们找到 apiEndpoints 这个设置，其中有一个 api 的设置项。

apiEndpoints:
  api:
    host: localhost
    paths: '/ip'

PS:默认情况下，API请求路径将被代理策略挂在服务端点中。

• 第四步

现在我们就可以通过网关来访问API了，访问 http://localhost:8080/ip 。

创建API消费者

方便管理API，我们将允许使用API的授权用户称为“消费者”。如用户的创建，进入项目根目录，创建：

eg users create
 Enter username [required]: mrpan
 Enter firstname [required]: coder
 Enter lastname [required]: coder
 Enter email: [e-mail]
 Enter redirectUri: www.baidu.com
√ Created 892775c8-80c5-480e-b596-6cb3133691f2

 "firstname": "coder",
 "lastname": "coder",
 "email": "[e-mail]",
 "redirectUri": "www.baidu.com",
 "isActive": true,
 "username": "mrpan",
 "id": "892775c8-80c5-480e-b596-6cb3133691f2",
 "createdAt": "Sat Dec 16 2017 13:21:13 GMT+0800 (中国标准时间)",
 "updatedAt": "Sat Dec 16 2017 13:21:13 GMT+0800 (中国标准时间)"

API权限认证

• 第一步

现在我们的API是公开的，没有进行权限的控制，所以任何人都可以对它进行访问。我们现在用密钥授权对它进行保护，首先必须要将这个授权策略加入在配置文件 gateway.config.yml 中。

pipelines:
  - name: getting-started
    apiEndpoints:
      - api
    policies:
      - key-auth:
      - proxy:
        - action:
          serviceEndpoint: httpbin
          changeOrigin: true

• 第二步

将密钥分给上面的用户 mrpan

eg credentials create -c mrpan -t key-auth -q
10b9Yaalb982DreBukZvGf:3A2bhd1xzqwAvNWX0QfjD5

PS：上面的-q选项是将输出限制为api的key，便于粘贴复制。

• 第三步

再次访问 http://localhost:8080/ip ，这个时候便不会打印结果了，只会打印出 Unauthorized 。

• 第四步

我们在访问的时候把key加上。这样，就能继续使用API了。

到这里，网关的基本使用也就差不多了，大家可以梳理一下在自己的系统中进行扩展。

结语

现在大多大型网站架构都采用了微服务的模式，把系统拆分成一个一个的微服务，服务层可能会使用java或者使用其它语言编写，毕竟有Netflix这样的先例，成功的使用Node.js API网关及其JAVA后端来支持广泛的客户端。