PING903.CRED

NAME
DESCRIPTION
SEE ALSO
COPYRIGHT

---

NAME

ping903.cred - Credentials storage for ping903

DESCRIPTION

The file .ping903.conf located in the user home directory contains credentials for accessing various URLs handled by the ping903 server.

The file is organized as a sequence of definitions, which consist of four fields separated by any amount of whitespace. Initial and trailing whitespace is ignored. Any field containing whitespace characters on its own must be enclosed in double quotes. Double-quotes and backslashes appearing within quoted strings must be escaped by prefixing them with a backslash.

Empty lines and lines beginning with a hash sign are ignored.

Each definition consists of the following four fields:

SERVER REALM USER PASSWORD

Their meaning is as follows:

SERVER

Specifies the server to which this entry applies. It consists of the server IP address or DNS name, optionally followed by a colon and port number. A wildcard character * can be used in place of the either part, in which case this part will match any IP (or port).

If a DNS name is used, it will be resolved.

This field corresponds to the listen statement in ping903.conf.

	REALM		Name of the authentication realm. This corresponds to the fifth parameter of the auth statement in ping903.conf.
	USER		Authorization user name.

PASSWORD

User password.

When the server requests authorization, the client program (ping903q) will scan the ~/.ping903.cred file for an entry with the SERVER matching the IP and port of the server (as configured by the listen statement in the /etc/ping903.conf file) and the REALM filed matching the authorization realm presented by the server. If such an entry is found, the client will re-submit the request using the USER and PASSWORD for authorization.

SEE ALSO

ping903(8), ping903.conf(5), ping903q(1).

COPYRIGHT

Copyright © 2020 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

---