How to Create a Self-Signed Certificate with OpenSSL
Self-signed certificates are useful for development, testing, and internal services where a public CA is unnecessary. This guide walks through the specific troubleshooting steps to diagnose and resolve self-signed certificate creation issues.
Before You Begin
Before you begin, be sure to have the following in place:
- A Linux server with the relevant software installed
- Access to the command line interface
- Appropriate permissions (root or sudo)
Quick Fix
Wrong
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out cert.pem
Wrong: Self-signed cert without SAN extensions
Right
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out cert.pem -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost,DNS:*.local,IP:127.0.0.1"
Right: Self-signed cert with SANs for local development
Output
Certificate:\n Issuer: CN=localhost\n Subject: CN=localhost\n X509v3 Subject Alternative Name:\n DNS:localhost, DNS:*.local, IP:127.0.0.1
Prevention
To avoid future issues, follow these best practices:
- Always include SAN extensions -- browsers reject certificates without SAN
- Set an appropriate validity period -- 365 days for development certs
- Use different certificates for development, staging, and production
- Add the self-signed CA to your system trust store to avoid browser warnings
- Use openssl verify -CAfile ca.pem cert.pem to test the certificate chain
DodaTech Tools
For further assistance with any of the above issues, consider using DodaTech consulting services or DodaTech tutorials for more in-depth guidance.
Common Mistakes with self signed
- Mixing let bindings with <- bindings in do notation, producing type errors
- Overlapping type class instances that cause GHC to reject the program with ambiguous dispatch errors
- Non-exhaustive pattern matches that compile with warnings then crash at runtime
These mistakes appear frequently in real-world OPENSSL code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.
Practice Exercise
Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.
This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.
FAQ
Built by the developers of DodaTech
Doda Browser, DodaZIP & Durga Antivirus Pro