Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
alert-triangle

GitHub Action

SSL/TLS Monitor

1.1.5

SSL/TLS Monitor

alert-triangle

SSL/TLS Monitor

Monitor SSL/TLS certificates for your domains

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: SSL/TLS Monitor

              
  uses: zrosenbauer/[email protected]
Learn more about this action in zrosenbauer/tls-monitor

Choose a version

SSL/TLS Monitor

CI CodeQL js-semistandard-style

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

name: SSL/TLS Monitor 
on:
  schedule:
    - cron: "0 16 * * *"

jobs:
  monitor:
    name: SSL/TLS Monitor
    runs-on: ubuntu-latest
    steps:
      - name: Monitor
        uses: bluenovaio/action-tls-monitor@main
        with: 
          domain: bluenova.io
          expiration_days: 30
          approved_protocols: TLSv1.2,TLSv1.3
          alert_method: slack
          alert_token: ${{ secrets.SLACK_WEBHOOK_URL }}

Multiple Domains

name: SSL/TLS Monitor 
on:
  schedule:
    - cron: "0 16 * * *"

jobs:
  monitor:
    name: SSL/TLS Monitor
    runs-on: ubuntu-latest
    strategy:
      matrix:
        domain:
          - bluenova.io
          - docs.bluenova.io
    steps:
      - name: Monitor - ${{ matrix.domain }}
        uses: bluenovaio/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