From 31a3d0506a701fa1878f22cf4127721c01a88c76 Mon Sep 17 00:00:00 2001 From: Daniel Kahn Gillmor Date: Mon, 8 Mar 2010 23:27:45 -0500 Subject: [PATCH] updated README --- README | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/README b/README index e85b1c1..d0c54cf 100644 --- a/README +++ b/README @@ -6,13 +6,18 @@ 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, is a minimal HTTP server that -accepts two requests: +In its current technical conception, the validation agent is a minimal +HTTP server that accepts two different requests: -POST /reviewcert (vars: uid, context, pkc) -POST /extracerts (vars: certificates) +GET / -- initial contact query, protocol version compatibility. + (no query parameters) + (returns: protoversion, server, available) -the variables that are posted are posted in a JSON string (*not* as www-form-encoded). +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). the variables that are returned are application/json as well. @@ -20,7 +25,6 @@ the variables that are returned are application/json as well. (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") - Authors: Daniel Kahn Gillmor Matthew James Goins Jameson Rollins -- 2.26.2