Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wille-io/deno-acme
Get certificates for your domains and subdomains via http or dns challenges from an acme server.
https://github.com/wille-io/deno-acme
acme acme-client acme-dns acme-http acme-v2 cloudflare cloudflare-dns cloudflare-dns-api cloudflare-dns-challenge deno dns-01 dns-01-acme-challenge dns-01-challenge http-01 https tls tls-certificate tls-certificates
Last synced: 4 months ago
JSON representation
Get certificates for your domains and subdomains via http or dns challenges from an acme server.
- Host: GitHub
- URL: https://github.com/wille-io/deno-acme
- Owner: wille-io
- License: mit
- Created: 2023-07-04T12:47:57.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-04T20:55:19.000Z (4 months ago)
- Last Synced: 2024-10-19T03:23:38.001Z (4 months ago)
- Topics: acme, acme-client, acme-dns, acme-http, acme-v2, cloudflare, cloudflare-dns, cloudflare-dns-api, cloudflare-dns-challenge, deno, dns-01, dns-01-acme-challenge, dns-01-challenge, http-01, https, tls, tls-certificate, tls-certificates
- Language: TypeScript
- Homepage: https://deno.land/x/acme
- Size: 77.1 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# deno-acme
[](https://deno.land/x/acme)
Get certificates for your domains and or your domains their subdomains from an acme server.
Supports http-01 challenges and dns-01 challenges with domains hosted with Cloudflare's DNS server.
Use the CLI as a standalone acme client, or use the acme.ts library to use it in your own application.
## Prerequisites for HTTP challenge
- Port 80 needs to be available on the maschine running the acme cli or ...
- (optional) Port 80 needs to be forwarded to the maschine running the acme cli
- The requested domain name(s) need to point the IP address of the maschine running the acme cli
## Prerequisites for Cloudflare DNS challenge
- Domain and / or subdomain(s) with nameservers pointing to Cloudflare
- Cloudflare API token with edit privileges for the given domain(s) / subdomain(s) DNS zone
## CLI
How to get & use the CLI:
```bash
sudo deno install -A --name acme --root /usr/local/ https://deno.land/x/[email protected]/cli.ts
# http challenge:
sudo acme http example.com,subdomain.example.com
# cloudflare dns challenge:
acme cloudflare example.com,subdomain.example.com
```
Note: For http challenges permissions to bind to port 80 are needed. Otherwise use the root user or use `sudo` - like in the example above.
## Library
To use acme as a library in your application, add the following (minimal example with temporary & anonymous acme account creation):
```typescript
import * as ACME from "https://deno.land/x/[email protected]/acme.ts"
// http challenge:
const { domainCertificates } = await ACME.getCertificatesWithHttp("example.com");
console.log(domainCertificates);
// cloudflare dns challenge:
const cloudflareToken = Deno.env.get("CLOUDFLARE_TOKEN");
const { domainCertificates } = await ACME.getCertificatesWithCloudflare(cloudflareToken, "example.com");
console.log(domainCertificates);
```
## License
MIT