User Authentication

Overview

The Password Generator uses JWT (JSON Web Token) authentication powered by Django REST Framework SimpleJWT. This provides secure, stateless authentication for both web and API clients.

Authentication Flow

User Sign-Up

New users create an account with email, username, and password. The system returns access and refresh tokens immediately upon successful registration.

Token Storage

The client stores the access token (short-lived) and refresh token (long-lived) securely, typically in sessionStorage or httpOnly cookies.

Authenticated Requests

Include the access token in the Authorization header: Bearer <token>

Token Refresh

When the access token expires, use the refresh token to obtain a new access token without requiring re-authentication.

New users register through the /api/users/sign-up/ endpoint.

API Endpoint

URL: POST /api/users/sign-up/ Authentication: Not required (AllowAny) Request Body:

{
  "username": "johndoe",
  "email": "[email protected]",
  "password": "SecurePass123!",
  "first_name": "John",
  "last_name": "Doe",
  "number_phone": "1234567890"
}

Response:

{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGc...",
  "access": "eyJ0eXAiOiJKV1QiLCJhbGc...",
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe",
    "number_phone": "1234567890"
  }
}

Implementation

The sign-up view is implemented in views.py:47-79:

@api_view(['POST'])
@permission_classes([AllowAny])
def sign_up(request):
    try:
        serializer = UsersSerializer(data=request.data)
        
        if serializer.is_valid():
            serializer.save()
            
            user = Users.objects.get(username=serializer.data['username'])
            user.email = serializer.data['email']
            user.set_password(serializer.data['password'])
            user.first_name = serializer.data['first_name']
            user.last_name = serializer.data['last_name']
            user.number_phone = serializer.data['number_phone']
            user.save()
            
            refresh = RefreshToken.for_user(user)
            
            return Response({
                'refresh': str(refresh),
                'access': str(refresh.access_token),
                'user': serializer.data
            }, status=status.HTTP_201_CREATED)
        
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

The password is securely hashed using Django’s set_password() method, which uses PBKDF2 by default.

The frontend implements sign-up with a React form component:

const handleSubmit = async (e) => {
  e.preventDefault();
  
  try {
    const response = await SignUpUser(formData);
    sessionStorage.setItem('authToken', response.data.access);
    sessionStorage.setItem('user', JSON.stringify(response.data.user));
    window.location.href = "/";
  } catch (error) {
    setErrorMessage(error.response.data.error || "Registration failed");
  }
};

Existing users authenticate through the /api/users/sign-in/ endpoint.

API Endpoint

URL: POST /api/users/sign-in/ Authentication: Not required (AllowAny) Request Body:

{
  "email": "[email protected]",
  "password": "SecurePass123!"
}

Response:

{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGc...",
  "access": "eyJ0eXAiOiJKV1QiLCJhbGc...",
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe"
  }
}

Implementation

The sign-in view is implemented in views.py:21-44:

@api_view(['POST'])
@permission_classes([AllowAny])
def sign_in(request):
    try:
        user = get_object_or_404(Users, email=request.data.get('email'))
        
        if not user.check_password(request.data.get('password')):
            return Response({'error': 'Invalid password'}, status=status.HTTP_400_BAD_REQUEST)
        
        refresh = RefreshToken.for_user(user)
        serializer = UsersSerializer(instance=user)
        
        return Response({
            'refresh': str(refresh),
            'access': str(refresh.access_token),
            'user': serializer.data
        }, status=status.HTTP_200_OK)
    
    except KeyError:
        return Response({'error': 'Email and password are required.'}, status=status.HTTP_400_BAD_REQUEST)
    except Users.DoesNotExist:
        return Response({'error': 'User does not exist.'}, status=status.HTTP_404_NOT_FOUND)

The sign-in implementation (SignInRequest.jsx:25-49):

const handleSubmit = async (e) => {
  e.preventDefault();
  
  if (!formData.email || !formData.password) {
    setErrorMessage("You must enter both email and password");
    return;
  }
  
  try {
    const response = await SignInUser(formData);
    sessionStorage.setItem('authToken', response.data.access);
    sessionStorage.setItem('user', JSON.stringify(response.data.user));
    window.location.href = "/";
  } catch (error) {
    setErrorMessage(error.response.data.error || "Login failed");
  }
};

Form Fields

