OCSP stapling in Nginx - Mini Project: Build & Apply

Enable OCSP Stapling in Nginx

📖 Scenario: You manage a website using Nginx as the web server. To improve your website's security and speed, you want to enable OCSP stapling. This helps browsers quickly check if your SSL certificate is valid without contacting the certificate authority every time.

🎯 Goal: Configure Nginx to enable OCSP stapling for your SSL-enabled website.

📋 What You'll Learn

Create a basic Nginx server block with SSL enabled

Add configuration directives to enable OCSP stapling

Reload Nginx to apply the changes

Verify that OCSP stapling is enabled

💡 Why This Matters

🌍 Real World

OCSP stapling improves website security and speeds up SSL certificate validation by reducing the need for browsers to contact certificate authorities directly.

💼 Career

Knowing how to enable and verify OCSP stapling is important for DevOps engineers and system administrators managing secure web servers.

1

Create a basic Nginx server block with SSL

Create a file called default.conf with a server block listening on port 443. Use ssl_certificate set to /etc/ssl/certs/example.crt and ssl_certificate_key set to /etc/ssl/private/example.key. Include listen 443 ssl; inside the server block.

Nginx

# Your code here

Hint

Use listen 443 ssl; to enable SSL on port 443. Specify the certificate and key paths exactly as given.

2

Add OCSP stapling configuration directives

Inside the existing server block, add the directives ssl_stapling on; and ssl_stapling_verify on;. Also add resolver 8.8.8.8 8.8.4.4 valid=300s; and resolver_timeout 5s; to enable OCSP stapling and DNS resolution.

Nginx

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /etc/ssl/certs/example.crt;
    ssl_certificate_key /etc/ssl/private/example.key;

    # Add OCSP stapling directives below
    # Your code here

    location / {
        root /var/www/html;
        index index.html;
    }
}

Hint

Add the four directives exactly as shown inside the server block to enable OCSP stapling.

3

Reload Nginx to apply the configuration

Run the command sudo nginx -t to test the configuration syntax. Then run sudo systemctl reload nginx to reload Nginx with the new settings.

Nginx

# Run the following commands in the terminal:
# sudo nginx -t
# sudo systemctl reload nginx

Hint

First test the config with sudo nginx -t. If it says syntax is ok, reload Nginx with sudo systemctl reload nginx.

4

Verify OCSP stapling is enabled

Run the command openssl s_client -connect example.com:443 -status and check the output for the line OCSP response: successful to confirm OCSP stapling is working.

Nginx

# Run the command below in the terminal to verify OCSP stapling
# Your code here

Hint

Use openssl s_client -connect example.com:443 -status and look for OCSP response: successful in the output.

Practice

1. What is the main purpose of enabling OCSP stapling in nginx?

easy

A. To encrypt the website traffic with a stronger cipher

B. To block unauthorized IP addresses automatically

C. To speed up HTTPS by caching the certificate status

D. To compress website content for faster loading

Solution

1. Step 1: Understand OCSP stapling concept

   OCSP stapling allows the server to cache the certificate status from the certificate authority, reducing the need for clients to query it directly.

2. Step 2: Identify the main benefit in nginx

   This caching speeds up HTTPS connections by reducing latency and improving performance.

3. Final Answer:

   To speed up HTTPS by caching the certificate status -> Option C

4. Quick Check:

   OCSP stapling = speed up HTTPS [OK]

Hint: OCSP stapling caches cert status to speed HTTPS [OK]

Common Mistakes:

• Confusing OCSP stapling with encryption methods
• Thinking it blocks IP addresses
• Assuming it compresses website content

2. Which of the following is the correct nginx directive to enable OCSP stapling?

easy

A. ssl_ocsp on;

B. ssl_stapling_enable true;

C. ssl_ocsp_stapling enable;

D. ssl_stapling on;

Solution

1. Step 1: Recall nginx directive syntax for OCSP stapling

   The correct directive to enable OCSP stapling in nginx is ssl_stapling on;.

2. Step 2: Check each option for syntax correctness

   Options A, B, and C use incorrect directive names or syntax.

3. Final Answer:

   ssl_stapling on; -> Option D

4. Quick Check:

   Enable OCSP stapling with ssl_stapling on; [OK]

