SSL protocol and cipher configuration in Nginx - Mini Project: Build & Apply

SSL Protocol and Cipher Configuration in Nginx

📖 Scenario: You are setting up a secure web server using Nginx. To protect your website and users, you need to configure SSL protocols and ciphers properly. This ensures encrypted communication and prevents weak security settings.

🎯 Goal: Configure Nginx to use only secure SSL protocols and strong cipher suites for HTTPS connections.

📋 What You'll Learn

Create an Nginx server block configuration with SSL enabled

Set the SSL protocols to only TLSv1.2 and TLSv1.3

Configure the SSL cipher suites to use strong ciphers only

Enable SSL session cache and set session timeout

Print the final SSL configuration block

💡 Why This Matters

🌍 Real World

Web servers use SSL/TLS protocols and cipher suites to secure data between users and servers. Proper configuration prevents attackers from intercepting or tampering with data.

💼 Career

DevOps engineers and system administrators must configure SSL settings in web servers like Nginx to ensure secure communication and compliance with security standards.

1

Create basic Nginx server block with SSL

Create a variable called nginx_config and assign a string that contains a basic Nginx server block with SSL enabled. Include listen 443 ssl; and placeholders for ssl_certificate and ssl_certificate_key directives.

Nginx

# Your code here

Hint

Define a string variable named nginx_config with the server block text including SSL listen and certificate lines.

2

Add SSL protocol configuration

Add a line to the nginx_config string to set ssl_protocols TLSv1.2 TLSv1.3; inside the server block to allow only TLS version 1.2 and 1.3.

Nginx

