Reputation Provider-Client protocol - Revision history

Henryk: /* getReputation */

2006-06-19T04:25:09Z

getReputation

Henryk: /* submitReputation */

2006-06-12T08:47:14Z

submitReputation

@@ Line 200: / Line 200: @@
 ! style="text-align: right; width: 1em;" | pos.:
 | <code><var>reputation</var></code>: The reputation as a floating point number string.
 |- style="vertical-align: top;"
 ! style="text-align: right; width: 1em;" | neg.:

Henryk: /* getReputation */

2006-06-12T06:23:20Z

getReputation

@@ Line 179: / Line 179: @@
 ! 409
 | The ObjectKey is already assigned to an AuthorTag (for another user).
 |}
 |}

Henryk: /* createAuthorTag */

2006-06-12T01:52:42Z

createAuthorTag

← Older revision		Revision as of 01:52, 12 June 2006
Line 168:		Line 168:
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| Description:		! style="text-align: right;" \| Description:
	\| colspan="2" \| Creates an AuthorTag for the given ObjectKey. An AuthorTag is represented as an XML snippet of the following form: <code><AuthorTag ObjectKey="<var>ObjectKey</var>" UserPseudonym="<var>UserPseudonym</var>" signature="<var>signature</var>" /></code>, where <code><var>UserPseudonym</var></code> is an opaque identifier consisting of hexadecimal characters and <code><var>signature</var></code> is a PKCS#1 SHA-1 RSA signature over <code><var>ObjectKey</var>?<var>UserPseudonym</var></code>.		\| colspan="2" \| Creates an AuthorTag for the given ObjectKey. An AuthorTag is represented as an XML snippet of the following form: <code><AuthorTag ObjectKey="<var>ObjectKey</var>" UserPseudonym="<var>UserPseudonym</var>" signature="<var>signature</var>" /></code>, where <code><var>UserPseudonym</var></code> is an opaque identifier consisting of hexadecimal characters and <code><var>signature</var></code> is a BASE64 PKCS#1 SHA-1 RSA signature over <code><var>ObjectKey</var>?<var>UserPseudonym</var></code>.
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" rowspan="2" \| Response:		! style="text-align: right;" rowspan="2" \| Response:

Henryk: /* createAuthorTag */

2006-06-12T01:51:09Z

createAuthorTag

← Older revision		Revision as of 01:51, 12 June 2006
Line 168:		Line 168:
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| Description:		! style="text-align: right;" \| Description:
			\| colspan="2" \| Creates an AuthorTag for the given ObjectKey. An AuthorTag is represented as an XML snippet of the following form: <code><AuthorTag ObjectKey="<var>ObjectKey</var>" UserPseudonym="<var>UserPseudonym</var>" signature="<var>signature</var>" /></code>, where <code><var>UserPseudonym</var></code> is an opaque identifier consisting of hexadecimal characters and <code><var>signature</var></code> is a PKCS#1 SHA-1 RSA signature over <code><var>ObjectKey</var>?<var>UserPseudonym</var></code>.
	\| colspan="2" \| Creates an AuthorTag for the given ObjectKey.
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" rowspan="2" \| Response:		! style="text-align: right;" rowspan="2" \| Response:

Henryk: /* List of Commands / typo in / authenticate /, new / createAuthorTag */

2006-06-12T01:09:00Z

List of Commands: typo in authenticate: , new createAuthorTag

@@ Line 90: / Line 90: @@
 |- style="vertical-align: top;"
 ! style="text-align: right;" | Synopsis:
-| colspan="2" | <code>challenge <var>response_value</var></code><br/>&#8594; <code><var>welcome_message</var></code>
+| colspan="2" | <code>authenticate <var>response_value</var></code><br/>&#8594; <code><var>welcome_message</var></code>
 |- style="vertical-align: top;"
 ! style="text-align: right;" | Arguments:
@@ Line 153: / Line 153: @@
 ! style="text-align: right; width: 1em;" | neg.:
 | none
 |}

Henryk: /* create */

2006-06-12T00:49:08Z

create

← Older revision		Revision as of 00:49, 12 June 2006
Line 116:		Line 116:
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| Arguments:		! style="text-align: right;" \| Arguments:
	\| colspan="2" \| <code><var>pubkey</var></code>: The client's public key, BASE64 encoded.		\| colspan="2" \| <code><var>pubkey</var></code>: The client's public key, BASE64 encoded DER encoded RSA key.
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| State:		! style="text-align: right;" \| State:

Henryk: /* Keys */ errm, that should have been DER

2006-06-12T00:47:39Z

Keys: errm, that should have been DER

