GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MONKEYSPHERE (7)

NAME

monkeysphere - ssh and TLS authentication framework using OpenPGP Web of Trust

CONTENTS

Description
Identity Certifiers
Key Acceptability
Host Identification
Author
See Also

DESCRIPTION

Monkeysphere is a framework to leverage the OpenPGP web of trust for OpenSSH and TLS key-based authentication. OpenPGP keys are tracked via GnuPG, and added to the authorized_keys and known_hosts files used by OpenSSH for connection authentication. Monkeysphere can also be used by a validation agent to validate TLS connections (e.g. https).

IDENTITY CERTIFIERS

Each host that uses the Monkeysphere to authenticate its remote users needs some way to determine that those users are who they claim to be. SSH permits key-based authentication, but we want instead to bind authenticators to human-comprehensible user identities. This switch from raw keys to User IDs makes it possible for administrators to see intuitively who has access to an account, and it also enables end users to transition keys (and revoke compromised ones) automatically across all Monkeysphere-enabled hosts. The User IDs and certifications that the Monkeysphere relies on are found in the OpenPGP Web of Trust.

However, in order to establish this binding, each host must know whose cerifications to trust. Someone who a host trusts to certify User Identities is called an Identity Certifier. A host must have at least one Identity Certifier in order to bind User IDs to keys. Commonly, every ID Certifier would be trusted by the host to fully identify any User ID, but more nuanced approaches are possible as well. For example, a given host could specify a dozen ID certifiers, but assign them all "marginal" trust. Then any given User ID would need to be certified in the OpenPGP Web of Trust by at least three of those certifiers.

It is also possible to limit the scope of trust for a given ID Certifier to a particular domain. That is, a host can be configured to fully (or marginally) trust a particular ID Certifier only when they certify identities within, say, example.org (based on the e-mail address in the User ID).

KEY ACCEPTABILITY

The monkeysphere commands work from a set of user IDs to determine acceptable keys for ssh and TLS authentication. OpenPGP keys are considered acceptable if the following criteria are met:
capability
  The key must have the ‘authentication’ (‘a’) usage flag set.
validity
  The key itself must be valid, i.e. it must be well-formed, not expired, and not revoked.
certification
  The relevant user ID must be signed by a trusted identity certifier.

HOST IDENTIFICATION

The OpenPGP keys for hosts have associated ‘service names‘ (OpenPGP user IDs) that are based on URI specifications for the service. Some examples:
ssh: ssh://host.example.com[:port]
https: https://host.example.com[:port]

AUTHOR

Written by: Jameson Rollins <jrollins@finestructure.net>, Daniel Kahn Gillmor <dkg@fifthhorseman.net>

SEE ALSO

monkeysphere(1), monkeysphere-host(8), monkeysphere-authentication(8), openpgp2ssh(1), pem2openpgp(1), gpg(1), http://tools.ietf.org/html/rfc4880, ssh(1), http://tools.ietf.org/wg/secsh/draft-ietf-secsh-scp-sftp-ssh-uri/

Search for    or go to Top of page |  Section 7 |  Main Index


monkeysphere MONKEYSPHERE (7) March 2010

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.