MuleSoft Flex Gateway で Heroku Private Space 中の API を管理してみる

# はじめに
企業データを扱うような API は多くの場合、下図のように閉域網で稼働し、外部から直接アクセスができません。きちんとアクセス許可された API Consumer アプリのみが正しいルートでアクセスできるよう API Gateway で制御されます。
![スクリーンショット 2024-10-22 18.34.09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/ba318d28-486e-968f-db66-24e63aa89ab3.png)


そこで本記事では、このように API Gateway を通じて Private API を管理するってどのようなものか、下記のような構成で先日試してみましたので、この作業手順を記録いたします。
ここでは下図のように MuleSoft Flex Gateway を API Gateway に、Heroku Private Space を閉域網の例として利用しました。
今回は DB へ繋ぐことが目的ではなく、Private API の管理となるため、対象の API は単独で動けるようシンプルにメモリに展開されたデータと入出力させます。
![スクリーンショット 2024-10-27 21.48.20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/92a5c9e2-65ce-5e6a-bcae-b03e0636e874.png)


## MuleSoft Flex Gateway とは
MuleSoft は API Gateway、API、EDA 等の開発・管理機能を具備した Anypoint Platform という製品を提供するベンダです。（本稿執筆時点では Salesforce の１ブランドとして活動）
今回 API Gateway として利用する Flex Gateway はこの Anypoint Platform に搭載されたコンテナや Ingress Controller 等で稼働する軽量の API Gateway です。
Flex Gateway の管理下に置くことで上図のように GUI ベースのコンソールを使って管理・監視できるようになります。
また、利用者観点では、Human Friendly な Portal 上で API 情報の参照やアクセスキー管理できるようになります。

## 手順
今回のざっくりとした作業手順は下記となります。

1. 顧客 API の挙動を確認
2. 顧客 API を Heroku へデプロイ
3. Flex Gateway の構成を Anypoint Platform に作成
4. Flex Gateway を Heroku 上に deploy
5. 顧客 API をカタログ登録
6. 顧客 API を Flex GW の管理下へ配備
7. 挙動の確認

## 事前準備
本記事では Heroku Private Space を使って閉域網を構築しますが、これは Enterprise 版に含まれる有償機能となります。Private Space を構築せずとも閉域網に配備したと見立てて別環境で記事中の作業を流していただきコンセプトをご確認いただくのもアリかとは思います。

いったん、下記に本記事で紹介する手順に際した事前準備作業をリストします。

