TiddlyWiki5/editions/tw5.com/tiddlers/mechanisms/EncryptionMechanism.tid

created: 201308251542
creator: JeremyRuston
modified: 201308251543
modifier: JeremyRuston
tags: mechanism
title: EncryptionMechanism

TiddlyWiki5 allows the entire content of a TiddlyWiki HTML file to be encrypted with the Stanford JavaScript Crypto Library. Opening an encrypted TiddlyWiki in the browser prompts for a password before decrypting and displaying the content.

For instructions on how to use TiddlyWiki5's encryption features, see [[How to use TiddlyWiki5 as a standalone HTML file with encryption]].

The EncryptionMechanism is implemented with the following elements:

* A crypto "password vault" within the BootMechanism that holds the current encryption password
* The ability of the BootMechanism to read a block of encrypted tiddlers from the TiddlyWiki file, to prompt the user for a password, and to decrypt the tiddlers
* Handlers for the messages SetPasswordMessage and ClearPasswordMessage that handle the user interface for password changes
* The `<$encrypt>` widget within the main file template that encrypts a filtered list of tiddlers with the currently held password
* The [[$:/isEncrypted]] tiddler that contains "yes" or "no" according to whether there is a password in the password vault
** The availability of this tiddler allows the RevealWidget to be used to selectively display user interface elements according to whether encryption is in force
* The [[$:/snippets/encryptionstatus]] snippet displays the current encryption status
Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00			`created: 201308251542`
			`creator: JeremyRuston`
			`modified: 201308251543`
			`modifier: JeremyRuston`
Get rid of the 'docs' tag It was unnecessary, since everything here is documentation 2013-08-25 20:41:00 +00:00			`tags: mechanism`
Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00			`title: EncryptionMechanism`
Restore encrypted TiddlyWiki support 2013-01-31 10:20:13 +00:00
			`TiddlyWiki5 allows the entire content of a TiddlyWiki HTML file to be encrypted with the Stanford JavaScript Crypto Library. Opening an encrypted TiddlyWiki in the browser prompts for a password before decrypting and displaying the content.`

Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00			`For instructions on how to use TiddlyWiki5's encryption features, see [[How to use TiddlyWiki5 as a standalone HTML file with encryption]].`

Restore encrypted TiddlyWiki support 2013-01-31 10:20:13 +00:00			`The EncryptionMechanism is implemented with the following elements:`

			`* A crypto "password vault" within the BootMechanism that holds the current encryption password`
			`* The ability of the BootMechanism to read a block of encrypted tiddlers from the TiddlyWiki file, to prompt the user for a password, and to decrypt the tiddlers`
			`* Handlers for the messages SetPasswordMessage and ClearPasswordMessage that handle the user interface for password changes`
			* The `<$encrypt>` widget within the main file template that encrypts a filtered list of tiddlers with the currently held password
			`* The [[$:/isEncrypted]] tiddler that contains "yes" or "no" according to whether there is a password in the password vault`
			`** The availability of this tiddler allows the RevealWidget to be used to selectively display user interface elements according to whether encryption is in force`
Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00			`* The [[$:/snippets/encryptionstatus]] snippet displays the current encryption status`