nginx_config = '''server {
    listen 443 ssl;
    server_name example.com;

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

    # Add ssl_protocols line below

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

Hint

Insert the line ssl_protocols TLSv1.2 TLSv1.3; inside the server block.

3

Configure strong SSL cipher suites

Add a line to the nginx_config string to set ssl_ciphers with the value 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384' inside the server block. Also add ssl_prefer_server_ciphers on; to prefer server ciphers.

Nginx

nginx_config = '''server {
    listen 443 ssl;
    server_name example.com;

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

    ssl_protocols TLSv1.2 TLSv1.3;

    # Add ssl_ciphers and ssl_prefer_server_ciphers lines below

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

Hint

Add the ssl_ciphers line with the specified cipher string and ssl_prefer_server_ciphers on; inside the server block.

4

Enable SSL session cache and print configuration

Add lines to the nginx_config string to enable SSL session cache with ssl_session_cache shared:SSL:10m; and set session timeout with ssl_session_timeout 10m; inside the server block. Then print the full nginx_config string.

Nginx

nginx_config = '''server {
    listen 443 ssl;
    server_name example.com;

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

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers on;

    # Add ssl_session_cache and ssl_session_timeout lines below

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

# Print the nginx_config below
# Your code here

Hint

Add the SSL session cache and timeout lines inside the server block. Then use print(nginx_config) to display the full configuration.

Practice

1. What is the purpose of the ssl_protocols directive in an nginx configuration?

easy

A. To specify which SSL/TLS protocol versions are allowed for secure connections

B. To define the encryption algorithms used for data compression

C. To set the maximum size of SSL certificates

D. To enable HTTP/2 support over SSL

Solution

1. Step 1: Understand the role of ssl_protocols

   The ssl_protocols directive controls which SSL/TLS versions nginx will accept for secure connections.

2. Step 2: Compare options with this role

   Only To specify which SSL/TLS protocol versions are allowed for secure connections correctly describes this purpose; others mention unrelated features like compression or HTTP/2.

3. Final Answer:

   To specify which SSL/TLS protocol versions are allowed for secure connections -> Option A

4. Quick Check:

   ssl_protocols = Allowed SSL/TLS versions [OK]

Hint: ssl_protocols controls TLS versions allowed [OK]

Common Mistakes:

• Confusing ssl_protocols with cipher settings
• Thinking ssl_protocols sets certificate size
• Assuming ssl_protocols enables HTTP/2

2. Which of the following is the correct syntax to enable only TLSv1.2 and TLSv1.3 in nginx?

easy

A. ssl_protocols tlsv12 tlsv13;

B. ssl_protocols tls1.2 tls1.3;

C. ssl_protocols TLSv1.2 TLSv1.3;

D. ssl_protocols TLS1_2 TLS1_3;

Solution

1. Step 1: Recall correct nginx ssl_protocols syntax

   The correct syntax uses capitalized TLS versions separated by spaces, ending with a semicolon, e.g., ssl_protocols TLSv1.2 TLSv1.3;.

2. Step 2: Check each option's format

   ssl_protocols TLSv1.2 TLSv1.3; matches the correct syntax exactly. Options A, B, and C use incorrect casing or underscores, which nginx does not accept.

3. Final Answer:

   ssl_protocols TLSv1.2 TLSv1.3; -> Option C

4. Quick Check:

   Correct syntax = ssl_protocols TLSv1.2 TLSv1.3; [OK]

Hint: Use exact case: TLSv1.2 TLSv1.3 with spaces [OK]

Common Mistakes:

• Using lowercase letters for TLS versions
• Replacing dots with underscores
• Missing semicolon at the end

3. Given this nginx snippet:

ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;

What effect does ssl_prefer_server_ciphers on; have during SSL handshake?

medium

A. Client chooses the cipher from its list ignoring server preference

B. SSL handshake fails if client and server ciphers differ

C. Cipher selection is random between client and server lists

D. Server forces selection of its preferred cipher from the client's list

Solution

1. Step 1: Understand ssl_prefer_server_ciphers directive

   When set to on, nginx forces the server's cipher preference to override the client's during SSL handshake.

2. Step 2: Analyze options

   Server forces selection of its preferred cipher from the client's list correctly states the server enforces its cipher choice from the client's offered list. Client chooses the cipher from its list ignoring server preference is the opposite. Cipher selection is random between client and server lists is incorrect as selection is not random. SSL handshake fails if client and server ciphers differ is false; handshake does not fail just because of differing preferences.

3. Final Answer:

   Server forces selection of its preferred cipher from the client's list -> Option D

4. Quick Check:

   ssl_prefer_server_ciphers on = Server cipher priority [OK]

Hint: ssl_prefer_server_ciphers on means server picks cipher [OK]

Common Mistakes:

• Thinking client always chooses cipher
• Assuming random cipher selection
• Believing handshake fails on cipher mismatch

4. You configured nginx with:

ssl_protocols TLSv1.2 TLSv1.3
ssl_ciphers HIGH:!aNULL:!MD5
ssl_prefer_server_ciphers on;

But nginx fails to start. What is the likely cause?

medium

A. Missing semicolons at the end of directives

B. Using unsupported TLS versions

C. Incorrect cipher string syntax

D. ssl_prefer_server_ciphers must be off

Solution

1. Step 1: Check syntax of nginx directives

   Each directive must end with a semicolon. The given config lines miss semicolons at the end.

2. Step 2: Validate other options

   TLS versions and cipher strings are valid. ssl_prefer_server_ciphers can be on. So the syntax error (missing semicolons) causes nginx to fail.

3. Final Answer:

   Missing semicolons at the end of directives -> Option A

4. Quick Check:

   Missing semicolons cause config errors [OK]

Hint: Always end nginx directives with semicolon [OK]

Common Mistakes:

• Ignoring semicolon syntax errors
• Assuming TLS versions are unsupported
• Thinking ssl_prefer_server_ciphers must be off

5. You want to configure nginx to only allow TLSv1.3 and use strong ciphers, but also ensure clients that do not support TLSv1.3 can still connect securely using TLSv1.2. Which configuration snippet achieves this best?

hard

A. ssl_protocols TLSv1.3;
ssl_ciphers TLS_AES_256_GCM_SHA384;
ssl_prefer_server_ciphers on;

B. ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers TLS_AES_256_GCM_SHA384:HIGH:!aNULL;
ssl_prefer_server_ciphers on;

C. ssl_protocols TLSv1.2;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers off;

D. ssl_protocols TLSv1.3 TLSv1.1;
ssl_ciphers HIGH:!aNULL;
ssl_prefer_server_ciphers on;

Solution

1. Step 1: Identify required TLS versions

   We want to allow TLSv1.3 and TLSv1.2 to support clients without TLSv1.3.

2. Step 2: Check cipher configuration

   ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers TLS_AES_256_GCM_SHA384:HIGH:!aNULL; ssl_prefer_server_ciphers on; includes TLS_AES_256_GCM_SHA384 (a strong TLSv1.3 cipher) plus HIGH strength ciphers for TLSv1.2, with server cipher preference enabled.

3. Step 3: Validate other options

   ssl_protocols TLSv1.3; ssl_ciphers TLS_AES_256_GCM_SHA384; ssl_prefer_server_ciphers on; excludes TLSv1.2, blocking older clients. ssl_protocols TLSv1.2; ssl_ciphers HIGH:!aNULL:!MD5; ssl_prefer_server_ciphers off; excludes TLSv1.3. ssl_protocols TLSv1.3 TLSv1.1; ssl_ciphers HIGH:!aNULL; ssl_prefer_server_ciphers on; includes insecure TLSv1.1, which is deprecated.

4. Final Answer:

   ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers TLS_AES_256_GCM_SHA384:HIGH:!aNULL; ssl_prefer_server_ciphers on; -> Option B

5. Quick Check:

   Allow TLSv1.2 and TLSv1.3 with strong ciphers = ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers TLS_AES_256_GCM_SHA384:HIGH:!aNULL; ssl_prefer_server_ciphers on; [OK]

Hint: Include TLSv1.2 and TLSv1.3 with strong ciphers [OK]

Common Mistakes:

• Excluding TLSv1.2 and blocking older clients
• Including deprecated TLS versions like TLSv1.1
• Not combining strong ciphers for both TLS versions