アクセストークンの再発行

アクセストークンの再発行を行うPOST /refreshエンドポイントを実装します。リクエストで受け取ったリフレッシュトークンがDBに存在し、失効・期限切れになっていないことを確認したうえで、古いリフレッシュトークンを失効させて新しいアクセストークンとリフレッシュトークンを返す処理です。

1. refresh ハンドラの追加

サーバをいったんCtrl + Cで停止します。停止したら、handler.goの末尾(notes関数の下)にrefreshハンドラを追加します。refreshハンドラではtimeパッケージを使うため、handler.goのimportにも"time"を追加します。

import (
	"net/http"
	"time"

	"github.com/gin-gonic/gin"
)
func refresh(c *gin.Context) {
	var input struct {
		RefreshToken string `json:"refresh_token" binding:"required"`
	}
	if err := c.ShouldBindJSON(&input); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}

	var rt RefreshToken
	if err := db.Where("token = ?", input.RefreshToken).First(&rt).Error; err != nil {
		c.JSON(http.StatusUnauthorized, gin.H{"error": "refresh token が無効です"})
		return
	}
	if rt.RevokedAt != nil || time.Now().After(rt.ExpiresAt) {
		c.JSON(http.StatusUnauthorized, gin.H{"error": "refresh token が失効しています"})
		return
	}

	now := time.Now()
	rt.RevokedAt = &now
	if err := db.Save(&rt).Error; err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}

	accessToken, err := generateAccessToken(rt.UserID)
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	newRefreshToken, err := generateRefreshToken(rt.UserID)
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	c.JSON(http.StatusOK, gin.H{
		"access_token":  accessToken,
		"refresh_token": newRefreshToken,
	})
}

main.goのmain関数のルート登録に、既存のr.POST("/login", login)の下(認証必須グループより前が読みやすい位置)に以下を追加します。

	r.POST("/refresh", refresh)

2. コードの解説

func refresh(c *gin.Context) {

refreshハンドラのシグネチャです。ここでもGinの標準ハンドラ形式に沿っています。

var input struct {
    RefreshToken string `json:"refresh_token" binding:"required"`
}
if err := c.ShouldBindJSON(&input); err != nil {
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
}

リクエストボディのrefresh_tokenフィールドを受け取ります。値が無ければbinding:"required"のバリデーションで弾き、400 Bad Requestを返します。

var rt RefreshToken
if err := db.Where("token = ?", input.RefreshToken).First(&rt).Error; err != nil {
    c.JSON(http.StatusUnauthorized, gin.H{"error": "refresh token が無効です"})
    return
}

DBからリフレッシュトークンを検索します。存在しなければgorm.ErrRecordNotFoundが返るため、まとめて401 Unauthorizedで扱います。ここも「存在しない」と「失効している」でメッセージを分けず、詳細を漏らさない構成にしています。

if rt.RevokedAt != nil || time.Now().After(rt.ExpiresAt) {
    c.JSON(http.StatusUnauthorized, gin.H{"error": "refresh token が失効しています"})
    return
}

RevokedAtが非nil(=失効済み)か、ExpiresAtを過ぎている場合は、DBに残っていても再発行を拒否します。両方をチェックすることで、明示ログアウトと自然な期限切れの両方をカバーします。

now := time.Now()
rt.RevokedAt = &now
if err := db.Save(&rt).Error; err != nil {
    c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
    return
}

古いリフレッシュトークンのRevokedAtに現在時刻を入れて失効させます。再発行のたびに古いトークンを失効させるローテーション運用にしておくと、盗まれた古いトークンで永続的に新しいアクセストークンを取得され続けるリスクを下げられます。DB更新に失敗した場合はサーバ側の問題として500を返します。

accessToken, err := generateAccessToken(rt.UserID)
if err != nil {
    c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
    return
}
newRefreshToken, err := generateRefreshToken(rt.UserID)
if err != nil {
    c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
    return
}

古いトークンを失効させたうえで、新しいアクセストークンとリフレッシュトークンをloginと同じヘルパー(generateAccessTokenとgenerateRefreshToken)で発行します。それぞれの失敗はサーバ側の問題として500で返します。

c.JSON(http.StatusOK, gin.H{
    "access_token":  accessToken,
    "refresh_token": newRefreshToken,
})

新しいアクセストークンとリフレッシュトークンを200 OKでJSONにまとめて返します。クライアント側は、以降のリクエストで受け取った最新のリフレッシュトークンだけを使う運用になります。

3. 動作確認

サーバを起動します。

go run .

ログイン時に取得しておいたrefresh_tokenを/refreshに投げて、新しいアクセストークンとリフレッシュトークンを取得します。

curl -X POST http://localhost:8080/refresh -H "Content-Type: application/json" -d '{"refresh_token":"3f4c8d2a..."}'

以下のような実行結果が表示されます。

{"access_token":"eyJhbGciOi...新しい...","refresh_token":"a91b7e3d...新しい..."}

アクセストークンとリフレッシュトークンの両方が新しい値になっています。ここで、古いリフレッシュトークンで再度リフレッシュを試みると失効エラーになることを確認します。

curl -X POST http://localhost:8080/refresh -H "Content-Type: application/json" -d '{"refresh_token":"3f4c8d2a..."}'

以下のような実行結果が表示されます。

{"error":"refresh token が失効しています"}

/refreshのローテーションが働き、古いリフレッシュトークンは1度しか使えない状態になっています。次のセクションのログアウトでは、この新しく取得したリフレッシュトークン(a91b7e3d...)を使います。