The sign-in form includes email and password fields with NextUI Input components and validation feedback.

Token Refresh Mechanism

SimpleJWT provides automatic token refresh capabilities. When the access token expires, use the refresh token to obtain a new one.

Refresh Token Endpoint

URL: POST /api/token/refresh/ Request Body:

{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGc..."
}

Response:

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGc..."
}

Token Lifecycle

Access Token

Short-lived token (typically 5-15 minutes) used for API requests

Refresh Token

Long-lived token (typically 1-7 days) used to obtain new access tokens

Client-Side Token Management

// Store tokens after authentication
sessionStorage.setItem('authToken', response.data.access);
sessionStorage.setItem('refreshToken', response.data.refresh);

// Include access token in API requests
const config = {
  headers: {
    'Authorization': `Bearer ${sessionStorage.getItem('authToken')}`
  }
};

// Refresh token when access token expires
const refreshAccessToken = async () => {
  const refreshToken = sessionStorage.getItem('refreshToken');
  const response = await axios.post('/api/token/refresh/', {
    refresh: refreshToken
  });
  sessionStorage.setItem('authToken', response.data.access);
};

Protected Endpoints

Many endpoints require authentication using the @permission_classes([IsAuthenticated]) decorator:

@api_view(['POST'])
@permission_classes([IsAuthenticated])
def save_passwords(request):
    # Only accessible with valid access token
    user = request.user
    # ...

Making Authenticated Requests

cURL Example:

curl -X GET http://localhost:8000/api/passwords/saved/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGc..."

JavaScript Example:

const response = await fetch('/api/passwords/saved/', {
  headers: {
    'Authorization': `Bearer ${sessionStorage.getItem('authToken')}`,
    'Content-Type': 'application/json'
  }
});

User Model

The custom user model extends Django’s AbstractUser (models.py:5-16):

class Users(AbstractUser):
    email = models.EmailField(max_length=200, unique=True)
    first_name = models.CharField(max_length=200, blank=True, default='')
    last_name = models.CharField(max_length=200, blank=True, default='')
    number_phone = models.CharField(max_length=10, blank=True, null=True)
    avatar = models.ImageField(upload_to='avatars/', blank=True, null=True)
    
    REQUIRED_FIELDS = ['email']

The email field is unique and required for authentication, serving as the primary identifier for login.

Error Handling

The authentication views provide detailed error responses:

Error Scenario	HTTP Status	Response
Missing credentials	400	`{"error": "Email and password are required."}`
Invalid password	400	`{"error": "Invalid password"}`
User not found	404	`{"error": "User does not exist."}`
Server error	500	`{"error": "<error message>"}`

Security Best Practices

Security Recommendations:

Always use HTTPS in production
Store tokens securely (httpOnly cookies preferred over localStorage)
Implement token rotation strategies
Set appropriate token expiration times
Use CORS policies to restrict API access
Implement rate limiting on authentication endpoints

For enhanced security, consider implementing:

Two-factor authentication (2FA)
Email verification on sign-up
Password strength requirements
Account lockout after failed attempts

Get Started

Features

Python Package

Deployment

Overview

Authentication Flow

API Endpoint

Implementation

API Endpoint

Implementation

Form Fields

Token Refresh Mechanism

Refresh Token Endpoint

Token Lifecycle

Access Token

Refresh Token

Client-Side Token Management

Protected Endpoints

Making Authenticated Requests

User Model

Error Handling

Security Best Practices

​Overview

​Authentication Flow

​Sign-Up Process

​API Endpoint

​Implementation

​Frontend Sign-Up

​Sign-In Process

​API Endpoint

​Implementation

​Frontend Sign-In

Form Fields

​Token Refresh Mechanism

​Refresh Token Endpoint

​Token Lifecycle

Access Token

Refresh Token

​Client-Side Token Management

​Protected Endpoints

​Making Authenticated Requests

​User Model

​Error Handling

​Security Best Practices

Overview

Authentication Flow

Sign-Up Process

API Endpoint

Implementation

Frontend Sign-Up

Sign-In Process

API Endpoint

Implementation

Frontend Sign-In

Token Refresh Mechanism

Refresh Token Endpoint

Token Lifecycle

Client-Side Token Management

Protected Endpoints

Making Authenticated Requests

User Model

Error Handling

Security Best Practices