{"id":27088958,"url":"https://github.com/devops-works/docker-certspotter","last_synced_at":"2025-04-06T06:36:47.572Z","repository":{"id":98718563,"uuid":"157223857","full_name":"devops-works/docker-certspotter","owner":"devops-works","description":"This is an (unofficial) image for SSLMate/certspotter (https://github.com/SSLMate/certspotter)","archived":false,"fork":false,"pushed_at":"2024-04-28T22:31:18.000Z","size":7,"stargazers_count":9,"open_issues_count":0,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-28T23:27:37.996Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devops-works.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-12T14:12:31.000Z","updated_at":"2024-04-28T22:31:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"fc309d7d-829c-4c28-89a0-cdd278035fd9","html_url":"https://github.com/devops-works/docker-certspotter","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fdocker-certspotter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fdocker-certspotter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fdocker-certspotter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fdocker-certspotter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devops-works","download_url":"https://codeload.github.com/devops-works/docker-certspotter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247445686,"owners_count":20939953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-06T06:36:45.644Z","updated_at":"2025-04-06T06:36:47.561Z","avatar_url":"https://github.com/devops-works.png","language":"Shell","readme":"# certspotter Docker image\n\nThis is an (unofficial) image for\n[SSLMate/certspotter](https://github.com/SSLMate/certspotter), a Certificate\nTransparency Log Monitor.\n\nIt will warn you in slack when a new certificate is found in the [CT\nlogs](https://www.certificate-transparency.org/).\n\n## Usage\n\n### Using this image\n\n```bash\ndocker run -d --name certspotter \\\n    -e CS_DELAY=43200 \\\n    -e CS_DOMAINS=\".everything.org www.specific.org\" \\\n    -e CS_SLACK_URL=https://hooks.slack.com/services/SOME/SLACK/TOKEN \\\n    -e CS_DEBUG=1 \\\n    devopsworks/certspotter\n```\n\n#### Environment variables\n\n| Variable       | Description                                  | Default           |\n| -------------- | -------------------------------------------- | ----------------- |\n| `CS_DELAY`     | Interval between `certspotter` runs          | 86400 (1 day)     |\n| `CS_DOMAINS`   | Domains to watch for                         | none (compulsory) |\n| `CS_SLACK_URL` | Slack URL for notifications                  | none              |\n| `CS_DEBUG`     | Sets `certspotter` \u0026 scripts in verbose mode | \"\"                |\n\n### Additionnal notification hooks\n\nThe image will execute any script present in `/certspotter/hooks.d/` and passes\na message as the first argument.\n\nHooks will be called:\n\n- when the container starts\n- when a new certificate is found for the watched domains\n\n#### Example\n\n```bash\nmkdir hooks.d/\ncat \u003e hooks.d/url.sh\u003c\u003cEOF\n#!/bin/bash\n\necho -e \"${1}\\n\" | curl -sXPOST http://some.url/seen --data @-\nEOF\nchmod +x hooks.d/url.sh\ndocker run -d --name certspotter \\\n    -v $(pwd)/hooks.d/:/certspotter/hooks.d/ \\\n    -e CS_DELAY=43200 \\\n    -e CS_DOMAINS=\".everything.org www.specific.org\" \\\n    -e CS_SLACK_URL=https://hooks.slack.com/services/SOME/SLACK/TOKEN \\\n    -e CS_DEBUG=1 \\\n    devopsworks/certspotter\n```\n\n### Building your own\n\n```bash\ndocker build . -t some/tag\n```\n\n## Caveats\n\n`DNS_DOMAINS` and `-script` are not used since I could not make them work using\ndocker. Debugging required...\n\n## Licence","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevops-works%2Fdocker-certspotter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevops-works%2Fdocker-certspotter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevops-works%2Fdocker-certspotter/lists"}