This replaces the: Original DokuCrypt2 Plugin.

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Note: Plugin is now maintained by Thomas Schäfer. — Thomas Schäfer 2025-10-15 15:06

dokucrypt is a client side (javascript) cryptography plugin. This plugins allows a user to store and access sensitive data in a dokuwiki. All sensitive data is encrypted before it is submitted and decrypted on the clients machine. A users' sensitive data will only be accessible when viewed with a javascript enabled browser and the proper pass phrase. It will never be transmitted or stored in plain text, and you will avoid having passwords and sensitive data stored in plain text on the server.

The Javascrypt (http://www.fourmilab.ch/javascrypt/) library is used for encryption and decryption to provide 256 Bit AES encryption.

Warning: This plugin should not replace a password manager or peer reviewed cryptography tools for high-priority use. Do not store mission critical type data with this plugin - I cannot be sure that the info is not cached by DokuWiki or the web browser. — sherri 2020-10-14 19:55

This plugin is provided without warranty or guarantee of any kind. Use at your own discretion. — Thomas Schäfer 2025-10-15 15:06

• 2025-10-15: Release of dokucrypt3, which has originally been an internal fork of dokucrypt2 with massive changes to the way encryption is handled. The resulting pull request would not be merged into the base repository (due to maintenance effort). So a new github repository `dokucrypt3` was created based on dokucrypt2 and the new encryption engine.

In order to encrypt some sensitive data, the user needs to add text like the following

Hi world.  I have a secret.  Can you read it?
<SECRET>I like ice cream.</SECRET>

When the user hits 'Save' (or a draft is attempted to be saved) a prompt will open, asking the user to enter a pass phrase key for the encryption. Once supplied, the encryption will be done in the browser and the encrypted text submitted to the server.

The less-than (<) and greater-than(>) symbols, if included in the enclosed text to encrypt, will break the decryption and cause some content to not be shown. To enter these characters in your content to be encrypted, use their HTML entity equivalents:

• < = Use: <
• > = Use: >

When the page is viewed, the user will see the encrypted text and a link 'Decrypt Encrypted Text' will appear which will prompt the user for a password and decrypt the text (see the example below).

The encrypted text is compatible with javascrypt decryption (http://www.fourmilab.ch/javascrypt/jscrypt.html).

To edit the encrypted data, the user needs to Edit the wiki page. When first loaded, encrypted text will appear encrypted, surrounded by <ENCRYPTED> and </ENCRYPTED> tags. To edit this text, the user needs to press the 'DecryptSecret' button between 'Save' and 'Preview', and supply the correct pass phrase. The encrypted text will be decrypted to the 'SECRET' form showed above, and the use can edit in plaintext. Submits or drafts will be encrypted before submission with the same pass phrase supplied.

This plugin includes configuration settings.

• copytoclipboard - If set to true, the plugin tries to copy the decrypted value to the clipboard.
• hidepasswordoncopytoclipboard - If set to true, the decrypted value will not be shown after being copied to the clipboard (see option 'copytoclipboard').

• May not work if the website including plugin control text is being translated into another language.
• Conflicts with Encrypted Passwords plugin (both plugins attempt to parse the <encrypted></encrypted> tag). — Fumigator2 2024-03-12 02:41

Please use the GitHub Issues page.

Please use the Issues page on GitHub.