DocsPricingBlog
Contact Us
Log inSign up for FREE
Back to Tech Articles

マイクロサービスのための堅牢なAPIゲートウェイの構築

Aug 29, 2025
# Misc

Ethan Miller

Product Engineer · Leapcell

This post is also available in English, 한국어, and Deutsch
Cover of "マイクロサービスのための堅牢なAPIゲートウェイの構築"

はじめに：最新APIの中枢神経系

急速に進化する最新ソフトウェアアーキテクチャの状況において、マイクロサービスは支配的なパラダイムとして台頭してきました。スケーラビリティ、柔軟性、独立したデプロイメントに関して比類なき利点を提供します。しかし、この分散型性質は複雑さももたらします。クライアントアプリケーションは、数十、あるいは数百もの個別のマイクロサービスとどのように対話するのでしょうか？一貫したセキュリティポリシーをどのように確保し、サービス過負荷を防ぎ、ネットワーク呼び出しを最適化するのでしょうか？その答えは、すべてのクライアントリクエストの唯一のエントリポイントとして機能する重要なコンポーネントであるAPIゲートウェイにあります。この記事では、そのようなゲートウェイを構築する実践的な側面について、そのコアな責任（認証、レート制限、リクエスト集約）に焦点を当て、クライアントとバックエンドエコシステム間の相互作用を合理化する方法を掘り下げていきます。

コアコンセプト：ゲートウェイの役割の理解

実装に入る前に、APIゲートウェイの機能の基礎となる基本概念を定義しましょう。

  • APIゲートウェイ: 1つ以上のAPIの前面に配置され、すべてのクライアントリクエストの単一エントリポイントとして機能するサーバー。内部システムアーキテクチャをカプセル化し、各クライアントに合わせたAPIを提供します。
  • 認証: ユーザーまたはシステムのIDを確認するプロセス。APIゲートウェイのコンテキストでは、これには通常、JWTなどのトークンを検証して、認可されたエンティティのみがダウンストリームサービスにアクセスできることを確認することが含まれます。
  • レート制限: APIまたはサービスへのアクセス速度を制御するために使用される手法。これにより、悪用を防ぎ、サービス拒否攻撃から保護し、クライアント間の公正な利用を保証します。
  • リクエスト集約: クライアントからの複数のリクエストをゲートウェイへの単一API呼び出しに結合するプロセス。ゲートウェイはこれらのリクエストをさまざまな内部サービスにディスパッチし、それらの応答を集約してから、統一された応答をクライアントに返します。これにより、ネットワークオーバーヘッドとクライアント側の複雑さが大幅に削減されます。

ゲートウェイの構築：アーキテクチャと実装

APIゲートウェイは、クライアントアプリケーションとマイクロサービスの間に配置されます。通常、プロキシレイヤー、各リクエストの処理パイプライン、および外部サービス（認証サーバーやレート制限用のキャッシュレイヤーなど）と対話するメカニズムが含まれます。

ルーティングとミドルウェアにはGinのような人気のあるWebフレームワークを使用し、設計パターンについてはKongやOcelotの概念を参考にしながら、GolangベースのAPIゲートウェイを使用した実践的な例を考えてみましょう。

認証

ゲートウェイは認証を強制するのに理想的な場所です。クライアントがリクエストを送信すると、ゲートウェイはそれをインターセプトし、認証資格情報（JWTを含むAuthorizationヘッダーなど）を抽出し、それらを検証します。

原則: IDプロバイダーまたは共有シークレットに対してクライアントから受信したトークンを検証します。

実装例（Ginを使用したGolang）：

package main

import (
	"log"
	"net/http"
	"strings"

	"github.com/gin-gonic/gin"
	"github.com/dgrijalva/jwt-go"
)

// JWT検証用のダミーシークレット
var jwtSecret = []byte("supersecretkey")

// AuthMiddlewareはJWTトークンを検証します
func AuthMiddleware() gin.HandlerFunc {
	return func(c *gin.Context) {
		authHeader := c.GetHeader("Authorization")
		if authHeader == "" {
			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Authorization header required"})
			return
		}

		parts := strings.Split(authHeader, " ")
		if len(parts) != 2 || parts[0] != "Bearer" {
			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Invalid Authorization header format"})
			return
		}

		tokenString := parts[1]
		token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
			if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok {
				return nil, jwt.NewValidationError("Unexpected signing method", jwt.ValidationErrorSignatureInvalid)
			}
			return jwtSecret, nil
		})

		if err != nil {
			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Invalid token: " + err.Error()})
			return
		}

		if claims, ok := token.Claims.(jwt.MapClaims); ok && token.Valid {
			c.Set("userID", claims["userID"])
			c.Next()
		} else {
			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Invalid token claims"})
		}
	}
}

