mirror of https://github.com/breard-r/acmed.git
Rodolphe Bréard
1 month ago
Failed to extract signature
1 changed files with 0 additions and 103 deletions
-
103man/en/tacd.8
@ -1,103 +0,0 @@ |
|||||
.\" Copyright (c) 2019-2020 Rodolphe Bréard <rodolphe@breard.tf> |
|
||||
.\" |
|
||||
.\" Copying and distribution of this file, with or without modification, |
|
||||
.\" are permitted in any medium without royalty provided the copyright |
|
||||
.\" notice and this notice are preserved. This file is offered as-is, |
|
||||
.\" without any warranty. |
|
||||
.Dd Dec 21, 2024 |
|
||||
.Dt TACD 8 |
|
||||
.Os |
|
||||
.Sh NAME |
|
||||
.Nm tacd |
|
||||
.Nd TLS-ALPN Challenge Daemon |
|
||||
.Sh SYNOPSIS |
|
||||
.Nm |
|
||||
.Op Fl e|--acme-ext Ar STRING |
|
||||
.Op Fl -acme-ext-file Ar FILE |
|
||||
.Op Fl -crt-digest Ar STRING |
|
||||
.Op Fl -crt-signature-alg Ar STRING |
|
||||
.Op Fl d|--domain Ar STRING |
|
||||
.Op Fl -domain-file Ar STRING |
|
||||
.Op Fl f|--foreground |
|
||||
.Op Fl h|--help |
|
||||
.Op Fl l|--listen Ar host:port |
|
||||
.Op Fl -log-stderr |
|
||||
.Op Fl -log-syslog |
|
||||
.Op Fl -log-level Ar LEVEL |
|
||||
.Op Fl -no-pid-file |
|
||||
.Op Fl -pid-file Ar FILE |
|
||||
.Op Fl V|--version |
|
||||
.Sh DESCRIPTION |
|
||||
.Nm |
|
||||
is a server that will listen to incoming Transport Layer Security |
|
||||
.Pq TLS |
|
||||
connections and, if the |
|
||||
.Em acme-tls/1 |
|
||||
protocol has been declared during the Application-Layer Protocol Negotiation |
|
||||
.Pq ALPN , |
|
||||
present a self-signed certificate in order to attempt to solve the TLS-ALPN-01 challenge. It then drops the connection. |
|
||||
.Pp |
|
||||
In order to generate the self-signed certificate, it is required to specify both the |
|
||||
.Em domain name |
|
||||
to validate and the |
|
||||
.Em acmeIdentifier extension . |
|
||||
If one of those values is not specified using the available options, it is read from the standard input. When reading from the standard input, a new line character is expected at the end. In the case both values needs to be read from the standard input, the |
|
||||
.Em domain name |
|
||||
is read first, then the |
|
||||
.Em acmeIdentifier extension . |
|
||||
.Pp |
|
||||
The options are as follows: |
|
||||
.Bl -tag |
|
||||
.It Fl e, -acme-ext Ar STRING |
|
||||
The acmeIdentifier extension to set in the self-signed certificate. |
|
||||
.It Fl -acme-ext-file Ar FILE |
|
||||
File from which is read the acmeIdentifier extension to set in the self-signed certificate. |
|
||||
.It Fl -crt-digest Ar STRING |
|
||||
Set the certificate's digest algorithm. Possible values are: |
|
||||
.Bl -dash -compact |
|
||||
.It |
|
||||
sha256 |
|
||||
.It |
|
||||
sha384 |
|
||||
.It |
|
||||
sha512 |
|
||||
.El |
|
||||
.It Fl -crt-signature-alg Ar STRING |
|
||||
Set the certificate's signature algorithm. Possible values depends on the cryptographic library support and can be listed using the |
|
||||
.Em --help |
|
||||
flag. |
|
||||
.It Fl d, -domain Ar STRING |
|
||||
The domain that is being validated. |
|
||||
.It Fl -domain-file Ar STRING |
|
||||
File from which is read the domain that is being validated. |
|
||||
.It Fl f, -foreground |
|
||||
Runs in the foreground. |
|
||||
.It Fl h, -help |
|
||||
Prints help information. |
|
||||
.It Fl i, -listen Ar host:port | unix:path |
|
||||
Specifies the host and port combination or the unix socket to listen on. |
|
||||
.It Fl -log-stderr |
|
||||
Prints log messages to the standard error output. |
|
||||
.It Fl -log-syslog |
|
||||
Sends log messages via syslog. |
|
||||
.It Fl -log-level Ar LEVEL |
|
||||
Specify the log level. Possible values: error, warn, info, debug and trace. |
|
||||
.It Fl -no-pid-file |
|
||||
Do not create any PID file |
|
||||
.It Fl -pid-file Ar FILE |
|
||||
Specifies the location of the PID file. |
|
||||
.It Fl V, -version |
|
||||
Prints version information. |
|
||||
.El |
|
||||
.Sh SEE ALSO |
|
||||
.Xr acmed.toml 5 |
|
||||
.Sh STANDARDS |
|
||||
.Rs |
|
||||
.%A R.B. Shoemaker |
|
||||
.%D February 2020 |
|
||||
.%R RFC 8737 |
|
||||
.%T Automated Certificate Management Environment (ACME) TLS Application-Layer Protocol Negotiation (ALPN) Challenge Extension |
|
||||
.Re |
|
||||
.Sh AUTHORS |
|
||||
.An Rodolphe Bréard |
|
||||
.Aq rodolphe@breard.tf |
|
Write
Preview
Loading…
Cancel
Save
Reference in new issue