Why API security is critical in FastAPI - See It in Action

Why API security is critical

📖 Scenario: You are building a simple FastAPI application that exposes an API endpoint for users to get their profile information. Since this API will be accessed over the internet, it is important to secure it so only authorized users can get their data.

🎯 Goal: Build a FastAPI app with a protected API endpoint that requires a simple API key for access. This will show why API security is critical to prevent unauthorized access.

📋 What You'll Learn

Create a FastAPI app instance

Add a variable to store a secret API key

Create an endpoint /profile that checks the API key in request headers

Return user profile data only if the API key matches

Return an error response if the API key is missing or wrong

💡 Why This Matters

🌍 Real World

APIs are often exposed to the internet and can be attacked or misused. Securing APIs with keys or tokens ensures only authorized users can access sensitive data or actions.

💼 Career

Understanding API security basics is essential for backend developers, API designers, and anyone working with web services to protect user data and maintain trust.

1

Create FastAPI app instance

Create a FastAPI app instance called app by importing FastAPI from fastapi and calling FastAPI().

FastAPI

from fastapi import FastAPI

# Create FastAPI app instance
# Your code here

Hint

Use from fastapi import FastAPI and then app = FastAPI().

2

Add secret API key variable

Add a variable called API_KEY and set it to the string "secret123".

FastAPI

from fastapi import FastAPI

app = FastAPI()

# Add secret API key variable
# Your code here

Hint

Just create a variable API_KEY and assign it the string "secret123".

3

Create protected /profile endpoint

Create a GET endpoint /profile using @app.get("/profile"). Inside the function get_profile, accept a parameter api_key from the request header using Header from fastapi. Check if api_key equals API_KEY. If yes, return a dictionary with {"user": "Alice", "email": "[e-mail]"}. If not, raise HTTPException with status code 401 and detail "Unauthorized". Remember to import Header and HTTPException from fastapi.

FastAPI

from fastapi import FastAPI

app = FastAPI()

API_KEY = "secret123"

# Create GET /profile endpoint with API key header check
# Your code here

Hint

Use @app.get("/profile") and a function with api_key from headers. Compare it to API_KEY and raise HTTPException if it does not match.

4

Complete app with security check

Ensure the full code includes imports for FastAPI, Header, and HTTPException, the app instance, the API_KEY variable, and the /profile endpoint with the API key check as described.

FastAPI

from fastapi import FastAPI, Header, HTTPException

app = FastAPI()

API_KEY = "secret123"

@app.get("/profile")
async def get_profile(api_key: str | None = Header(default=None)):
    if api_key == API_KEY:
        return {"user": "Alice", "email": "[e-mail]"}
    else:
        raise HTTPException(status_code=401, detail="Unauthorized")

# Finalize the app code
# Your code here

Hint

Make sure all parts are included and the code matches the previous step's solution.

Practice

1. Why is API security critical when building applications with FastAPI?

easy

A. It reduces the size of the API responses.

B. It makes the API run faster.

C. It automatically fixes bugs in the code.

D. It prevents unauthorized users from accessing sensitive data.

Solution

1. Step 1: Understand the purpose of API security

   API security is designed to stop unauthorized users from accessing or changing data they shouldn't see.

2. Step 2: Relate to FastAPI's use case

   FastAPI uses security measures like token checks to protect data and user privacy.

3. Final Answer:

   It prevents unauthorized users from accessing sensitive data. -> Option D

4. Quick Check:

   API security = prevent unauthorized access [OK]

Hint: Think: security means stopping unwanted access [OK]

Common Mistakes:

• Confusing security with performance improvements
• Believing security fixes bugs automatically
• Thinking security reduces data size

2. Which FastAPI code snippet correctly adds a security dependency to check an API token?

easy

A. from fastapi import Depends, Security
from fastapi.security import APIKeyHeader
api_key_header = APIKeyHeader(name="Authorization")

@app.get("/secure")
async def secure_route(api_key: str = Security(api_key_header)):
return {"key": api_key}

B. from fastapi import Depends

@app.get("/secure")
async def secure_route(token: str = Depends("Authorization")):
return {"token": token}

C. from fastapi import Security

@app.get("/secure")
async def secure_route(api_key: str = Security("Authorization")):
return {"key": api_key}

D. from fastapi import Depends

@app.get("/secure")
async def secure_route(api_key: str):
return {"key": api_key}

Solution

