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

= Cryptography for Trac =

== Description ==

CryptoPlugin supports cryptographically backed functions in Trac.

This is [wiki:CryptoPlugin/Dev WiP] and in a very early stage. Nevertheless testers are very welcome.

Why? Privacy offered based on these functions is much different compared to other privacy-related plugins, and
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.

While Trac plugins other than CryptoPlugin (incomplete list follows)
 * PrivateTicketsPlugin (ticket-only)
 * PrivateWikiPlugin (wiki-only)
 * SensitiveTicketsPlugin (ticket-only)
attempt to protect only some part ('realm') of Trac's content, they do not differentiate in terms of protection strength, so they're rated together for simplicity here.

Ultimate privacy doesn't assume any trust outside of Trac system software (plugins included). This kind of inherit Trac content protection is neither available nor planned yet.

So you have to decide now, if the available protection is enough for your data. 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 
[http://trac-hacks.org/newticket?component=CryptoPlugin&owner=hasienda new ticket].

== Download ==

Download the zipped source 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.

== Example ==




== Recent Changes ==

[[ChangeLog(cryptoplugin, 3)]]

== Author/Contributors ==

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