← Older revision		Revision as of 00:47, 12 June 2006
Line 82:		Line 82:

	=== Keys ===		=== Keys ===
	For the time being the keys used are RSA keys (to be used with OpenSSL via [http://sandbox.rulemaker.net/ngps/m2/ M2Crypto]). A public key (<code><var>pubkey</var></code>) in this protocol is expressed as a base64 encoded string that is the ~~BER~~ encoded representation of the public key. A signature is a base64 encoded string representation of a PKCS#1 signature with SHA-1 as hash.		For the time being the keys used are RSA keys (to be used with OpenSSL via [http://sandbox.rulemaker.net/ngps/m2/ M2Crypto]). A public key (<code><var>pubkey</var></code>) in this protocol is expressed as a base64 encoded string that is the DER encoded representation of the public key. A signature is a base64 encoded string representation of a PKCS#1 signature with SHA-1 as hash.

	=== List of Commands ===		=== List of Commands ===

Henryk: /* Keys */ move from ad-hoc crypto to proper BER and PKCS#1

2006-06-12T00:47:09Z

Keys: move from ad-hoc crypto to proper BER and PKCS#1

← Older revision		Revision as of 00:47, 12 June 2006
Line 82:		Line 82:

	=== Keys ===		=== Keys ===
	For the time being the keys used are RSA keys (to be used with [http://~~www~~.~~amk~~.ca/~~python~~/~~writing~~/~~pycrypt/pycrypt.html#SECTION000600000000000000000~~ ~~Crypto.PublicKey~~]~~.RSA~~). A public key (<code><var>pubkey</var></code>) in this protocol is expressed as a base64 encoded string ~~<code><var>n</var>;<var>e</var></code>~~ ~~where~~ ~~<code><var>n</var></code>~~ ~~and~~ ~~<code><var>e</var></code>~~ ~~are~~ ~~long integers to~~ the ~~base~~ 10. A signature is a base64 encoded string representation of a ~~long~~ ~~integer~~ to ~~the~~ ~~base~~ 10.		For the time being the keys used are RSA keys (to be used with OpenSSL via [http://sandbox.rulemaker.net/ngps/m2/ M2Crypto]). A public key (<code><var>pubkey</var></code>) in this protocol is expressed as a base64 encoded string that is the BER encoded representation of the public key. A signature is a base64 encoded string representation of a PKCS#1 signature with SHA-1 as hash.

	=== List of Commands ===		=== List of Commands ===

Henryk: /* Keys */

2006-05-14T03:29:54Z

Keys

← Older revision		Revision as of 03:29, 14 May 2006
Line 82:		Line 82:

	=== Keys ===		=== Keys ===
	For the time being the keys used are RSA keys (to be used with [http://www.amk.ca/python/writing/pycrypt/pycrypt.html#SECTION000600000000000000000 Crypto.PublicKey].RSA). A public key or pubkey in this protocol is expressed as a base64 encoded string <code><var>n</var>;<var>e</var></code> where <code><var>n</var></code> and <code><var>e</var></code> are long integers to the base 10. A signature is a base64 encoded string representation of a long integer to the base 10.		For the time being the keys used are RSA keys (to be used with [http://www.amk.ca/python/writing/pycrypt/pycrypt.html#SECTION000600000000000000000 Crypto.PublicKey].RSA). A public key (<code><var>pubkey</var></code>) in this protocol is expressed as a base64 encoded string <code><var>n</var>;<var>e</var></code> where <code><var>n</var></code> and <code><var>e</var></code> are long integers to the base 10. A signature is a base64 encoded string representation of a long integer to the base 10.

	=== List of Commands ===		=== List of Commands ===

← Older revision		Revision as of 04:25, 19 June 2006
Line 186:		Line 186:
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| Synopsis:		! style="text-align: right;" \| Synopsis:
	\| colspan="2" \| <code>getReputation <var>~~AuthorTag~~</var></code><br/>→ <code><var>~~reputation~~</var></code>		\| colspan="2" \| <code>getReputation <var>AuthorTagOrTags</var></code><br/>→ <code><var>reputations</var></code>
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| Arguments:		! style="text-align: right;" \| Arguments:
	\| colspan="2" \| <code><var>~~AuthorTag~~</var></code>: The AuthorTag that the reputation should be retrieved for.		\| colspan="2" \| <code><var>AuthorTagOrTags</var></code>: The AuthorTag or concatenation of AuthorTags that the reputation should be retrieved for.
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| State:		! style="text-align: right;" \| State:
Line 195:		Line 195:
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" \| Description:		! style="text-align: right;" \| Description:
	\| colspan="2" \| Retrieves the reputation from an ~~AuthorTag~~ as returned by createAuthorTag.		\| colspan="2" \| Retrieves the reputation from a list of AuthorTags as returned by createAuthorTag.
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right;" rowspan="2" \| Response:		! style="text-align: right;" rowspan="2" \| Response:
	! style="text-align: right; width: 1em;" \| pos.:		! style="text-align: right; width: 1em;" \| pos.:
	\| <code><var>reputation</var></code>: The reputation as a floating point number string.		\| <code><var>reputation</var></code>: The reputation as a floating point number string. If multiple AuthorTags were requested then the response will be multiple floating point numers separated by spaces.
	\|- style="vertical-align: top;"		\|- style="vertical-align: top;"
	! style="text-align: right; width: 1em;" \| neg.:		! style="text-align: right; width: 1em;" \| neg.:
	\|		\|
	{\|		{\|
	! 403		! 403
Line 210:		Line 210:
	\| The AuthorTag is not assigned to a reputation value on this Reputation Provider.		\| The AuthorTag is not assigned to a reputation value on this Reputation Provider.
	\|}		\|}
			Warning: This command will return a negative response if any of the AuthorTag queries fails. If more than one AuthorTag was requested and the command fails then it's not possible to tell which of the queries succeeded and which failed (and with which error code). In the error case you might want to retry with one query per AuthorTag to sort this out.
	\|}		\|}

Reputation Provider-Client protocol - Revision history

Henryk: /* getReputation */

Henryk: /* submitReputation */

Henryk: /* getReputation */

Henryk: /* createAuthorTag */

Henryk: /* createAuthorTag */

Henryk: /* List of Commands */ typo in /* authenticate */, new /* createAuthorTag */

Henryk: /* create */

Henryk: /* Keys */ errm, that should have been DER

Henryk: /* Keys */ move from ad-hoc crypto to proper BER and PKCS#1

Henryk: /* Keys */

Henryk: /* List of Commands / typo in / authenticate /, new / createAuthorTag */