otp-tokend

Name

otp-tokend -- Deliver tokens via SMTP(S) or HTTP(S).

Synopsis

otp-tokend [-?Dv] [-b bind-path] [-f from-address] [-s subject] [-S smtp_url] [-P pidfile] [-H httl_url]

DESCRIPTION

The otp-tokend daemon processes send-token requests from the Unix domain socket /var/run/otp-tokend. Tokens are then delivered to the end-user via SMTP, SMTPS, HTTP, or HTTPS. Delivery through SMS or other out of band mechanisms can be implemented with a HTTPS back end.

Otplib will optionally generate a send-token request when the user record has the send-token flag and location information set. This can be done with otp-control.

The send-token request is a single datagram with the following ASCII fields separated by newlines:

service
username
location
token

If the location (destination to send the token) is all digits the request is sent via HTTP(S). A request with the @ symbol is sent via SMTP(S). All other requests are ignored.

OPTIONS

-b, --bind-path= bind_path

Listen for send-token requests from an alternate Unix domain socket.

-D, --disable-daemon-mode

Disable daemon mode. When specified otp-tokend will not run in the background and stdout is available for debugging information.

-f, --from-address= from_address

Specify the e-mail from address when using SMTP(S).

-s, --subject= subject

Specify the e-mail subject when using SMTP(S).

-s, --smtp-url= smtp_url

Specify the URL to an SMTP(S) server. Example smtp://127.0.0.1.

-P, --pidfile= pid_file

Specify an alternate location for a file containing the process ID of the otp-tokend server.

-H, --http-url= http_url

Specify the URL to an HTTP(S) server. A form will be posted to the url with the form "to" set to the location, and "msg" set to the token.

-v, --verbose

Increase verbosity. Can be used multiple times.

--version

Display software version.

EXAMPLES

Start the otp-tokend server in the foreground with verbose output using https://127.0.0.1:443/sms for HTTP and and smtp://127.0.0.1 for SMTP requests. 

otp-tokend -D -vvv -S smtp://127.0.0.1 -H https://127.0.0.1:443/sms

AUTHOR

Mark Fullmer

SEE ALSO

otp-control(1) otp-sca(1) otp-sct(1) pam_otp(1) htsoft-downloader(1) bcload(1) otp-ov-plugin(1) spyrus-par2(7)