From f370d9dab062fa3bfa127e003365fd9602bd9379 Mon Sep 17 00:00:00 2001 From: Daniel Kahn Gillmor Date: Mon, 8 Mar 2010 23:33:58 -0500 Subject: [PATCH] more readme updates --- README => msva.protocol.README | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) rename README => msva.protocol.README (67%) diff --git a/README b/msva.protocol.README similarity index 67% rename from README rename to msva.protocol.README index d0c54cf..5e699d2 100644 --- a/README +++ b/msva.protocol.README @@ -6,8 +6,8 @@ msva is the Monkeysphere Validation Agent. Its goal is to simplify bindings between cryptographic tokens and the real-world entities that humans actually care about. -In its current technical conception, the validation agent is a minimal -HTTP server that accepts two different requests: +In its current form, the validation agent is conceived of as a +minimalistic HTTP server that accepts two different requests: GET / -- initial contact query, protocol version compatibility. (no query parameters) @@ -17,14 +17,19 @@ POST /reviewcert -- request validation of a certificate (query parameters: uid, context, pkc) (returns: valid, message) -query parameters are posted as a JSON string (*not* as www-form-encoded). +Query parameters are posted as a JSON blob (*not* as +www-form-encoded). -the variables that are returned are application/json as well. +The variables that are returned are application/json as well. (PKC means: public key carrier: raw key, OpenPGP cert, or X.509 cert) (UID means: User ID (like in OpenPGP)) (context means: (this is too vague right now) something like "this certificate was used to try to identify an HTTPS server") + +Full details on the Monkeysphere Validation Agent protocol should be +available at http://web.monkeysphere.info/validation-agent/protocol + Authors: Daniel Kahn Gillmor Matthew James Goins Jameson Rollins -- 2.26.2