Hint: Use ssl_stapling on; to enable OCSP stapling [OK]

Common Mistakes:

• Using incorrect directive names like ssl_ocsp
• Adding extra words like _enable or enable
• Using true/false instead of on/off

3. Given this nginx snippet, what will happen if ssl_stapling is enabled but resolver is not set?

server {
  listen 443 ssl;
  ssl_certificate /etc/ssl/cert.pem;
  ssl_certificate_key /etc/ssl/key.pem;
  ssl_stapling on;
}

medium

A. nginx will log errors but continue running without stapling

B. nginx will fail to start due to missing resolver

C. OCSP stapling will be disabled silently

D. OCSP stapling will work normally without issues

Solution

1. Step 1: Understand resolver role in OCSP stapling

   nginx needs a DNS resolver configured to fetch OCSP responses from the certificate authority.

2. Step 2: Analyze behavior without resolver

   If no resolver is set, nginx cannot fetch OCSP responses, so it logs errors but continues running without stapling.

3. Final Answer:

   nginx will log errors but continue running without stapling -> Option A

4. Quick Check:

   Missing resolver = errors logged, no stapling [OK]

Hint: Missing resolver logs errors, disables stapling silently [OK]

Common Mistakes:

• Assuming nginx fails to start
• Thinking stapling works without resolver
• Believing stapling disables silently without logs

4. You enabled ssl_stapling on; and set a resolver, but nginx still does not staple OCSP responses. What is the most likely cause?

medium

A. The SSL certificate does not include the OCSP responder URL

B. The ssl_certificate_key file is missing

C. The server is listening on port 80 instead of 443

D. The ssl_protocols directive is missing

Solution

1. Step 1: Check prerequisites for OCSP stapling

   OCSP stapling requires the SSL certificate to include an OCSP responder URL to fetch status.

2. Step 2: Identify why stapling fails despite correct config

   If the certificate lacks the OCSP responder URL, nginx cannot get the status, so stapling fails.

3. Final Answer:

   The SSL certificate does not include the OCSP responder URL -> Option A

4. Quick Check:

   Missing OCSP URL in cert = stapling fails [OK]

Hint: Cert must have OCSP URL for stapling to work [OK]

Common Mistakes:

• Thinking missing key file causes stapling failure
• Confusing HTTP port with SSL port
• Assuming ssl_protocols affects stapling directly

5. You want to enable OCSP stapling in nginx with these requirements: - Use Google's public DNS resolver - Enable stapling - Ensure nginx reloads config safely Which configuration snippet correctly achieves this?

server {
  listen 443 ssl;
  ssl_certificate /etc/ssl/cert.pem;
  ssl_certificate_key /etc/ssl/key.pem;
  # Your config here
}

hard

A. resolver 8.8.8.8;
ssl_stapling off;
ssl_stapling_verify on;

B. resolver 8.8.8.8 8.8.4.4 valid=300s;
ssl_stapling on;
ssl_stapling_verify on;

C. ssl_stapling on;
ssl_stapling_verify off;
resolver 1.1.1.1;

D. resolver 8.8.8.8 8.8.4.4;
ssl_stapling on;
ssl_stapling_verify off;

Solution

1. Step 1: Set resolver with Google's DNS and validity

   Use resolver 8.8.8.8 8.8.4.4 valid=300s; to specify DNS servers and cache time.

2. Step 2: Enable OCSP stapling and verification

   Set ssl_stapling on; and ssl_stapling_verify on; to enable stapling and verify OCSP responses.

3. Step 3: Confirm safe reload

   After config changes, run nginx -t to test and nginx -s reload to reload safely.

4. Final Answer:

   resolver 8.8.8.8 8.8.4.4 valid=300s; ssl_stapling on; ssl_stapling_verify on; -> Option B

5. Quick Check:

   Correct resolver + stapling on + verify on = resolver 8.8.8.8 8.8.4.4 valid=300s; ssl_stapling on; ssl_stapling_verify on; [OK]

Hint: Use resolver with valid=, enable stapling and verify on [OK]

Common Mistakes:

• Forgetting ssl_stapling_verify on
• Using only one resolver without valid time
• Disabling stapling or verification accidentally