OpenShift Meetup Tokyo#1のLT資料

1. © Hitachi, Ltd. 2018. All rights reserved.
株式会社 日立製作所 中村 雄一
2018/10/16
OpenShift上で動くAPI管理「3scale」

2. © Hitachi, Ltd. 2018. All rights reserved.
3scaleとは？
1
ＡＰＩゲートウェイ
流量制御・
アクセス制御
開発ポータル
API情報開示
API管理
管理ポータル
分析・レポート
認可・認証
Red Hat社を中心に開発されているＯＳＳベースのＡＰＩ管理基盤
OpenShift上での動作が前提で作られてます。
9月にフルOSS化： https://github.com/3scale/
OpenShiftに
同梱
API
サーバ
ＡＰＩ連携
事業者・
アプリ開発者
特長
・ ゲートウェイだけでなく、API公開に必要な機能一式揃ってます
・ 簡単に設定可能！（XMLをいじる必要なし）
・ OpenID Connectに対応したKeycloak(Red Hat SSO)もOpenShiftについてます

3. © Hitachi, Ltd. 2018. All rights reserved. 2
3scale機能紹介： セキュリティ
Keycloakと連携した
- 認証、OpenID Connectに対応したアクセストークン発行・管理
- アクセストークンのrole属性に応じたアクセス制御
Keycloakは最新仕様のFinancial API (FAPI)にも対応中
⇒パッチ投稿中： https://issues.jboss.org/browse/KEYCLOAK-6767
3scaleのリバプロ機能
APIサーバ
サードパーティー
アプリケーション
1) トークン付きAPIアクセス
Keycloakサーバ
2) トークン正当性・有効性
確認(Token Introspection)
3) トークンデコード
署名確認
4)属性を見て
アクセス可否判断
6) APIの結果
ＡＰＩゲートウェイ
5) APIアクセス

4. © Hitachi, Ltd. 2018. All rights reserved. 3
3scale機能紹介： 流量制御
ＡＰＩゲートウェイ
流量制御・
アクセス制御
APIサーバ
ＡＰＩ連携
事業者・
アプリ開発者
アプリから見たＡＰＩの利用回数制限・課金目的の制御
例：
アプリＡは foo.com/api_1を1000回/日呼べる
バックエンドのAPIサーバへの負荷抑制を目的とした制御
例：
・foo.com/api_1は、全アプリから100秒/回呼べる
・foo.com/api_1に対する同時コネクション数は100
アプリ視点の流量制御、バックエンド視点の流量制御に対応

5. © Hitachi, Ltd. 2018. All rights reserved.
3scale機能紹介： 開発者ポータル
4
3scaleを採用している
https://developer.oxforddictionaries.com/より引用
3scaleにインポートし
APIの仕様を
開発者ポータルサイトに公開
ＡＰＩの仕様
(Swagger形式）

6. © Hitachi, Ltd. 2018. All rights reserved.
3scale機能紹介： 分析とレポート
5
Red Hat社ホームページ
https://www.3scale.net/api-management/report-analyze/
より引用
API管理者は、管理ポータルにてAPIの利用状況を確認できます。

7. © Hitachi, Ltd. 2018. All rights reserved.
コミュニティ貢献など
6
• 3scaleのAPIゲートウェイ「apicast」を拡張すると機能強化できます。
https://github.com/3scale/apicast
• 皆に役立つ拡張については、コミュニティも受け入れてくれます。
• 開発した機能
• 流量制御（同時接続数、過負荷保護機能）
• アクセストークンチェック
• ゲートウェイでのロールベースのアクセス制御
など、投稿しマージされました
参考記事： OSSベースのAPI管理製品 3scale 2.2を試してみた
https://qiita.com/yo-tabata/items/eb81c5cb324cefa87efc
・ 使ってみるには… （現在v2.3)
・ コンテナカタログから選択で簡単にインストール
・ マニュアルでだいたい分かります。
https://access.redhat.com/documentation/en-us/red_hat_3scale/

8. © Hitachi, Ltd. 2018. All rights reserved.
他社所有商標に関する表示
7
• HITACHIは，株式会社日立製作所の商標または登録商標です。
• Red Hatは米国およびその他の国におけるRed Hat, Inc.の登録商標です。
• OpenShiftは米国およびその他の国におけるRed Hat, Inc.の登録商標です。
• その他記載の会社名、製品名などは、それぞれの会社の商標もしくは登録商標です。