#summary Client-side certificate management for Prosody
#labels Stage-Alpha

= Introduction =
[http://xmpp.org/extensions/xep-0257.html XEP-0257] specifies a protocol for clients to store and manage client side certificates. When a client presents a stored client side certificate during the TLS handshake, it can log in without supplying a password (using SASL EXTERNAL). This makes it possible to have multiple devices accessing an account, without any of them needing to know the password, and makes it easier to revoke access for a single device.


= Details =

Each user can add their own certificates. These do not need to be signed by a trusted CA, yet they do need to be valid at the time of logging in and they should include an subjectAltName with otherName "id-on-xmppAddr" with the JID of the user.

= Configuration =

(None yet)

= Compatibility =

||0.9||Works||
||0.8||Untested. Probably doesn't.||

= Clients =

(None?)

= TODO =
Possible options to add to the configuration:
 * Require certificates to be signed by a trusted CA.
 * Do not require a  id-on-xmppAddr
 * Remove expired certs after a certain time
 * Limit the number of certificates per user