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

= Cryptography for Trac

== Description

CryptoPlugin supports cryptographically backed functions in Trac.
The level of privacy offered based on these functions is much 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, plugins included. This kind of inherit 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

Total issues by status:
 [[TicketQuery(component=CryptoPlugin,format=progress)]]

Open issues by type:
 [[TicketQuery(component=CryptoPlugin,status!=closed&group=type,format=progress)]]

If you have any issue that is not found in [query:?component=CryptoPlugin&order=priority existing tickets], create a 
[http://trac-hacks.org/newticket?component=CryptoPlugin&owner=hasienda new ticket], please.

== Download

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

== Source

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

== Examples

TODO

== Recent Changes

[[ChangeLog(cryptoplugin, 3)]]
See [log:/cryptoplugin more].

== Author/Contributors ==

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