API Gateway ってただのルーターだと思っていました

私、恥ずかしながら AWS API Gateway をただのルーターだと思っていました。
(Laravelで言うところのweb.php

実態を調べていくと Gateway の名がつく通り、玄関口としての機能の他、マネージドサービスとしての様々な機能が搭載されていることが分かったため備忘録として残したいと思います。

はじめに知っておくべきこと

APIから理解していく

API = Application Interface という名がつく通り、リクエストを投げるためのインターフェースです。

テレビのリモコンを利用する際にあるボタンを押すと特定の動作が実行されることを想像してください。
私達はリモコン内部の詳細な処理を知っていなくても、ボタンを押すと期待する動作が実行されます。

それと同じで、
APIの呼び出し元は必要な情報を入力すると要求するデータが返ってくることが知っていればよいのです。
これがAPIの正体です。

概要と基本機能

API GatewayはAWSが提供するマネージドサービスで、以下を一元的に管理できるサービスです。

バージョン管理や環境ごとのデプロイ、認証・認可、モニタリングなどができるためデベロッパーを幸せにしてくれるサービスです。

ユースケース

RestAPIとHTTPAPIは機能が異なっているよ

基本的にはHTTPプロトコルを使用しますが、AWS API Gatewayの場合、REST APIとHTTP APIでいくつか仕様の違いがあります。

• AWS API GatewayのREST APIを使用する場合、認証やリクエストパスに設定が必要
• HTTP APIはAWS API Gatewayの軽量版で、低レイテンシーと簡単な設定が特徴です。多くの場合、REST APIよりもシンプル

//////////////////////
//　RestAPI
///////////////////////
const axios = require('axios');

const httpApiUrl = "https://example.execute-api.us-east-1.amazonaws.com/resource"; // HTTP APIのエンドポイント
const token = "your-auth-token"; // 必要に応じてJWTや他の認証トークンを使用

async function callHttpApi() {
    try {
        const response = await axios.post(httpApiUrl, 
            { data: "Sample payload" }, // リクエストボディ
            {
                headers: {
                    Authorization: `Bearer ${token}`, // HTTP APIではJWTを使用するケースが多い
                },
            }
        );
        console.log("HTTP API Response:", response.data);
    } catch (error) {
        console.error("Error calling HTTP API:", error.response ? error.response.data : error.message);
    }
}

callHttpApi();

//////////////////////
//　HTTPAPI
///////////////////////
const axios = require('axios');

const httpApiUrl = "https://example.execute-api.us-east-1.amazonaws.com/resource"; // HTTP APIのエンドポイント
const token = "your-auth-token"; // 必要に応じてJWTや他の認証トークンを使用

async function callHttpApi() {
    try {
        const response = await axios.post(httpApiUrl, 
            { data: "Sample payload" }, // リクエストボディ
            {
                headers: {
                    Authorization: `Bearer ${token}`, // HTTP APIではJWTを使用するケースが多い
                },
            }
        );
        console.log("HTTP API Response:", response.data);
    } catch (error) {
        console.error("Error calling HTTP API:", error.response ? error.response.data : error.message);
    }
}

callHttpApi();

その他にも様々な違いがあるため、一度目を通していただくと良いです。

https://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/http-api-vs-rest.html

知っておくと幸せになれるお話

パフォーマンス最適化

VPCのリソースへアクセスさせるためには

VPC内のリソースとAPI Gatewayを接続するには、「VPCリンク」というリソースを作成します。
これにより、API GatewayがVPC内のリソースに安全にアクセスできます。

認証・認可が不要なのでは？

バックエンドにWEBフレームワークを指定する場合は、WEBフレームワークで認証認可を行えば良いと思っていましたが、調べていくうちにAPI Gatewayで実施する方が効率が良いことに気付きました。

また、WEBフレームワークを使用する場合でも API Gatewayでの認証認可 + WEBフレームワークでの認証認可の2段階で実施することはセキュリティ強化につながるのではないかと考えます。
(冗長ですが、重ねて対策することでセキュリティ対策を向上させることができると思っています。