## 目次

1. はじめに
2. JWTとは何か
3. Django REST Framework (DRF) のセットアップ
   1. Djangoプロジェクトの作成
   2. DRFのインストール
4. Simple JWTの設定
   1. インストールと基本設定
   2. 認証クラスの追加
5. エンドポイントの作成
   1. ユーザー登録エンドポイント
   2. トークン発行エンドポイント
6. 中間層の設定
   1. Middlewareの設定
   2. 許可されたオリジンの設定
7. テストとデバッグ
   1. JWTトークンの取得と検証
   2. エラーハンドリング
8. まとめ

## 1. はじめに

Django REST Framework (DRF) での認証は、非常に重要かつ微妙な部分です。特にJSON Web Token (JWT) は、トークンベースのユーザー認証方式の中でも広く使用されています。本記事では、Django REST FrameworkにおいてJWT認証を設定し、簡単なAPIを作成する方法についてステップバイステップで解説します。

## 2. JWTとは何か

JWTは、情報をJSON形式で保存するWebトークンの一つです。このトークンは、送信者が正当なものであることを証明するために様々な情報を含むことができます。一般的には、認証情報として利用され、ユーザーがサーバーにログイン済みであるか検証するために使われます。

## 3. Django REST Framework (DRF) のセットアップ

### 3.1 Djangoプロジェクトの作成

まず、Djangoプロジェクトを作成します。

```bash
django-admin startproject myproject
cd myproject
```

### 3.2 DRFのインストール

次に、Django REST Frameworkをインストールします。

```bash
pip install djangorestframework
pip install djangorestframework-simplejwt
```

プロジェクトの`settings.py`に以下を追加します。

```python
INSTALLED_APPS = [
    ...
    'rest_framework',
    'rest_framework_simplejwt.token_blacklist',
]

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework_simplejwt.authentication.JWTAuthentication',
    ),
}
```

## 4. Simple JWTの設定

### 4.1 インストールと基本設定

`simplejwt`は、Django REST Framework用のJWT認証ライブラリで、トークンブラックリスト機能なども提供しています。

`settings.py`に以下の設定を追加して、Simple JWTを設定します。

```python
from datetime import timedelta

SIMPLE_JWT = {
    'ACCESS_TOKEN_LIFETIME': timedelta(minutes=5),
    'REFRESH_TOKEN_LIFETIME': timedelta(days=1),
    'ROTATE_REFRESH_TOKENS': True,
    'BLACKLIST_AFTER_ROTATION': True,
}
```

### 4.2 認証クラスの追加

先に述べた通り、DRFの認証クラスに`JWTAuthentication`を追加します。

```python
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework_simplejwt.authentication.JWTAuthentication',
    ),
}
```

## 5. エンドポイントの作成

### 5.1 ユーザー登録エンドポイント

ユーザーモデルを使用して新しいエンドポイントを追加します。

```python
from django.contrib.auth.models import User
from rest_framework import serializers, viewsets

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ('id', 'username', 'password', 'email')

    def create(self, validated_data):
        user = User.objects.create_user(
            username=validated_data['username'],
            password=validated_data['password'],
            email=validated_data['email']
        )
        return user

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer
```

### 5.2 トークン発行エンドポイント

トークンの発行には、REST Framework Simple JWTの`TokenObtainPairView`を使用します。

```python
from rest_framework_simplejwt.views import TokenObtainPairView

urlpatterns = [
    path('api/token/', TokenObtainPairView.as_view(), name='token_obtain_pair'),
]
```

## 6. 中間層の設定

### 6.1 Middlewareの設定

CORSを使用して、外部クライアントからのリクエストを許可します。

```bash
pip install django-cors-headers
```

`settings.py`に以下を追加します。

```python
INSTALLED_APPS = [
    ...
    'corsheaders',
]

MIDDLEWARE = [
    'corsheaders.middleware.CorsMiddleware',
    ...
]

CORS_ALLOWED_ORIGINS = [
    "http://localhost:3000",
    ...
]

```

### 6.2 許可されたオリジンの設定

`CORS_ALLOWED_ORIGINS`にて、外部クライアントがアクセス可能なオリジンを設定します。

## 7. テストとデバッグ

### 7.1 JWTトークンの取得と検証

APIを使用して、トークンが適切に発行されるか検証します。たとえば、Djangoの管理サイトやAPIリクエストを活用して行います。

### 7.2 エラーハンドリング

エラーハンドリングは、デプロイ前に徹底的にテストしてください。トークンが期限切れの場合や無効な場合は、適切なレスポンスを返す必要があります。

## 8. まとめ

Django REST FrameworkにおけるJWT認証の設定は、比較的簡単でありながら、セキュリティ上非常に重要です。このチュートリアルを通じて、適切な方法でJWT認証を実装でき、セキュアなAPIを構築する手順について理解できたと思います。

次回は、SSRやSSGの実装についても触れていく予定です。あなたのプロジェクトに合った認証方式を選択し、セキュリティを確保しましょう。 [cv:issue_marketplace_engineer]

目次

続きを読むには単価診断を受けてください（30秒）