{"id":15404473,"url":"https://github.com/k1low/certman","last_synced_at":"2025-04-16T20:53:45.871Z","repository":{"id":62555457,"uuid":"85940084","full_name":"k1LoW/certman","owner":"k1LoW","description":"CLI tool for AWS Certificate Manager.","archived":false,"fork":false,"pushed_at":"2017-12-08T11:04:20.000Z","size":76,"stargazers_count":17,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T05:41:33.644Z","etag":null,"topics":["acm","aws"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/k1LoW.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-23T11:04:03.000Z","updated_at":"2021-10-01T22:37:44.000Z","dependencies_parsed_at":"2022-11-03T05:30:40.644Z","dependency_job_id":null,"html_url":"https://github.com/k1LoW/certman","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1LoW%2Fcertman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1LoW%2Fcertman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1LoW%2Fcertman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1LoW%2Fcertman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/k1LoW","download_url":"https://codeload.github.com/k1LoW/certman/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249275777,"owners_count":21242284,"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":["acm","aws"],"created_at":"2024-10-01T16:13:06.423Z","updated_at":"2025-04-16T20:53:45.853Z","avatar_url":"https://github.com/k1LoW.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Certman [![Gem](https://img.shields.io/gem/v/certman.svg)](https://rubygems.org/gems/certman) [![Travis](https://img.shields.io/travis/k1LoW/certman.svg)](https://travis-ci.org/k1LoW/certman)\n\nCLI tool for AWS Certificate Manager.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'certman'\n```\n\nAnd then execute:\n\n```sh\n$ bundle\n```\n\nOr install it yourself as:\n\n```sh\n$ gem install certman\n```\n\n## Usage\n\n### Request ACM Certificate with only AWS managed services\n\n```sh\n$ certman request blog.example.com\nNOTICE! Your selected region is *ap-northeast-1*. Certman will create a certificate on *ap-northeast-1*. OK? Yes\nNOTICE! Certman has chosen *us-east-1*  for S3/SES resources. OK? Yes\nNOTICE! When requesting, Certman appends a Receipt Rule to the current Active Receipt Rule Set. OK? Yes\n[✔] [ACM] Check Certificate (us-east-1) (successful)\n[✔] [Route53] Check Hosted Zone (us-east-1) (successful)\n[✔] [Route53] Check TXT Record (us-east-1) (successful)\n[✔] [Route53] Check MX Record (us-east-1) (successful)\n[✔] [SES] Check Active Rule Set (us-east-1) (successful)\n[✔] [S3] Create Bucket for SES inbound (us-east-1) (successful)\n[✔] [SES] Create Domain Identity (us-east-1) (successful)\n[✔] [Route53] Create TXT Record Set to verify Domain Identity (us-east-1) (successful)\n[✔] [SES] Check Domain Identity Status *verified* (us-east-1) (successful)\n[✔] [Route53] Create MX Record Set (us-east-1) (successful)\n[✔] [SES] Create and Active Receipt Rule Set (us-east-1) (successful)\n[✔] [SES] Create Receipt Rule (us-east-1) (successful)\n[✔] [ACM] Request Certificate (us-east-1) (successful)\n[✔] [S3] Check approval mail (will take about 30 min) (us-east-1) (successful)\n[✔] [SES] Delete Receipt Rule (us-east-1) (successful)\n[✔] [SES] Delete Receipt Rule Set (us-east-1) (successful)\n[✔] [Route53] Delete MX Record Set (us-east-1) (successful)\n[✔] [Route53] Delete TXT Record Set (us-east-1) (successful)\n[✔] [SES] Delete Verified Domain Identiry (us-east-1) (successful)\n[✔] [S3] Delete Bucket (us-east-1) (successful)\nDone.\n\ncertificate_arn: arn:aws:acm:ap-northeast-1:0123456789:certificate/123abcd4-5e67-8f90-123a-4567bc89d01\n```\n\nOR\n\n```sh\nNOTICE! Your selected region is *us-east-1*. Certman will create a certificate on *us-east-1*.\nNOTICE! Certman has chosen *us-east-1* for S3/SES resources.\nNOTICE! When requesting, Certman appends a Receipt Rule to the current Active Receipt Rule Set.\n[✖] [ACM] Check Certificate (us-east-1) (error)\n\nCertificate already exists!\n\ncertificate_arn: arn:aws:acm:us-east-1:0123456789:certificate/123abcd4-5e67-8f90-123a-4567bc89d01\n```\n\n#### Flags\n\n##### `--remain-resources`\nSkips deleting resources after a certificate has been successfully generated. This is necessary if you cannot use automatic validation (i.e., if your site is not accessible to the public internet via HTTPS). See [How Manual Domain Validation Works](http://docs.aws.amazon.com/acm/latest/userguide/how-domain-validation-works.html) for more information.\n\n##### `--non-interactive`\nSuppresses prompts from Certman (i.e, if using with a CI system, such as Travis or Jenkins).\n\n##### `--subject-alternative-names=www.test.example.com cert.test.example.com`\nOther domain names (separated by spaces) to associate with the requested certificate. Note that only the primary domain name is used for identification purposes and that AWS initially limits each certifcate to 10 SANs.\n\n##### `--hosted-zone=test.example.com`\nSpecify the name (not the ID) of the Route53 Hosted Zone where the DNS record sets Certman uses will be located. By default, Certman will use the apex domain (i.e. \"test.example.com\" will have a default hosted-zone of \"example.com\").\n\n### Restore Resources\n\nIf you want to restore resources generated for an ACM certificate (i.e., in order to receive approval mail again, use `certman restore-resources`. This supports the `--non-interactive` and `--hosted-zone` flags from `certman request`.\n\n```sh\n$ certman restore-resources blog.example.com\n```\n\n### Delete Certificate\n\n```sh\n$ certman delete blog.example.com\n[✔] [ACM] Delete Certificate (successful)\nDone.\n\n```\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk1low%2Fcertman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fk1low%2Fcertman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk1low%2Fcertman/lists"}