ユーザ登録

ユーザ登録を行うPOST /signupエンドポイントを実装します。メールアドレスとパスワードを受け取り、ハッシュ化してusersテーブルにユーザレコードを作成する処理です。

1. パスワードハッシュヘルパーの追加

パスワードをハッシュ化するヘルパー関数を追加します。

📝 ヘルパー関数とは
ヘルパー関数(helper function)は、他の関数から共通で使うために切り出した補助的な小さな関数のことです。同じ処理を各所で書き重ねずに済み、呼び出し元のコードを読みやすく保てます。

パスワードのハッシュ化はsignupハンドラだけで呼び出す処理ですが、以降で追加するパスワード検証(checkPassword)やJWT発行と合わせて「認証まわりの共通処理」として、helper.goという専用ファイルにまとめて置きます。main.goやhandler.goから独立させておくと、認証ロジックの読みやすさが上がり、bcryptから別のハッシュアルゴリズムへの入れ替えなどの変更も1箇所で済むようになります。

Visual Studio Codeのエクスプローラーでjwt-auth-hands-onフォルダを右クリックし、「新しいファイル」を選択してhelper.goを作成します。

jwt-auth-hands-on/
├── .env
├── go.mod
├── go.sum
├── helper.go  ← このファイルを作成
├── main.go
└── model.go

作成したhelper.goに以下の内容を記述して保存します。

package main

import (
	"golang.org/x/crypto/bcrypt"
)

func hashPassword(password string) (string, error) {
	bytes, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
	return string(bytes), err
}

helper.goもmain.go・model.goと同じmainパッケージに属するので、以降で追加するhandler.goからhashPasswordをそのまま呼び出せます。

コードを解説します。

func hashPassword(password string) (string, error) {

関数のシグネチャです。引数として生のパスワード文字列を受け取り、戻り値としてハッシュ化した文字列とエラーを返します。エラーは呼び出し元でハンドリングします。

bytes, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)

bcrypt.GenerateFromPasswordは、生のパスワードからソルト付きのハッシュを生成します。bcryptはstringではなく[]byteを受け取るため、[]byte(password)で変換して渡しています。ハッシュ化にはコスト(計算量)が伴い、DefaultCost(現行では10)程度の負荷がかけられます。DefaultCostはbcryptパッケージが推奨する既定値で、CPU性能の変化に合わせて追従されます。

return string(bytes), err

生成されたハッシュは[]byteで返るため、DBにstringとして保存できるよう変換して返します。エラーが発生した場合はそのまま呼び出し元に返します。

📝 パスワードハッシュに関する仕様
bcryptによるパスワードハッシュの仕様と使い方は、golang.org/x/crypto/bcrypt(Go公式ドキュメント)に記載があります。ハッシュ化されていないパスワードや、SHA-1・SHA-256などの単純なハッシュ(ソルトなし・ストレッチングなし)でパスワードを保存する構成は、パスワードリスト攻撃・レインボーテーブル攻撃に対して脆弱です。パスワード保存には必ず、bcryptのようなソルト付き・計算コスト調整可能なハッシュ方式を使うようにします。

2. signup ハンドラの追加

続いて、HTTPハンドラを配置するhandler.goを作成します。以降のエンドポイントのハンドラもすべてこのファイルに追記します。jwt-auth-hands-onフォルダにhandler.goを作成します。

jwt-auth-hands-on/
├── .env
├── go.mod
├── go.sum
├── handler.go  ← このファイルを作成
├── helper.go
├── main.go
└── model.go

作成したhandler.goに以下の内容を記述して保存します。signupハンドラを含む形です。

package main

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

func signup(c *gin.Context) {
	var input struct {
		Email    string `json:"email" binding:"required,email"`
		Password string `json:"password" binding:"required,min=8"`
	}
	if err := c.ShouldBindJSON(&input); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}

	hash, err := hashPassword(input.Password)
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	user := User{Email: input.Email, PasswordHash: hash}
	if err := db.Create(&user).Error; err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	c.JSON(http.StatusCreated, user)
}

handler.goも同じmainパッケージなので、helper.goのhashPasswordやmodel.goのUser、main.goのdbをそのまま参照できます。

続けて、main.goのmain関数のr := gin.Default()とr.Run(":8080")の間に、ルート登録を追加します。

	r.POST("/signup", signup)

3. コードの解説

func signup(c *gin.Context) {

Ginのハンドラの標準シグネチャです。引数の*gin.Contextから、リクエストの読み取りとレスポンスの書き込みの両方を行います。

Email    string `json:"email" binding:"required,email"`

リクエストボディのemailフィールドを受け取る定義です。binding:"required,email"で、必須かつメールアドレス形式であることを宣言しています。

Password string `json:"password" binding:"required,min=8"`

同じくリクエストボディのpasswordフィールドを受け取る定義です。min=8でパスワードの最小文字数を制約しています。

if err := c.ShouldBindJSON(&input); err != nil {
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
}

c.ShouldBindJSONは、リクエストボディをJSONとしてデコードし、同時にbindingタグのバリデーションも実行します。デコード失敗やバリデーション違反があれば、400 Bad Requestでエラーメッセージを返して以降の処理を中断します。

hash, err := hashPassword(input.Password)
if err != nil {
    c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
    return
}

受け取ったパスワードを先ほど定義したhashPasswordヘルパーでハッシュ化します。ハッシュ生成に失敗するのはbcrypt側のシステムエラー相当なので、500 Internal Server Errorで返します。

user := User{Email: input.Email, PasswordHash: hash}
if err := db.Create(&user).Error; err != nil {
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
}

メールアドレスとハッシュ化したパスワードからUserレコードを作り、db.CreateでDBに挿入します。同じメールアドレスがすでに登録されているとEmailのuniqueIndex制約に引っかかってエラーになるため、400 Bad Requestで返します。

c.JSON(http.StatusCreated, user)

作成したユーザを201 Createdで返します。PasswordHashにはJSONタグ-を付けているため、レスポンスには含まれません。

4. 動作確認

サーバを起動します。

go run .

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

[GIN-debug] Listening and serving HTTP on :8080

別のターミナルから、ユーザを作成します。

curl -X POST http://localhost:8080/signup -H "Content-Type: application/json" -d '{"email":"test@example.com","password":"password12345"}'

以下のような実行結果が表示されます(IDと日時は環境により変わります)。

{"id":1,"email":"test@example.com","created_at":"2026-08-22T12:00:00Z"}

PasswordHashはJSONタグ-を付けているため、レスポンスに含まれません。念のため、MySQL側でもusersテーブルに実際にレコードが登録されていることを確認します。別のターミナルを開き、rootユーザでMySQLにログインします。

mysql -u root -p

ログイン後、auth_hands_onデータベースを使用します。

USE auth_hands_on;

続いて、usersテーブルの中身を確認します。

SELECT id, email, password_hash, created_at FROM users;

以下のような実行結果が表示されます(password_hashの値はハッシュ化された結果なので毎回異なります)。

+----+-------------------+--------------------------------------------------------------+---------------------+
| id | email             | password_hash                                                | created_at          |
+----+-------------------+--------------------------------------------------------------+---------------------+
|  1 | test@example.com  | $2a$10$abc...(bcryptのハッシュ文字列)                       | 2026-08-22 12:00:00 |
+----+-------------------+--------------------------------------------------------------+---------------------+

password_hashカラムに$2a$10$から始まる文字列が入っていれば、bcryptによるハッシュ化と保存が正しく行えています。確認できたら、exit;でMySQLのプロンプトを抜けます。

exit;