InterSystems API Manager（IAM）を使用することで、WebベースのAPIとの間のトラフィックを監視および制御できます。 サービス指向のアプリケーション層を構築している場合、使用しているAPIの数がすぐに増える可能性が非常に高くなります。 環境が分散しているほど、APIトラフィックを適切に管理および監視することが重要になります。 API Managerを使用すると、集中型ゲートウェイを介してすべてのトラフィックを簡単にルーティングし、APIリクエストを適切なターゲットノードに転送できます。 その他のリソース：
InterSystems API Manager (IAM) のバージョン 2.8.4.11 & 3.4.3.11 が公開されました。 これらは、長期的にサポートされている IAM の 2 つのバージョンの最新版です。これらのリリースには重要な修正が含まれており、すべてのお客様にアップグレードをお勧めします。
IAM 3.0または3.2をお使いのお客様は、これらのバージョンのサポートがまもなく終了するため、3.4.3.11にアップグレードすることをお勧めします。
IAM は、InterSystems IRIS サーバとアプリケーション間の API ゲートウェイであり、HTTP ベースのトラフィックを効果的に監視、制御、管理するためのツールを提供します。IAM は、InterSystems IRIS ライセンスの無償アドオンとして利用できます。
IAMは、WRCソフトウェア配布サイトのComponentsエリアからダウンロードできます。
InterSystems API Manager (IAM) のバージョン 2.8.4.10 と 3.4.3.10 が公開されました。 これらは、長期的にサポートされている IAM の 2 つのバージョンの最新版です。これらのリリースには重要な修正が含まれており、すべてのお客様にアップグレードをお勧めします。
IAM 3.0または3.2をお使いのお客様は、これらのバージョンのサポートがまもなく終了するため、3.4.3.10にアップグレードすることをお勧めします。
IAM は、InterSystems IRIS サーバとアプリケーション間の API ゲートウェイであり、HTTP ベースのトラフィックを効果的に監視、制御、管理するためのツールを大規模に提供します。IAM は、InterSystems IRIS ライセンスの無償アドオンとして利用できます。
IAMは、WRCソフトウェア配布サイトのComponentsエリアからダウンロードできます。
IAM 3.4 リリース
この記事では、EC2（ubuntu）に IAM をデプロイする手順を説明します。
IAM は InterSystems API Manager です。
IAM の詳細については、以下のリンクをご覧ください。
https://docs.intersystems.com/components/csp/docbook/Doc.View.cls?KEY=PAGE_apimgr
.png)
.png)
.png)
.png)
https://community.intersystems.com/post/introducing-intersystems-api-manager
https://wrc.intersystems.com/wrc/coDistGen.csp
以下のバージョンを PC にダウンロードしました。
.png)
コマンド scp を使用して、イメージをクラウドにアップロードしています。
.png)
インストールされていない場合は、以下のリンクを参照してください。
https://docs.docker.com/engine/install/ubuntu/
tar zpxvf IAM-3.0.2.0-4.tar.gz
.png)
sudo docker load -i iam_image.tar
.png)
source ./iam-setup.sh
.png)
.png)
EC2 外部の環境から IAM UI にアクセスできるように、KONG_PORTAL_GUI_HOST と KONG_ADMIN_GUI_URL パラメーターの localhost を EC2 のパブリックアドレスに置き換えます。
vi docker-compose.yml
.png)
sudo docker compose up -d
.png)
以下のリンクから IAM の UI にアクセスできます。
http://yourEC2publicAddress:8002/overview
.png)
Docker コンテナと REST API の基本的な知識で、InterSystems API Manager による API とマイクロサービスの制御に挑戦したいと思い、 ホストにローカルの IRIS インスタンス（Windows OS）を使用し、Linux VM で IAM （ゲスト）を実行するこのオンラインコースを実行してみました。
まず InterSystems API Manger（IAM）を紹介してから、ローカル環境をセットアップするための手順を説明し、最後にコースの各章の内容を確認しましょう。
今日では、API トラフィックの管理、監視、および保護が UI ポータルに集約される 簡単なデプロイのメリットを生かして、API を管理することが非常に重要となっています。
InterSystems API Manger（IAM）は、IRIS アプリケーションが消費し公開する API とマイクロサービスを制御します。 下流と上流のシステムの間の API ゲートウェイであり、どの API がどれくらいの頻度で誰に呼び出されたのかを視覚的に追跡する方法も備わっています。
IAM を使用するメリット:
IAM のセットアップを開始する前にインストールしたもの
InterSystems IRIS インスタンスで IAM を使用できるようにします。
IRIS インスタンスの管理ポータルを開き、IAM を有効にします。
IAM Web アプリケーションを有効にします（IRIS ライセンスに「API Management」が指定されていることを確認してください）。
IAM インストールファイルをダウンロードして解凍します。
IAM のセットアップと起動
このステップでは、ROOT ユーザーを使用しました。Linux ユーザーで sudo を使用すると、「Cannot load the Manager Potal properly（Manager Portal を正しく読み込めません）」というエラーが発生するか、セットアップスクリプトが環境変数値を docker-compose.yaml ファイルに渡せなかったためです。 後者の場合、"sudo -E" を使って環境変数を渡すと回避できました。
VM を使ってホストアドレスを ping できない場合は、Windows ファイアウォールの詳細設定にある［受信の規則］を確認してください。 ［ファイルとプリンタの共有（エコー要求 - ICMPv4-In）プロファイル: プライベート、パブリック］を有効にします。
IAM のテスト
インストールキットの scripts ディレクトリ内に iam-test.sh というスクリプトがあります。
"./iam-test.sh" と入力して実行し、IAM と IRIS インスタンス間の接続のテストを開始します。
注意: テスト結果に「サービスを作成中にエラーが発生しました。 HTTP ステータスコード:000 またはサービス作成中のエラー。 HTTP ステータスコード:409」が表示された場合は、Docker のステータスを確認してください。健全であるにも関わらず、動作しない場合は、コンテナをシャットダウンし、もう一度 docker compose を実行してください。私の経験では、VM を一時停止すると、これが発生することがあります。
詳細については、こちらの IAM セットアップドキュメントをご覧ください: https://docs.intersystems.com/components/csp/docbook/DocBook.UI.Page.cls?KEY=CIAM3.0_install#CIAM3.0_install_setupIAM
ハンズオン演習: https://learning.intersystems.com/course/view.php?name=IAMExercise
この演習の後に 3 つの章を完了したので、その内容を共有したいと思います。
IAM を使用し始める前、この演習では GET メソッドを使って REST リクエストを行うことが求められていました。この HTTP リクエストはクライアントサーバーからのもので、IRIS インスタンスにビルドされた Web アプリケーションを直接エンドポイントとしてポイントしています。
次のステップでは、API リクエストが転送されるサービスと着信リクエストを分析して最適な API に割り当てるルートのセットアップ方法が説明されていました。
サービスとルーターのセットアップ
サービスとは？
サービスは、API Manager を InterSystems IRIS に接続するように構成されます。そのため通常は、InterSystems IRIS 内の REST サービスまたは Web アプリケーションごとに、サービスは 1 つです。 たとえば、ベースパスが /rest/coffeemakerapp の Web アプリケーションがある場合、この URL に対し、API Manager 内で 1 つのサービスを構成します。 サービスは通常、ルートの前に定義されます。
ルートとは？
ルートは、クライアントアプリケーションが InterSystems API Manger に対して呼び出すものを定義します。 インターフェースを使用すると、定義されたサービスからそれに対応するルートが簡単に作成されるようになっているため、通常は、ルートの前にサービスを定義します。 ルートは一般に、InterSystems IRIS 内のパスを単純化したものです。 次の例では、 /test、/coffeemakers、/coffeemaker、および /newcoffeemaker のルートを作成します。 ルートが具体的であるほど、メトリックの表示と特定のルートへのプラグインの追加において、API Manager 内で API をより細かく制御できます。
サービスを作成する:
ルートを作成する:
サービスとルートが作成されたら、Postman などの REST クライアントを使用して、直接 IAM にリクエストを送信し、「200 ok」のレスポンスを受信することができます。例: GET http://10.0.0.1:8000/test（/test は作成されたルートです。）
注意: 私の場合、HTTP リクエストの URL は Linux VM の IP アドレスと一致していますが、この IP アドレスは［設定］> ［ネットワーク］で確認するか、ターミナルで "ifconfig" コマンドを実行して調べてください。
IAM 管理ポータルを開いてリクエストを確認すると、すべての coffeemakers が REST クライアントから IAM に正しく記録されているのがわかります。
HTTP リクエストを直接 IRIS Web アプリケーションに送信するのではなく、基本的な CRUD リクエストであっても、IAM を使用すると、視覚的な表現によって API を制御し、エンドポイントのセキュリティを維持することができます。
プラグインの使用
IAM を使用するメリットの 1 つに、スロットリングに役立つレート制限プラグイン、ACL プラグイン、OAuth2.0 プラグインなど、多数のプラグインの存在が挙げられます。 個人的なケースとして、basic-auth の有効化とコンシューマーの作成における体験を紹介します。
basic-auth プラグインを有効にする
Basic Auth に必要な IRIS ユーザーを作成する
コンシューマーを作成して、資格情報をセットアップする
これで、basic-auth プラグインを機能させるための要件がすべて揃いました。
前のステップで作成した "CoffeeManager" の資格情報で Basic Auth を使って、HTTP リクエストを送信します。
CoffeeManager 情報ページ >［アクティビティ］に移動すると、リクエストが成功したことが記録されていることを確認できます。
まとめると、InterSystems API Manager（IAM）とは何か、またそのメリットを最初に紹介しました。 続いて、Linux VM で IAM をセットアップする方法と基本機能を実装して IAM を使用する方法を示し、サービスとルートの作成、プラグインとコンシューマーの有効化を行いました。
ご質問やコメントがございましたら、お気軽にご連絡ください。
IAM をお楽しみください！
こんにちは、大丈夫ですか？
助けを求めに来ました。インターシステムズ ポルトガル語のコンテストに参加しているので、リンクからこの記事を作成しました。私の記事にアクセスしてフィードバックをいただけますか。「いいね！」も歓迎です。
読むには、ブラジル系ポルトガル語からあなたの言語に翻訳するだけです。
InterSystems API Manager (IAM) バージョン 3.2.1 が公開されました。 IAM 3.2.1では、バグフィックスや細かな改良に加え、IRISのお客様にとって興味深い新しいプラグインが追加されています。
InterSystems API Manager (IAM) バージョン2.3がリリースされました
IAMコンテナや以前のバージョンからアップグレードに必要な関連ソフトウェアは全てWRCソフトウエア配布サイトの「Components」エリアからダウンロードできます。
このリリースのビルド番号は IAM 2.3.3.2-1 です。
このリリースはKong Enterprise バージョン2.3.3.2を基にしています。
InterSystems API Manager バージョン2.3を使用することで、セキュアな方法でのデプロイや高可用性対応がより簡単に実現できます。
IAMは以下の内容を含め、さまざまな新機能があります。
ハイブリッドモードはデータプレーンとコントロールプレーンのIAMノードをデプロイできます。データプレーンがAPIトラフィックを扱っている間にコントロールプレーンはデータプレーンノードを設定したり、データプレーンからのテレメトリーを観察するのに使われます。これは導入時における柔軟性とHAシナリオを容易に実現できます。ハイブリッドモードの詳細はこちら。この機能はインターシステムズ開発者コミュニティで後ほど詳しく紹介されます。
インターシステムズは InterSystems IRIS および IRIS for Health バージョン2020.4 をリリースしました。本バージョンは、継続的デリバリ(CD) リリースのため、Docker コンテナ として知られる OCI (Open Container Initiative)形式 (for Linux x86-64 および Linux ARM64) のみ入手いただけます。
コンテナイメージは OCI に準拠した Linux x86-64 および Linux ARM64 対応のランタイムエンジンで動作可能です。
あわせて IRIS Studio 2020.4 もリリースしました。
リリースのビルド番号は 2020.4.0.547.0 です。
【新機能のご紹介】
InterSystems IRIS Data Platform 2020.4 には、以下の新機能が含まれます。
InterSystems API Manager(IAM) バージョン1.5がリリースされました
以前のバージョンからアップグレードできるIAMコンテナはWRCソフトウェア配布サイトのComponents areaからダウンロードすることができます。
ビルド番号はIAM 1.5.0.9-4 です。
InterSystems API Manager 1.5 ではAPIトラフィックの管理や、環境とAPI利用者の統合がさらに簡単になりました。新機能は以下の通りです。
このリリースは、Kong Enterprise バージョン 1.5.0.9 をベースにしています。これまでのIAMリリースにはKong Enterpriseのホワイトラベルバージョンが入っていましたが、このリリースではホワイトラベルなしバージョンが入っています。この変更で、より頻繁にリリースすることができ、 Kongの提供するドキュメントやその他の資産を効果的に活用できるようになりました。
IAM 1.5のドキュメントはこちらです。このドキュメントはIAM固有の部分のみカバーしています。製品のドキュメントからユーザは直接 Kong Enterpriseのドキュメントを参照できます。
IAM 0.34-1 からのアップグレードはこちらのドキュメントで詳細が記載されている3つの中間リリースを通してアップグレードする必要があります。
IAM はdockerコンテナとして知られるOCI (Open Container Initiative) でのみ動作します。 コンテナイメージはOCIに準拠したLinux x86-64、Linux ARM64対応のランタイムエンジンで動作可能です。詳細はサポートプラットホームを参照してください。
よろしくお願いいたします。
Stefan
InterSystems API Management（IAM）は、IT インフラストラクチャ内の Web ベースの API との間のトラフィックを監視、制御、および管理できる InterSystems IRIS Data Platform の新機能です。 アナウンスを見逃した方は、こちらのリンクを参照してください。 また、IAM の使い方を説明した記事もあります。
この記事では、InterSystems API Management を使用して API の負荷を分散します。
この例では、2 つの InterSystems IRIS インスタンスを使用し、クライアントに /api/atelier REST API を公開したいと思います。
そのようにしたいと思う理由は、次のようにさまざまです。
しかし、いずれの場合も実行する必要のある手順は同じようなものです。
必要な作業を以下に掲載します。
1. アップストリームの作成
アップストリームは仮想ホスト名を表し、複数のサービス（ターゲット）で着信リクエストの負荷を分散するために使用されます。 例えば、service.v1.xyz という名前のアップストリームはホストが service.v1.xyz であるサービスのリクエストを受け付けます。 このサービスのリクエストは、アップストリーム内で定義されたターゲットにプロキシされます。
アップストリームには、リクエストを処理する能力の有無に基づいてターゲットを有効または無効にできるヘルスチェッカーも含まれています。
はじめに、次の手順を実行します。
[New Upstream] ボタンをクリックすると、アップストリームに関する基本情報を入力できるフォームが表示されます（他にも多くのプロパティがあります）。
name にサービスが使用する仮想ホスト名を入力します。 この値は DNS レコードとは無関係です。 混乱を避けるために、存在しない値に設定することをお勧めします。 残りのプロパティについて確認したい場合は、ドキュメントを参照してください。 スクリーンショットでは、新しいアップストリームに myupstream という仮の名前を付けています。
2. ターゲットの作成
ターゲットは、リクエストを実行して結果をクライアントに送り返すバックエンドサーバーです。 アップストリームに移動し、作成したアップストリーム名をクリックします（[Update] ボタンではありません）。
既存のすべてのターゲット（現時点では存在しません）と [New Target] ボタンが表示されます。 このボタンを押します。
そして、新しいフォームでターゲットを定義します。 ここで使用できるパラメーターは次の 2 つだけです。
ここでは次のように 2 つのターゲットを追加しました。
3. サービスの作成
アップストリームを作成しましたので、今度はそのアップストリームにリクエストを送信する必要があります。 そのためにはサービスを使用します。
サービスエンティティは、その名前が示すように各アップストリームサービスを抽象化したものです。 サービスの例としては、データ変換、
マイクロサービス、課金 API などがあります。
IRIS インスタンスをターゲットとするサービスを作成してみましょう。[Service] に移動し、[New Service] ボタンを押します。
次の値を設定します。
| フィールド | 値 | 説明 |
|---|---|---|
| name | myservice | このサービスの論理名 |
| host | myupstream | アップストリーム名 |
| path | /api/atelier | 提供したいルートパス |
| protocol | http | サポートしたいプロトコル |
上記以外はデフォルト値のままにしてください（port: 80 を含みます）。
作成したサービスは、サービスのリストに表示されます。 サービスの id をどこかにコピーしておいてください。後で必要になります。
4. ルートの作成
ルートは、クライアントのリクエストに一致するルールを定義します。 各ルートはサービスに関連付けられ、サービスには複数のルートを関連付けることができます。
特定のルートに一致するすべてのリクエストは、関連するサービスにプロキシされます。
ルートとサービスを組み合わせる（およびそれらの関係を分離する）ことで強力なルーティング機構を実現し、インフラストラクチャのさまざまなアップストリームサービスにつながる IAM できめ細かなエントリポイントを定義することができます。
それでは、ルートを作成しましょう。 [Routes] に移動し、[New Route] ボタンを押します。
ルートの作成フォームで次の値を設定します。
| フィールド | 値 | 説明 |
|---|---|---|
| path | /api/atelier | 提供したいルートパス |
| protocol | http | サポートしたいプロトコル |
| service.id | 3のguid | サービス id の値（前のステップの guid） |
以上です！
http://localhost:8000/api/atelier/（最後のスラッシュに注意）に送信されたリクエストは、2 つのバックエンドのいずれかによって処理されます。
IAM は詳細にカスタマイズ可能な API 管理インフラストラクチャを提供し、開発者と管理者が API を制御できるようにします。
IAM を使用してどのような機能を実現してほしいですか？
開発者のみなさん、こんにちは！
InterSystems IRIS Data Platform を使用してオープンソースソリューションを作成するコンテストへようこそ！
今回のコンテスト用テンプレートはこちら！（8/10 更新） ➡️ IRIS-FHIR-Template ⬅️
（InterSystems IRIS for Health のプレビューリリース版：2020.3 が利用されている開発テンプレートです）
テンプレートの日本語 Readme をご用意しています。
優勝特典
１、審査員から多く票を集めたアプリケーションには、以下の賞金が贈られます。
🥇 1位 - $2,000
🥈 2位 - $1,000
🥉 3位 - $500
2、Developer Community で多く票を集めたソリューションには、以下の賞金が贈られます。
🥇 1位 - $1,000
🥈 2位 - $500
複数の参加者が同数の票を獲得した場合、全参加者が勝者となり賞金は勝者間で分配されます。
参加資格
どなたでもご参加いただけます！（InterSystems 開発者コミュニティのアカウントを作成するだけでご応募いただけます）
コンテストのスケジュール
8月10日～23日 応募期間
8月24日～30日 投票
8月31日 優秀者発表
コンテストのテーマ
この記事では、REST API開発への仕様ファーストアプローチについて説明します。
従来のコードファーストREST API開発は次のようになります。
仕様ファーストのアプローチでは同じ手順を行いますが、順序が逆になります。 ドキュメントを兼ねた仕様書を作成し、そこからRESTアプリの定型文を生成して、最後にビジネスロジックを書きます。
これは、次の理由でメリットがあります。