EncycloShare
Overview
This will describe all that is the EncycloShare product to enable anyone with a Wordpress install to become a publisher of content in the Encyclosphere. The plugin is available for installation on the WordPress plugin directory.
Goals
The main deliverable of a plugin/theme is a button that:
- Accepts a blog post or page
- ensures the user has supplied the relevant data needed for a complete ZWI file
- prepares a ZWI file
- out of the contents of the page and data drawn from the database as needed
- ensures the user has a DID
- signs the ZWI file
- with the DID (published DID:PSQR plugin for WP April 2022)
- pushes the signed ZWI file to the user's choice to either EncycloReader or EncycloSearch, or both,
- allowing the user to specify new aggregators
- receives back and displays to the user
- an acknowledgment/receipt from the aggregator.
- toggle a switch that always submits new updates to the aggregator(s).
Flow
Consensus is that encyclosphere content is signed by publishers, in which case the keypair (private and public keys) will both be on the web server, just as SSL cert keypairs are stored on web servers.
Here's some technical detail about keypair management from conversation in the meeting right now.
Signing content for the encyclosphere happens on a local system, not a web server. Treat DID private keys like SSH private keys. You push the signed content to the web server. Local, as in a computer sitting in a home office that is not a web server. Do not store the DID private key on a web server. That's what makes it different from SSL. For SSL, the server must have the private key to sign the secure sessions. As @Christian Gribneau points out, SSL also has a third-party verification mechanism. SSL is hosted because the certificates are signed by trusted third parites vouching for the web servers who use SSL certs.
Need a decision for what the standard for the encyclosphere identity is to be: publisher domain plus article name or hash of the whole article URL
@Henry Sanger will write it up in Markdown on nc.encyclosphere.org; leaning toward technical meeting to decide
Links
- ZWI plugin: https://www.dokuwiki.org/plugin:zwidoku
- ZWI file
- doku
plugin info
DID
The DID spec is here:did core The result of a valid signature is as follows.