1. Step 1: Identify correct use of Security dependency

   FastAPI uses Security with APIKeyHeader to check headers like Authorization tokens.

2. Step 2: Check code correctness

   from fastapi import Depends, Security from fastapi.security import APIKeyHeader api_key_header = APIKeyHeader(name="Authorization") @app.get("/secure") async def secure_route(api_key: str = Security(api_key_header)): return {"key": api_key} correctly imports APIKeyHeader, creates a header dependency, and uses Security to enforce it.

3. Final Answer:

   Code using APIKeyHeader and Security dependency correctly. -> Option A

4. Quick Check:

   Security dependency with APIKeyHeader = from fastapi import Depends, Security from fastapi.security import APIKeyHeader api_key_header = APIKeyHeader(name="Authorization") @app.get("/secure") async def secure_route(api_key: str = Security(api_key_header)): return {"key": api_key} [OK]

Hint: Look for APIKeyHeader and Security usage together [OK]

Common Mistakes:

• Using Depends with a string instead of a dependency
• Missing APIKeyHeader import or usage
• Not using Security for header token checks

3. Given this FastAPI route, what will be the response if the client sends a request without the required API key header?

from fastapi import FastAPI, Security
from fastapi.security import APIKeyHeader

app = FastAPI()
api_key_header = APIKeyHeader(name="X-API-Key")

@app.get("/data")
async def get_data(api_key: str = Security(api_key_header)):
    return {"message": "Access granted", "key": api_key}

medium

A. HTTP 404 Not Found error

B. {"message": "Access granted", "key": "some_key"}

C. HTTP 403 Forbidden error

D. {"message": "Access denied"}

Solution

1. Step 1: Understand APIKeyHeader behavior

   APIKeyHeader raises a 403 error if the required header is missing in the request.

2. Step 2: Analyze the route response

   The route returns data only if the API key header is present; otherwise, FastAPI returns 403 Forbidden automatically.

3. Final Answer:

   HTTP 403 Forbidden error -> Option C

4. Quick Check:

   Missing API key header = 403 error [OK]

Hint: Missing API key header causes 403 error in FastAPI [OK]

Common Mistakes:

• Expecting 404 error instead of 403
• Assuming a custom message is returned automatically
• Thinking the route runs without the header

4. Identify the error in this FastAPI security code snippet:

from fastapi import FastAPI, Security
from fastapi.security import APIKeyHeader

app = FastAPI()
api_key_header = APIKeyHeader(name="Authorization")

@app.get("/secure")
async def secure_route(api_key: str = Depends(api_key_header)):
    return {"key": api_key}

medium

A. Function should not be async

B. Missing import of Depends

C. APIKeyHeader name should be "X-API-Key"

D. Using Depends instead of Security for APIKeyHeader dependency

Solution

1. Step 1: Check for import errors

   The code uses 'Depends(api_key_header)' but 'Depends' is not imported. Only FastAPI and Security are imported from fastapi.

2. Step 2: Confirm dependency usage is otherwise correct

   Using Depends with APIKeyHeader is valid; adding 'from fastapi import Depends' would fix it. Header name and async are fine.

3. Final Answer:

   Missing import of Depends -> Option B

4. Quick Check:

   Missing Depends import causes NameError [OK]

Hint: Always import Depends for FastAPI dependencies [OK]

Common Mistakes:

• Confusing Depends and Security usage
• Thinking header name must be fixed
• Believing async is not allowed

5. You want to protect a FastAPI endpoint so only users with a valid token can access it. Which approach best combines security and user trust?

hard

A. Use FastAPI's Security dependency to check tokens and return 403 if invalid, ensuring data is safe.

B. Allow all requests but log invalid tokens for later review.

C. Return data without checks but encrypt the response payload.

D. Use a custom header but do not verify its value.

Solution

1. Step 1: Identify secure token checking method

   FastAPI's Security dependency allows automatic token validation and blocks unauthorized access.

2. Step 2: Understand impact on user trust

   Blocking invalid tokens protects data and builds trust by preventing leaks or misuse.

3. Final Answer:

   Use FastAPI's Security dependency to check tokens and return 403 if invalid, ensuring data is safe. -> Option A

4. Quick Check:

   Security dependency + token check = safe and trusted API [OK]

Hint: Check tokens with Security to block unauthorized users [OK]

Common Mistakes:

• Allowing all requests without validation
• Relying only on encryption without access control
• Not verifying header values properly