[[PageOutline(2-5,Contents,pullout)]]

= Cryptography for Trac

== Description

This plugin supports cryptographically backed functions in Trac. The level of privacy offered based on these functions is different compared to other privacy-related plugins:
 * PrivateTicketsPlugin (ticket-only)
 * PrivateWikiPlugin (wiki-only)
 * SensitiveTicketsPlugin (ticket-only)

These plugins attempt to protect only some part ('realm') of Trac's content, they do not differentiate in terms of protection strength.

This is [wiki:CryptoPlugin/Dev WiP] and in a very early stage. Nevertheless testers are very welcome. Reports about your expectations as well as your findings will help them mature and match your needs.

Tab.: Privacy offered by a Trac system depending on setup and user action
||installation||Trac, no plugins||||other plugins installed||||||||!CryptoPlugin installed||
||modules state||enabled||disabled||enabled||disabled||disabled||enabled||enabled||
||session setting (per user)|| n. a.|| n. a.|| n. a.||Trusted server||Trusted client||Trusted server||Trusted client||
||||||||||||||||||
{{{#!tr
  {{{#!td
signed content
  }}}
  {{{#!td
n. a.
  }}}
  {{{#!td
n. a.
  }}}
  {{{#!td
n. a.
  }}}
  {{{#!td
    {{{#!div style="background-color:orange"
weak
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:orange"
weak
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:orange"
weak
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:orange"
weak
    }}}
  }}}
}}}
{{{#!tr
  {{{#!td
secured content
  }}}
  {{{#!td
n. a.
  }}}
  {{{#!td
    {{{#!div style="background-color:red"
none
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:lightblue"
strong
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:lightblue"
strong
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:yellow"
very strong
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:lightblue"
strong
    }}}
  }}}
  {{{#!td
    {{{#!div style="background-color:yellow"
very strong
    }}}
  }}}
}}}
						
 Privacy strength rating legend:
{{{#!div style="background-color:none"
 n.'' ''a.::
}}}
 not applicable
{{{#!div style="background-color:red"
 none::
}}}
 no protection, not counting read-only wiki pages for (very weak) privacy
{{{#!div style="background-color:orange"
 weak::
}}}
 prevents unrecognized content change without read-protection
{{{#!div style="background-color:lightblue"
 strong::
}}}
 depending on server security of Trac system software (plugins included) and storage for Trac content and private user keys
{{{#!div style="background-color:yellow"
 very strong::
}}}
 depending on client security for private user key storage
{{{#!div style="background-color:lightgreen"
 ultimate::
}}}
 independent of client and server security for private user key storage

Regular content is accessible as per applicable TracPermissions settings, and users can save content without additional protection regardless of other options, if available at all. Since it is the same for any setup, it's not worth mentioning this type of content in the table above.

Ultimate privacy doesn't assume any trust outside of the Trac system software, and this includes plugins. This kind of inherent Trac content protection is neither available nor planned yet.

Likely there are not many web services that grant at least strong protection without installation of special software at client side. And if so, they certainly do not offer Trac's documentation and bug-tracking capabilities.

== Bugs/Feature Requests

Existing bugs and feature requests for CryptoPlugin are 
[report:9?COMPONENT=CryptoPlugin here].

If you have any issues, create a 
[/newticket?component=CryptoPlugin new ticket].

[[TicketQuery(component=CryptoPlugin,group=type,format=progress)]]

== Download

Download the complete, zipped source (all branches) from [export:cryptoplugin here].

== Source

You can check out CryptoPlugin from [/svn/cryptoplugin here] using Subversion, or [source:cryptoplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(cryptoplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:hasienda] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''