= 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 !PyCrypto package and also uses the !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.pl 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'' button in the lower right corner. You can now enter all your secrets. ACL's are entered as comma separated usernames. == Recent Changes == [[ChangeLog(gringottsplugin, 3)]] == Author/Contributors == '''Author:''' [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).