- [MuleSoft Anypoint Platform](https://anypoint.mulesoft.com/login/) アカウントのセットアップ(Trial Account も可) - こちらの[Qiita 記事](https://qiita.com/hairyhg99/items/e8b1a4d22c568c5ec27e)も参考にしてください。
- [Heroku](https://signup.heroku.com/) アカウントのセットアップ
- [Heroku Private Space](https://devcenter.heroku.com/articles/private-spaces) の構成
- [Docker](https://docs.docker.com/get-started/get-docker/) を自端末へ install
- [Python](https://www.python.org/downloads/) を自端末へ install
- [GitHub Account](https://github.com/signup) のセットアップ

# 顧客 API の挙動を確認
今回は下図のように顧客レコードへの CRUD を処理する５つのメソッドを持ったサンプル API を Private API として利用します。本来であれば RDB や CRM などで管理された顧客データの入出力処理を実装すべきではありますが、高機能な API を実装することが目的ではないので簡便化のためデータソースのセットアップは行わずメモリに展開されたサンプルデータを利用します。
サンプル API は Python + FastAPI で実装されています。

![スクリーンショット 2024-10-23 14.32.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/84d930e2-81e3-cd24-446d-b8d569389af3.png)

### サンプル API を自端末へダウンロード
サンプル API が公開された GitHub レポジトリへアクセスします。
https://github.com/Yoshihiro-Mitsutomi-MuleSoft/ym-simple-fastapi-sample/tree/main

Code ボタンを押下し、ドロップダウンを表示させます。
Download ZIP ボタンを押下してソースをダウンロードします。

![スクリーンショット 2024-10-23 14.37.05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/19ea8715-b7ea-d260-8b21-47dd7b5de79e.png)

### サンプル API の実行
ダウンロードした Zip ファイルを解凍します。
解凍されたフォルダへ Terminal もしくは Command Prompt にて cd します。

下記コマンドを実行して API を起動します。
```
python main.py
```

正常に起動された場合のイメージ：
![スクリーンショット 2024-10-23 14.45.18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/4adbed18-7606-bac8-95bb-b63ef8b8d155.png)



上図のように起動されましたら、
http://localhost:8080/api/v1/docs
へ移動し、内包された client console を開きます。

イメージ：
![スクリーンショット 2024-10-23 14.47.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/822f4a57-f29c-414a-d312-aec18b3ef0a6.png)


幾つかメソッドを実行し、挙動を確認します。

GET /customers の実行イメージ：
![スクリーンショット 2024-10-23 14.50.34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/a12a81fc-6e94-a8bd-0c77-2e046d4cf105.png)

挙動が確認できましたら Terminal / Command Prompt へ戻り、Ctrl + C でアプリを停止します。



# 顧客 API を Heroku へデプロイ
ステップで挙動を確認した API をご自身の GitHub レポジトリへコピーした上で、GitHub 経由で API を Heroku へデプロイします。

:::note info
補足:
Heroku や GitHub の操作は幾つかやり方ががあります。本記事で手順化しているのはあくまでもほんの一例となります。既に Heroku や GitHub に慣れており、例えば Heroku CLI を使うなど他の方式で普段作業されている方は、ご自身のやりやすい方式で代替いただいても問題ありません。
:::

### ご自身の GitHub Repository へ API のリソースを push
まずは本 API を格納する GitHub Repository を用意します。

https://github.com/ へ移動し、ログインします。
New ボタンを押下します。
![スクリーンショット 2024-10-23 15.09.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/2542b7a6-edbe-9048-7631-1503e103314b.png)

任意の名前を指定し、Private の GitHub Repository を作成します。

作成後のイメージ：
![スクリーンショット 2024-10-23 15.40.54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/e31e20fc-1ef1-355b-63d0-aa5bf71749eb.png)


作成したレポジトリへ API リソースを格納します。
任意の新規ディレクトリを作成し、そこへ前章で解凍した zip ファイルの中のファイル群をコピーします。
Terminal / Command Prompt で上記ディレクトリへ cd します。

下記コマンドを実行し、リポジトリへリソースを push します。

```
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin <ご自身の repository URL>
git push -u origin main
```

Web Console にて正しく push されていることを確認します。

### GitHub レポジトリリソースを Heroku へデプロイ
Heroku へログインします。
https://id.heroku.com/login

New ボタンをクリックし、ドロップダウンから Create new app を選択します。

App name 欄は任意の名前を、Choose a region or a Private Space では Private Space を選択します。
ここでは Make this app internal to this Private Space のチェックボックスを有効化し、外部からのアクセスを遮断します。
続いて Create app ボタンを押下します。
![スクリーンショット_2024-10-23_16_04_47.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/ca41f991-7e84-2de3-5047-4c39600c3b6c.png)


Deploy タブにおける Deployment method 欄にて GitHub を選択します。
Connect to GitHub 欄に上で作成した GitHub Repository を指定し、Connect します。
![スクリーンショット 2024-10-23 16.12.24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/fe90829e-6c19-062f-161c-0288c7012333.png)


Manual deploy 欄にて Deploy Branch ボタンを押下して Deploy 処理をキックします。
![スクリーンショット 2024-10-23 16.12.49.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/7d14587d-a5a3-c7bd-8bce-dd73a8cd56fd.png)


Your app was successfully deployed のメッセージが出力された正常にデプロイできたことを確認します。
![スクリーンショット 2024-10-23 16.14.44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/88005b69-2a41-f37b-f9e1-957fea9cad5f.png)

画面上部の Open app(internal) ボタンを押下し、指定されたアドレスへアクセスできないことを確認します。Host 名に ```/api/v1/customers``` を付加して GET /customers へアクセスしようにも同様であることを確認します。
![スクリーンショット 2024-10-23 16.17.54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/f71dc420-7f70-c06e-35d9-ab4a205d3340.png)


本 API は外部からのアクセスが許可されていないため、Private Space の外からはテスト結果のようにアクセスできません。
同じ Private Space 内からであれば private 通信できます。
そこで、次章以降で Flex Gateway を同 Private Space へ配備し、外からアクセスする gateway を構築します。



# Flex Gateway の構成を Anypoint Platform に作成
### Flex Gateway の構成情報を Anypoint Platform 上に作成
Anypoint Platform のコンソールにログインします。
https://anypoint.mulesoft.com/

画面左上のハンバーガーメニューをクリックします。
![スクリーンショット 2024-10-23 17.09.44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/e3deffeb-8d09-c887-6cf4-01b412cd9649.png)


Runtime Manager を選択します。
![スクリーンショット 2024-10-23 17.09.19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/fed74c33-b2f0-7cec-da17-c3f6ecfa1dec.png)

左ペインにて Flex Gateways をクリックします。
![スクリーンショット 2024-10-23 17.12.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/993baffa-4358-584c-d2d5-d330413bb56b.png)


Add Gateway ボタンをクリックします。
![スクリーンショット 2024-10-23 17.14.00.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/6a00f26d-dfc8-b7fb-618d-2c83145128d3.png)


Container > Docker を選択します。


### Anypoint Platform と　通信するための構成ファイルを生成

![スクリーンショット_2024-10-23_17_16_10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/459a71cc-56d2-37ee-4204-6dc10deb922a.png)

上図の手順に従い、Flex Gateway のコンテナイメージをダウンロードします。
任意のディレクトリ上で下記コマンドを実行します。

```
docker pull mulesoft/flex-gateway
```

続いて Anypoint Platform 上で表示される手順② Register your gateway に書かれたコマンドを実行します。
```gateway-name``` の部分は任意の名前に変更してください。

```
docker run --entrypoint flexctl -u $UID \
  -v "$(pwd)":/registration mulesoft/flex-gateway \
  registration create --organization=<ご自身の ID> \
  --token=<ご自身の Token> \
  --output-directory=/registration \
  --connected=true \
  <gateway-name>
```

実行したディレクトリ上に registration.yaml が生成されたことを確認します。
![スクリーンショット 2024-10-23 17.34.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/65f6f4b7-76b7-f484-6538-ccd47baa6389.png)


:::note info
補足：
registration.yaml は Flex Gateway と Anypoint Platform の間の通信確立処理を Flex Gateway 側からキックさせるために必要な構成ファイルとなります。本ファイルを Flex Gateway に渡すことで、Flex Gateway が Anypoint Platform への接続要求を開始します。確立後はモニタリング情報や API の制御情報等がやりとりされ、Anypoint Platform の GUI コンソールにて API Gateway の管理や監視が行えるようになります。
:::

# Flex Gateway を Heroku 上に deploy
### Heroku の Private Space 上に Flex Gateway をデプロイ

heroku-reference-apps 中の Flex Gateway イメージレポジトリへアクセスします。
https://github.com/heroku-reference-apps/heroku-docker-flex-gateway

Deploy to Heroku ボタンを押下します。
![スクリーンショット 2024-10-23 17.39.13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/79bf04cf-88d0-ac7f-1377-da52f9699067.png)

App name 欄は任意の名前を、Choose a region or a Private Space では Private Space を選択します。
また、ここでは Make this app internal to this Private Space のチェックボックスは入れずに下へスクロールします。
![スクリーンショット_2024-10-23_17_41_40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/29bb28b7-d9ed-9a25-e80e-0afc06945fc1.png)

前章で生成した registration.yaml をテキストエディタで開きコンテンツをコピーします。
コピーした内容を FLEX_CONFIG 欄にペーストします。

イメージ：
![スクリーンショット_2024-10-23_17_46_13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/53f5b566-780c-5c29-6dcf-f17597f6c96b.png)


他の設定項目はデフォルトのまま、Deploy app ボタンを押下します。

Your app was successfully deployed のメッセージが出力されることを確認します。![スクリーンショット 2024-10-23 17.50.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/a201f233-e5fe-e9be-4bb2-9fef9083efa0.png)

### Heroku 上に Deploy した Flex Gateway が Anypoint Platform と正しく通信していることを確認
Anypoint Platform のコンソールに戻ります。
Anypoint Platform のコンソールにて ← Flex Gateways をクリックします。
![スクリーンショット 2024-10-23 17.52.44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/eb30b7d2-c132-943f-f0c5-d815caeec3e1.png)


Deploy した Flex Gateway のステータスが Connected になっていることを確認します。
![スクリーンショット_2024-10-23_17_54_12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/39c03648-c65c-8813-ed27-c99ceb2b3ac2.png)



# 顧客 API をカタログ登録
Flex Gateway で処理するアクセス管理は Anypoint Platform が提供する Developer Portal 機能 Anypoint Exchange と連動が可能です。
連動させることで Developer Portal 上で公開される該当の API のページ上でアクセス申請等を行えるようになります。
本章では、Developer Portal へ Heroku に deploy した API の情報を登録します。
FastAPI は実装された API から OpenAPI Spec 形式の API 仕様を自動生成します。
この API 仕様を使ってカタログ化を行います。

ローカルにダウンロードした顧客 API のディレクトリへ移動します。

```
python main.py
```

を実行して API を起動します。

http://localhost:8080/api/v1/docs
へ移動します。

Console 左上に /api/v1/openapi.json へのリンクが生成されていますので、これを右クリックからローカルダウンロードします。

イメージ（Google Chrome を使った場合の例）：
![スクリーンショット 2024-10-24 15.04.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/874ae688-04e5-c143-eb2a-84bf61fcb16e.png)

Terminal / Command Prompt へ戻り、Ctrl + C でアプリを停止します。


Anypoint Platform の管理コンソールに戻ります。
左上のハンバーガーメニューから Exchange を選択します。
![スクリーンショット 2024-10-24 15.17.26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/6d34e85b-7e69-8966-95eb-43a85db7f94d.png)


Publish new asset ボタンを押下します。
![スクリーンショット 2024-10-24 15.22.14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/b3a59e87-adf7-d235-1216-56b141626fa7.png)


下記のような設定をした上で Publish ボタンを押下します。

| 設定欄 | 設定値 |
|:-:|:-:|
|  Name |  任意の API 名を指定 |
| Asset types  | REST API  |
|  Method | Upload an OAS  |
|  File upload | 先程ダウンロードした openapi.json  |
|  Lifecycle state |  stable |


イメージ：
![スクリーンショット 2024-10-24 15.27.21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/fd9ea913-8d65-0d38-87a1-2fe2948dbeab.png)

Publish 処理が進み、API 仕様をベースに Human Friendly な形式でドキュメント化されていることを確認します。

イメージ：
![スクリーンショット 2024-10-24 15.29.40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/134a632d-ec8f-67a6-c3f0-8952f0f2352c.png)


# 顧客 API を Flex GW の管理下へ配備
本章では Heroku へ配備した Flex Gateway に顧客 API へのルートを作成します。

Anypoint Platform の管理コンソールに戻ります。
ハンバーガーメニューから API Manager を選択します。
![スクリーンショット 2024-10-24 15.36.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/3c8a6e1d-f6cf-d84f-48fb-202aae2be399.png)


Add API ボタンを押下し、Add new API を選択します。
![スクリーンショット 2024-10-24 15.38.18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/73ffed06-1b7d-68ef-92db-a0a68acb0db4.png)


Select runtime 欄で Flex Gateway を選択します。
Select gateway では Heroku へ deploy した Flex Gateway を選択します。
Next ボタンを押下します。
![スクリーンショット 2024-10-24 16.35.53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/9652ee1f-b379-6798-a7f2-e63e0df3e416.png)

Select the API you want to manage 欄では Select API from Exchange を選択します。
前章でカタログ登録した API を選択します。
イメージ：
![スクリーンショット 2024-10-24 16.55.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/9ee6daa7-a34d-9312-d549-ed401c23df24.png)

他の選択肢は default 設定のまま Next ボタンを押下します。
![スクリーンショット 2024-10-24 16.57.25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/caf781c4-a98a-d421-7d9c-27a6f36951b5.png)


Protocol 及び Port 欄はデフォルトをキープします。
Base path 欄は ```/privatecust``` とします。
Instance label 欄は ```flex-sandbox``` とします。
Next ボタンを押下します。
![スクリーンショット 2024-10-24 17.03.01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/3bd38c7b-a48d-5a64-11e6-cbf170d63bd8.png)

Upstream URL 欄に Heroku へデプロイした API の URL を指定します。
ここではホスト URL + /api/v1 を指定します。
Next ボタンを押下します。
![スクリーンショット 2024-10-24 17.06.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/0e7510ca-2b94-a263-d43a-99f867aebd7c.png)

:::note info
補足:
ここで指定した URL は外部公開されていないため、先のテストではアクセスに失敗しました。しかし、今回は同じ Private Space 内にある Flex Gateway からのアクセスになるため、Private 通信が可能となりアクセスルートが確立されます。
:::

構成内容を確認の上、Save & Deploy ボタンを押下します。
![スクリーンショット 2024-10-24 17.12.11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/d26901d1-bfdf-29ca-13ef-329930e0f558.png)


API Status 欄が Active になっていることを確認します。
![スクリーンショット 2024-10-24 17.16.22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/c22a420d-4484-98cb-ca1a-8a4f543f003f.png)



# 挙動の確認
前章では、外部アクセスが許可されていない API へのルートを Flex Gateway に構成しました。
本章では、下記の要領で Flex Gateway の挙動を確認します。

1. Private API(顧客 API) へのルートが正しく構築されていることの確認
2. API Policy を適用しアクセス管理ができることの確認

### Private API(顧客 API) へのルートが正しく構築されていることの確認
Heroku の管理コンソールへ移動し、Flex Gateway のページを開きます。
Open app ボタンを押下します。
![スクリーンショット 2024-10-24 17.21.21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/e9f23874-b4e0-27bc-928f-c3a929ab4a80.png)


Flex Gateway の URL がブラウザの新しい tab で開かれます。
```/privatecust/customers```
 を URL に append します。
Private API へ Flex Gateway 経由で正しくアクセスできることを確認します。

イメージ：
![スクリーンショット 2024-10-24 17.43.21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/02304b3f-72d6-25ad-6216-2e34be0b132e.png)




### API Policy を適用しアクセス管理ができることの確認
ここまで、API のルーティングが正しく機能することを確認してきました。
ただ、現時点では特にアクセスポリシーが加えられていないため、誰でもアクセス可能な状態になっています。
そこで、下図のようにアクセス認証が通った API Consumer のみがアクセス許可されるようポリシーを加えます。
また、バックエンドやリソースの過剰使用を保護するべく API Consumer のタイプ別に流量制限を設けてみます。
![スクリーンショット 2024-10-29 14.05.51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/21e45ee5-c683-e5f6-404a-4d264823391e.png)



Anypoint Platform の管理コンソールに戻ります。
API Manager を開きます。
前章で登録した API を開きます。
SLA Tiers をクリックします。
![スクリーンショット 2024-10-24 17.47.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/d7088bfa-2d3b-6ec0-d3b9-b68f96d2f926.png)

Add SLA Tier ボタンを押下します。
![スクリーンショット 2024-10-24 17.50.47.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/50ebeb0d-08e2-d0c3-f1b1-b1f527acecc0.png)

下記の要領で SLA Tier を設定し、Add ボタンを押下します。

| 設定欄 | 設定値 |
|:-:|:-:|
|  Name | trial  |
|  Approval |  Automatic |
|  # of Reqs | 1  |
|  Time Period |  1 |
|  Time Unit | Minute  |
![スクリーンショット 2024-10-24 17.52.10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/9d230954-1c59-cc04-755a-24fdc930a3a5.png)


再度 Add SLA Tier ボタンを押下します。
下記の要領で SLA Tier を加えます。
| 設定欄 | 設定値 |
|:-:|:-:|
|  Name | enterprise  |
|  Approval |  Manual |
|  # of Reqs | 1  |
|  Time Period |  1 |
|  Time Unit | Millisecond  |
![スクリーンショット 2024-10-24 17.56.55.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/66bd0fd9-bb0a-69e0-e2f2-7c3fb5259ae9.png)

構成後のイメージ：
![スクリーンショット 2024-10-24 17.58.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/7f85c6f5-3c20-f375-688f-0a8d44e5a0ef.png)


1 分に 1 回のアクセスが許可された trial tier、並びに 1 ミリ秒に１回のアクセスが許可された enterprise tier を準備いたしました。

Policies をクリックします。
![スクリーンショット 2024-10-24 17.59.10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/ba48cbee-ac0c-7bf4-c47f-eda08cce0dbf.png)


Add policy をクリックします。
![スクリーンショット 2024-10-24 18.00.27.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/73e40a4f-9c2d-729b-90c5-10d822d06a96.png)


Rate Limiting - SLA Based を選択し、Next ボタンを押下します。
![スクリーンショット 2024-10-24 18.02.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/8d6c3272-ec47-3064-dd19-ae9b0dd31aef.png)


デフォルト設定のまま Apply ボタンを押下します。
![スクリーンショット 2024-10-24 18.04.06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/eb7160d2-3d52-0fd8-da37-3f1e6bf117b7.png)


The policy was created successfully のポップアップが表示されることを確認します。
![スクリーンショット 2024-10-24 18.04.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/a1981787-ac1b-1428-2861-d7d1a66da8c7.png)


しばらく時間を置いて、先程アクセスできた Flex Gateway 経由の Private API への URL にアクセスしてみます。
認証ができず、アクセスに失敗することを確認します。

イメージ：
![スクリーンショット 2024-10-24 18.06.54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/cb666f77-7fb6-d004-0940-2da78e57423e.png)


Anypoint Platform のコンソール画面に戻ります。
Exchange をハンバーガーメニューから選択します。
先にカタログ登録した API のページを開きます。
API Gateway とドッキングしたため、Request Access ボタンが追加されたことが確認できます。

イメージ：
![スクリーンショット 2024-10-24 18.08.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/0c1591ec-f458-f352-0e46-c8eb54f883bf.png)


この Request Access ボタンを押下します。

API Instance 欄では API Manager に構成した flex-sandbox を選択します。
Application 欄にて Create a new application をクリックします。
![スクリーンショット 2024-10-24 18.10.57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/04c6a471-428b-c0cb-f2b4-2683408d580d.png)


Application Name 欄に任意の Application 名（API Consumer アプリ名）を指定して、Create ボタンを押下します。
![スクリーンショット 2024-10-24 18.14.48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/9f9d8fc1-cbbd-0cb1-f473-bf8fe0363464.png)


SLA tier 欄にて trial を選択の上、Request access ボタンを押下します。
![スクリーンショット 2024-10-24 18.16.06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/f814851a-4ce7-ff48-298a-36aefd9610a7.png)


アクセスが承認されたことが確認できます。
この画面に出力される Client ID と Client Secret を控えておきます。
![スクリーンショット_2024-10-24_18_20_43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/0e27552a-5c50-3ee0-8fee-f4d850f759e2.png)

:::note info
補足: trial tier は Approval Process を Automatic としました。そのため、API Provider が許可せずとも self service 形式でリクエストがハンドルされます。一方、Approval Process を manual とした enterprise tier を選択した場合は、API Provider が API Manager にて許可しない限りアクセスは許可されません。
:::

認証情報は HTTP Header に指定する必要があるため、curl コマンド、もしくは Postman などの API Client を利用してテストします。
HTTP Header に下記を加えて、再度 API Call を行います。
- client_id – 上で控えた Cliend ID
- client_secret — 上で控えた Client Secret


Postman で API Call した場合のイメージ：
![スクリーンショット_2024-10-24_18_28_44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/1f5ba1cb-3e0f-0d70-8b2b-3cb737413e31.png)


curl で実行する場合：
```
curl --location '<ご自身の URL>' \
--header 'client_id: <ご自身の Client ID>' \
--header 'client_secret: <ご自身の Client Secret>'
```

１分以内に再度アクセス試行しますと、下図のように HTTP Staus 429 Too Many Requests で弾かれます。
Trial tier のため、１分に１回のみのアクセスが許容されており、そのポリシーが正しく機能していることが確認できました。
![スクリーンショット_2024-10-24_18_29_19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180295/d27c96ef-0e69-df04-c2ba-8e9364e08cbe.png)



# さいごに
本記事では外部からのアクセスが遮断された Private API への Gateway を構築するようすを確認いたしました。また、この Gateway にアクセス管理関連のポリシーを適用し、意図された API Consumer から意図された流量で利用される仕組みを実装できることも確認しました。
これって別に MuleSoft Flex Gateway に限らず他製品でもできることだとは思いますが、稼働環境問わず稼働する軽量且つ高度な API Gateway を直感的な操作で構築できるのはポイントだと感じました。