https://github.com/zrosenbauer/tls-monitor

GitHub Action to monitor TLS certificates.
https://github.com/zrosenbauer/tls-monitor

action gh-action gh-actions ssl ssl-monitor ssl-monitoring

Last synced: 6 months ago
JSON representation

GitHub Action to monitor TLS certificates.

• Host: GitHub
• URL: https://github.com/zrosenbauer/tls-monitor
• Owner: zrosenbauer
• License: mit
• Created: 2021-04-11T03:51:01.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-04-14T16:34:46.000Z (6 months ago)
• Last Synced: 2025-04-15T04:57:18.744Z (6 months ago)
• Topics: action, gh-action, gh-actions, ssl, ssl-monitor, ssl-monitoring
• Language: JavaScript
• Homepage:
• Size: 80 MB
• Stars: 12
• Watchers: 2
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

          


    


        

    

    




> Monitor your certificates!

# Overview

[![CI](https://github.com/zrosenbauer/tls-monitor/actions/workflows/ci.yaml/badge.svg)](https://github.com/zrosenbauer/tls-monitor/actions/workflows/ci.yaml)

[![CodeQL](https://github.com/zrosenbauer/tls-monitor/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/zrosenbauer/tls-monitor/actions/workflows/codeql-analysis.yml)

[![Formatted with Biome](https://img.shields.io/badge/Formatted_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev/)

[![Linted with Biome](https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev)

Monitor SSL/TLS certificates for your domains.

## Usage

You can run against a single domain or use the matrix strategy to run against multiple domains.

### Single Domain

```yaml

name: SSL/TLS Monitor

on:

  schedule:

    - cron: '0 16 * * *'

jobs:

  monitor:

    name: SSL/TLS Monitor

    runs-on: ubuntu-latest

    steps:

      - name: Monitor

        uses: zrosenbauer/action-tls-monitor@main

        with:

          domain: joggr.io

          expiration_days: 30

          approved_protocols: TLSv1.2,TLSv1.3

          alert_method: slack

          alert_token: ${{ secrets.SLACK_WEBHOOK_URL }}

```

#### Multiple Domains

```yaml

name: SSL/TLS Monitor

on:

  schedule:

    - cron: '0 16 * * *'

jobs:

  monitor:

    name: SSL/TLS Monitor

    runs-on: ubuntu-latest

    strategy:

      matrix:

        domain:

          - joggr.io

          - docs.joggr.io

    steps:

      - name: Monitor - ${{ matrix.domain }}

        uses: zrosenbauer/action-tls-monitor@main

        with:

          domain: ${{ matrix.domain }}

          expiration_days: 30

          approved_protocols: TLSv1.2,TLSv1.3

          alert_method: slack

          alert_token: ${{ secrets.SLACK_WEBHOOK_URL }}

```

## Alerting

Alerting is built in to this action. It is also possible to ignore the alerts and use the outputs to send your own alerts or do

another action (i.e. trigger a certificate update/renewal).

### Slack Alerts

Slack is supported out of the box. The alerts are formatted and have a default emoji and name. You should start to see alerts

similar to the below image if an issue is found.

Slack Alert Example

![Slack Alert](/docs/images/alert-slack.png)











      
Sponsorship

      Special thanks to: