[[PageOutline(2-5,Contents,pullout)]] = Gringotts Plugin for Trac = == Description == Gringotts is the name of the bank in the Harry Potter books and is also the name of a GTK-based application for storing sensitive information (e.g. passwords, files, etc.) in an encrypted form. This Trac plugin adds a semi-secure area for storing such information. It is essentially a mini-wiki which has an ACL (Access Control List) associated with the content. Everything stored in the database is encrypted with a 2048 key that is automatically generated when you install this plugin for the first time. The key is kept in the trac.ini file – make sure you take a backup as if the key is lost, then so is the data kept in Gringotts! This plugin requires the [http://www.amk.ca/python/code/crypto PyCrypto] package and also uses the [http://www.freenet.org.nz/ezPyCrypto/ ezPyCrypto] wrapper. Have fun. == Bugs/Feature Requests == Existing bugs and feature requests for GringottsPlugin are [report:9?COMPONENT=GringottsPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=GringottsPlugin&owner=coling new ticket]. == Download == Download the zipped source from [download:gringottsplugin here]. == Source == You can check out GringottsPlugin from [http://trac-hacks.org/svn/gringottsplugin here] using Subversion, or [source:gringottsplugin browse the source] with Trac. == Install == The simplest way to install is to [download:gringottsplugin download] the zipped source, unzip it into the directory of your choice (/tmp or such), and run {{{ python setup.py bdist_egg }}} from the 0.10 directory - if you're using Trac version 0.10 or 0.11 if you're using Trac version 0.11, followed by: {{{ easy_install dist/gringotts-0.1-py2.4.egg }}} (or such if your egg differs in name) Next you'll have to enable the Gringotts plugin in the trac.ini, like so: {{{ [components] gringotts.* = enabled }}} If this is your first installation of Gringotts you'll need to upgrade your trac project, to update the database schema and generate the private key: {{{ trac-admin /path/to/your/project upgrade }}} For more information on plugin instalation visit the documentation outlined in [http://trac.edgewall.org/wiki/TracPlugins TracPlugins]. == Example == You can either use the list of Gringotts as your main interface (it adds a navigation item), or you can use the Macro {{{[[Gringott(NameOfGringlet)]]}}} where every wiki syntax is supported. To create a new Gringlet click on the ''create'' link in the lower right corner of the box that just appeared. You can now enter all your secrets. ACL's are entered as comma or space separated usernames. == Recent Changes == [[ChangeLog(gringottsplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:coling] [[BR]] '''Maintainer:''' [wiki:coling] [[BR]] '''Contributors:''' Hello Colin, following-up to our discussion on #trac... If you're feeling adventurous, you can check out the trac:browser:sandbox/context-refactoring branch and apply the following patch: http://trac.edgewall.org/attachment/wiki/ChristianBoos/is_member_of I'd be glad if that would be working for your Gringott's plugin (note that the patch is untested, there might be one or two things to fix).