アクセストークンの再発行
アクセストークンの再発行を行う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...)を使います。