func main() {
	r := gin.Default()
	r.Use(AuthMiddleware()) // すべてのルートに認証を適用

    r.GET("/api/v1/profile", func(c *gin.Context) {
        userID := c.MustGet("userID").(string)
        c.JSON(http.StatusOK, gin.H{"message": "Welcome, user " + userID + "!"})
    })

	// マイクロサービスにプロキシされる他のルートをシミュレート
	r.GET("/api/v1/products", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{"data": "List of products from service X"})
	})

	log.Fatal(r.Run(":8080")) // ポート8080で実行
}

このミドルウェアはリクエストをインターセプトし、JWTを検証し、成功した場合はユーザーIDをコンテキストに渡して、ダウンストリームサービスで使用したり、ログに記録したりできます。認可されていないリクエストは直ちに拒否されます。

レート制限

レート制限は、バックエンドサービスが過負荷にならないように保護するために不可欠です。固定ウィンドウ、スライディングウィンドウ、またはトークンバケットアルゴリズムなど、さまざまな戦略を使用して実装できます。

原則: 指定されたクライアント（IP、APIキー、または認証済みユーザーIDによって識別される）のリクエスト数を時間ウィンドウにわたって追跡し、定義済みのしきい値に達したらリクエストを拒否します。

実装例（Ginとシンプルなインメモリストアを使用したGolang）：

package main

// ... (既存のインポート、jwtSecret、AuthMiddleware) ...

import (
	"sync"
	time "time"
)

// RateLimiterは各クライアントのリクエスト数を格納します
type RateLimiter struct {
	mu       sync.Mutex
	clients  map[string]map[int64]int // clientID -> タイムスタンプ (ウィンドウ開始) -> カウント
	limit    int					// ウィンドウあたりの最大リクエスト数
	window   time.Duration			// 時間ウィンドウ
}

// NewRateLimiterは新しいRateLimiterを作成します
func NewRateLimiter(limit int, window time.Duration) *RateLimiter {
	return &RateLimiter{
		clients: make(map[string]map[int64]int),
		limit:   limit,
		window:  window,
	}
}

// Allowはクライアントのリクエストが許可されるかどうかをチェックします
func (rl *RateLimiter) Allow(clientID string) bool {
	rl.mu.Lock()
	defer rl.mu.Unlock()

	now := time.Now()
	currentWindowStart := now.Truncate(rl.window).UnixNano() // 現在の固定ウィンドウ開始

	// 古いウィンドウをクリーンアップ
	for ts := range rl.clients[clientID] {
		if ts < currentWindowStart - rl.window.Nanoseconds() { // 現在と前のウィンドウを追跡
			delete(rl.clients[clientID], ts)
		}
	}

	if _, exists := rl.clients[clientID]; !exists {
		rl.clients[clientID] = make(map[int64]int)
	}

	rl.clients[clientID][currentWindowStart]++

	totalRequestsInWindow := 0
	for ts, count := range rl.clients[clientID] {
		// 現在のウィンドウからのリクエストと、スライディングウィンドウのような感覚のために前の部分的なウィンドウを含める
		// 厳密な固定ウィンドウの場合、currentWindowStartのみをチェックします
		if ts == currentWindowStart { // 厳密な固定ウィンドウの例
			totalRequestsInWindow += count
		}
	}

	return totalRequestsInWindow <= rl.limit
}

// RateLimitMiddlewareはクライアントIDに基づくレート制限を強制します
func RateLimitMiddleware(rl *RateLimiter) gin.HandlerFunc {
	return func(c *gin.Context) {
		// 簡単のため、認証されている場合はユーザーIDを使用し、そうでない場合はIPアドレスを使用します
		clientID := c.ClientIP()
		if val, exists := c.Get("userID"); exists {
			clientID = val.(string)
		}

		if !rl.Allow(clientID) {
			c.AbortWithStatusJSON(http.StatusTooManyRequests, gin.H{"error": "Too many requests"})
			return
		}
		c.Next()
	}
}

// レート制限付きのmain関数
func main() {
	r := gin.Default()

	// グローバルレートリミッターをすべてのリクエスト用に初期化します (例: 10秒あたり5リクエスト)
	globalRateLimiter := NewRateLimiter(5, 10*time.Second)

	r.Use(AuthMiddleware(), RateLimitMiddleware(globalRateLimiter)) // 認証を適用し、次にレート制限を適用

	r.GET("/api/v1/profile", func(c *gin.Context) {
		userID := c.MustGet("userID").(string)
		c.JSON(http.StatusOK, gin.H{"message": "Welcome, user " + userID + "!"})
	})
	r.GET("/api/v1/products", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{"data": "List of products from service X"})
	})

	log.Fatal(r.Run(":8080")) // ポート8080で実行
}

