summaryrefslogtreecommitdiff
path: root/man/man7
diff options
context:
space:
mode:
authorDaniel Kahn Gillmor <dkg@fifthhorseman.net>2008-09-04 22:29:39 -0400
committerDaniel Kahn Gillmor <dkg@fifthhorseman.net>2008-09-04 22:29:39 -0400
commit91f880160dba51966ca8940fd42fcd6c8a268c5a (patch)
tree18fb1789faf7f4611ab122062597ac78ca2f0d3e /man/man7
parent268c67329e37e7e480cadc31a02aa0ba6f308840 (diff)
moved monkeysphere(5) to section 7 of the manual. Thanks, Stew!
Diffstat (limited to 'man/man7')
-rw-r--r--man/man7/monkeysphere.754
1 files changed, 54 insertions, 0 deletions
diff --git a/man/man7/monkeysphere.7 b/man/man7/monkeysphere.7
new file mode 100644
index 0000000..8d7c43a
--- /dev/null
+++ b/man/man7/monkeysphere.7
@@ -0,0 +1,54 @@
+.TH MONKEYSPHERE "7" "June 2008" "monkeysphere" "System Frameworks"
+
+.SH NAME
+
+monkeysphere \- ssh authentication framework using OpenPGP Web of
+Trust
+
+.SH DESCRIPTION
+
+\fBMonkeySphere\fP is a framework to leverage the OpenPGP Web of Trust
+for ssh authentication. OpenPGP keys are tracked via GnuPG, and added
+to the authorized_keys and known_hosts files used by ssh for
+connection authentication.
+
+.SH IDENTITY CERTIFIERS
+
+FIXME: describe identity certifier concept
+
+.SH KEY ACCEPTABILITY
+
+During known_host and authorized_keys updates, the monkeysphere
+commands work from a set of user IDs to determine acceptable keys for
+ssh authentication. OpenPGP keys are considered acceptable if the
+following criteria are met:
+.TP
+.B capability
+The key must have the "authentication" ("a") usage flag set.
+.TP
+.B validity
+The key itself must be valid, i.e. it must be well-formed, not
+expired, and not revoked.
+.TP
+.B certification
+The relevant user ID must be signed by a trusted identity certifier.
+
+.SH HOST IDENTIFICATION
+
+The OpenPGP keys for hosts have associated user IDs that use the ssh
+URI specification for the host, i.e. "ssh://host.full.domain[:port]".
+
+.SH AUTHOR
+
+Written by Jameson Rollins <jrollins@fifthhorseman.net>, Daniel Kahn
+Gillmor <dkg@fifthhorseman.net>
+
+.SH SEE ALSO
+
+.BR monkeysphere (1),
+.BR monkeysphere-server (8),
+.BR monkeysphere-ssh-proxycommand (1),
+.BR gpg (1),
+.BR ssh (1),
+.BR http://tools.ietf.org/html/rfc4880,
+.BR http://tools.ietf.org/wg/secsh/draft-ietf-secsh-scp-sftp-ssh-uri/