Middleware for authentication in Astro

Introduction

Middleware for authentication helps check who you are before letting you use parts of a website. It keeps things safe by stopping strangers from getting in.

When you want to protect a page so only logged-in users can see it.

When you need to check user identity before showing personal info.

When you want to redirect users to login if they are not signed in.

When you want to add a simple security check before loading a page.

When you want to handle user sessions in a clean and reusable way.

Syntax

Astro

export async function onRequest(context, next) {
  // check user authentication here
  if (!context.request.headers.get('Authorization')) {
    return new Response('Unauthorized', { status: 401 });
  }
  return next();
}

The onRequest function runs before your page or API loads.

Use next() to continue if the user is allowed.

Examples

Simple check for an Authorization header. If missing, block access.

Astro

export async function onRequest(context, next) {
  const token = context.request.headers.get('Authorization');
  if (!token) {
    return new Response('Unauthorized', { status: 401 });
  }
  return next();
}

Only protect URLs starting with '/private'. Others are open.

Astro

export async function onRequest(context, next) {
  const url = new URL(context.request.url);
  if (url.pathname.startsWith('/private')) {
    const token = context.request.headers.get('Authorization');
    if (!token) {
      return new Response('Unauthorized', { status: 401 });
    }
  }
  return next();
}

Sample Program

This middleware checks if the user tries to visit '/dashboard'. If they don't send an Authorization token, it stops them with a 401 message. Otherwise, it lets them continue.

Astro

export async function onRequest(context, next) {
  const url = new URL(context.request.url);
  if (url.pathname.startsWith('/dashboard')) {
    const token = context.request.headers.get('Authorization');
    if (!token) {
      return new Response('Unauthorized - Please login', { status: 401 });
    }
  }
  return next();
}

// This middleware blocks access to '/dashboard' if no Authorization header is sent.

Important Notes

Middleware runs on every request, so keep it fast and simple.

Use clear messages and status codes like 401 for unauthorized access.

Remember to test your middleware by trying to access protected pages with and without login.

Summary

Middleware checks user identity before loading pages.

It helps protect private parts of your site.

Use next() to allow access, or return a response to block.

Practice

1. What is the main purpose of middleware for authentication in Astro?

easy

A. To fetch data from an external API after the page loads

B. To style the webpage with CSS before rendering

C. To check if a user is allowed to access certain pages before loading them

D. To optimize images automatically during build

Solution

1. Step 1: Understand middleware role

   Middleware runs before page loads to control access.

2. Step 2: Identify authentication purpose

   Authentication middleware checks user identity to allow or block access.

3. Final Answer:

   To check if a user is allowed to access certain pages before loading them -> Option C

4. Quick Check:

   Middleware controls access = A [OK]

Hint: Middleware controls access before page loads [OK]

Common Mistakes:

• Confusing middleware with styling or data fetching
• Thinking middleware runs after page loads
• Assuming middleware optimizes images

2. Which is the correct way to allow access to the next middleware or page in Astro authentication middleware?

easy

A. return context.stop()

B. return context.skip()

C. return context.block()

D. return context.next()

Solution

1. Step 1: Recall middleware flow control

   In Astro, calling context.next() passes control to next middleware or page.

2. Step 2: Identify correct method to continue

   Only context.next() allows access; others are invalid or block.

3. Final Answer:

   return context.next() -> Option D

4. Quick Check:

   Allow access = context.next() [OK]

Hint: Use context.next() to continue middleware chain [OK]

Common Mistakes:

• Using non-existent methods like context.stop()
• Confusing block and skip with next
• Omitting return keyword

3. Given this Astro middleware code snippet, what happens if the user is not authenticated?

export async function middleware(context) {
  if (!context.cookies.get('authToken')) {
    return new Response('Unauthorized', { status: 401 });
  }
  return context.next();
}

medium

A. The user sees a 401 Unauthorized response and page does not load

B. The user is redirected to the homepage

C. The middleware ignores the check and loads the page

D. The user is logged out automatically

Solution

1. Step 1: Analyze authentication check

   The code checks if 'authToken' cookie exists; if not, returns 401 response.

2. Step 2: Understand middleware response effect

   Returning a Response with status 401 stops page loading and shows unauthorized message.

3. Final Answer:

   The user sees a 401 Unauthorized response and page does not load -> Option A

4. Quick Check:

   Missing authToken = 401 response [OK]

Hint: Return Response with 401 to block unauthorized users [OK]

Common Mistakes:

• Assuming middleware redirects automatically
• Thinking page loads despite 401 response
• Confusing logout with blocking access

4. Identify the error in this Astro middleware code for authentication:

export async function middleware(context) {
  if (!context.cookies.get('authToken')) {
    context.next();
  }
  return new Response('Unauthorized', { status: 401 });
}

medium

A. The Response status 401 should be 200 to allow access

B. context.next() is called but its result is not returned, so middleware blocks all requests

C. The cookie name 'authToken' is incorrect and causes a runtime error

D. Middleware functions cannot be async in Astro

Solution

1. Step 1: Check middleware flow control

   context.next() must be returned to continue; here it is called but not returned.

2. Step 2: Understand effect of missing return

   Since return is after if-block, middleware always returns 401 response, blocking all requests.

3. Final Answer:

   context.next() is called but its result is not returned, so middleware blocks all requests -> Option B

4. Quick Check:

   Return context.next() to allow access [OK]

Hint: Always return context.next() to continue middleware chain [OK]

Common Mistakes:

• Calling context.next() without return
• Misunderstanding cookie name importance
• Thinking async is disallowed in middleware

5. You want to protect multiple private routes in Astro using middleware. Which approach correctly applies authentication middleware only to URLs starting with /dashboard or /settings?

hard

A. Check if context.url.pathname starts with '/dashboard' or '/settings' and run auth check only then

B. Apply middleware globally and always block access regardless of URL

C. Use middleware only on the homepage '/' to protect all routes

D. Check if context.url.pathname ends with '/dashboard' or '/settings' to run auth

Solution

1. Step 1: Understand route matching in middleware

   Middleware can check context.url.pathname to target specific routes.

2. Step 2: Identify correct string method for prefix matching

   Using startsWith matches routes beginning with '/dashboard' or '/settings'.

3. Step 3: Evaluate other options

   Blocking all routes or checking endsWith is incorrect for this purpose.

4. Final Answer:

   Check if context.url.pathname starts with '/dashboard' or '/settings' and run auth check only then -> Option A

5. Quick Check:

   Use startsWith for route prefix matching [OK]

Hint: Use startsWith to target route prefixes in middleware [OK]

Common Mistakes:

• Blocking all routes instead of specific ones
• Using endsWith instead of startsWith
• Applying middleware only on homepage