From 064962ff82701d9d415a351a91354a0cdf949bd5 Mon Sep 17 00:00:00 2001 From: friendica Date: Fri, 14 Feb 2014 12:25:27 -0800 Subject: doc and assets update. There is what seems to be a controversial powerpoint in this checkin. The powerpoint is of course *open source* even if powerpoint itself is not. The source file is available for your examination and revision. --- doc/html/post_8php.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'doc/html/post_8php.html') diff --git a/doc/html/post_8php.html b/doc/html/post_8php.html index ca5ac2fb3..0c0745a3a 100644 --- a/doc/html/post_8php.html +++ b/doc/html/post_8php.html @@ -162,8 +162,8 @@ Functions

post_post(&$a) zot communications and messaging

Sender HTTP posts to this endpoint ($site/post typically) with 'data' parameter set to json zot message packet. This packet is optionally encrypted, which we will discover if the json has an 'iv' element. $contents => array( 'alg' => 'aes256cbc', 'iv' => initialisation vector, 'key' => decryption key, 'data' => encrypted data); $contents->iv and $contents->key are random strings encrypted with this site's RSA public key and then base64url encoded. Currently only 'aes256cbc' is used, but this is extensible should that algorithm prove inadequate.

Once decrypted, one will find the normal json_encoded zot message packet.

-

Defined packet types are: notify, purge, refresh, auth_check, ping, and pickup

-

Standard packet: (used by notify, purge, refresh, and auth_check)

+

Defined packet types are: notify, purge, refresh, force_refresh, auth_check, ping, and pickup

+

Standard packet: (used by notify, purge, refresh, force_refresh, and auth_check)

{ "type": "notify", "sender":{ "guid":"kgVFf_1...", "guid_sig":"PT9-TApzp...", "url":"http:\/\/podunk.edu", "url_sig":"T8Bp7j5...", }, "recipients": { optional recipient array }, "callback":"\/post", "version":1, "secret":"1eaa...", "secret_sig": "df89025470fac8..." }

Signature fields are all signed with the sender channel private key and base64url encoded. Recipients are arrays of guid and guid_sig, which were previously signed with the recipients private key and base64url encoded and later obtained via channel discovery. Absence of recipients indicates a public message or visible to all potential listeners on this site.

"pickup" packet: The pickup packet is sent in response to a notify packet from another site

-- cgit v1.2.3