注意: 実際のレートリミッターは、特にクラスター化されたゲートウェイデプロイメントにおいて、インスタンス間の同期とパフォーマンス向上のためにRedisのような分散ストアを使用するでしょう。

リクエスト集約

クライアントは、単一のビューをレンダリングしたり、複雑な操作を実行したりするために、複数のサービスからのデータを必要とすることがよくあります。複数の往復を行う代わりに、ゲートウェイはこれらのリクエストを集約できます。

原則: ゲートウェイは単一の「複合」リクエストを受信し、それをさまざまなマイクロサービスへのサブ要求に分解し、それらを並行して実行し、それらの応答を収集してから、クライアントに単一の応答を構成して返します。

実装例（Golang、概念的、特定の/productsおよび/usersサービスを想定）：

package main

// ... (既存のインポート、jwtSecret、AuthMiddleware、RateLimiterなど) ...

import (
	"encoding/json"
	"fmt"
	"io/ioutil"
)

// fetchFromServiceは内部サービスへのHTTPリクエストを行うヘルパー関数です
func fetchFromService(serviceURL string, client *http.Client) (map[string]interface{}, error) {
	resp, err := client.Get(serviceURL)
	if err != nil {
		return nil, fmt.Errorf("failed to fetch from service %s: %w", serviceURL, err)
	}
	defer resp.Body.Close()

	if resp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("service %s returned status %d", serviceURL, resp.StatusCode)
	}

	body, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		return nil, fmt.Errorf("failed to read response from service %s: %w", serviceURL, err)
	}

	var data map[string]interface{}
	err = json.Unmarshal(body, &data)
	if err != nil {
		return nil, fmt.Errorf("failed to unmarshal JSON from service %s: %w", serviceURL, err)
	}
	return data, nil
}

// AggregateDashboard Handler
func AggregateDashboard(c *gin.Context) {
	// ユーザープロファイルと推奨製品リストを
	// 別々のマイクロサービスから取得すると仮定します。
	userID := c.MustGet("userID").(string) // AuthMiddlewareから

	var (
		profileData  map[string]interface{}
		productsData map[string]interface{}
		userErr      error
		productErr   error
		wg           sync.WaitGroup
	)

	httpClient := &http.Client{Timeout: 5 * time.Second} // 内部サービス呼び出し用のクライアント

	wg.Add(1)
	go func() {
		defer wg.Done()
		// 実際には、これは内部プロファイルサービスへのURLになります
		profileData, userErr = fetchFromService(fmt.Sprintf("http://localhost:8081/users/%s", userID), httpClient)
	}()

	wg.Add(1)
	go func() {
		defer wg.Done()
		// 実際には、これは内部製品サービスへのURLになります
		productsData, productErr = fetchFromService("http://localhost:8082/recommendations", httpClient)
	}()

	wg.Wait() // すべてのゴルーチンが完了するのを待つ

	if userErr != nil {
		c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "Failed to fetch user profile", "details": userErr.Error()})
		return
	}
	if productErr != nil {
		c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "Failed to fetch product recommendations", "details": productErr.Error()})
		return
	}

	// 結果を集約
	response := gin.H{
		"userProfile":   profileData,
		"recommendations": productsData,
		"status":        "success",
	}

	c.JSON(http.StatusOK, response)
}

func main() {
	r := gin.Default()

	globalRateLimiter := NewRateLimiter(5, 10*time.Second)

	r.Use(AuthMiddleware(), RateLimitMiddleware(globalRateLimiter))

	r.GET("/api/v1/profile", func(c *gin.Context) {
		userID := c.MustGet("userID").(string)
		c.JSON(http.StatusOK, gin.H{"message": "Welcome, user " + userID + "!"})
	})
	
	// 集約エンドポイントを追加
	r.GET("/api/v1/dashboard", AggregateDashboard)

	log.Fatal(r.Run(":8080")) // ポート8080で実行
}

このAggregateDashboardハンドラは、ゲートウェイがさまざまな内部サービス（/usersと/recommendations）にリクエストをファンアウトし、それらの応答を並行して待機してから、単一の包括的な応答に結合する方法を示しています。これにより、クライアントのネットワーク遅延と複雑さが大幅に軽減されます。

結論：最新マイクロサービスのバックボーン

認証、レート制限、リクエスト集約といった機能を備えたAPIゲートウェイの実装は、単なるオプションの追加ではなく、堅牢でスケーラブルで安全なマイクロサービスアーキテクチャを構築するための基本的な要件です。これらの共通の懸念事項を集中化することにより、APIゲートウェイはクライアントの操作を簡素化し、システムの回復力を強化し、個々のマイクロサービスがビジネスロジックにのみ集中できるようにします。それは、分散型バックエンドへのアクセスを保護および最適化するインテリジェントなフロントドアとして真に機能します。

Share this article

HackerNews

More Posts from Leapcell

Popular Posts