databases/p5-DBIx-Safe/pkg-descr

   1 The purpose of DBIx::Safe is to give controlled, limited access to an
   2 application, rather than simply passing it a raw database handle through DBI.
   3 DBIx::Safe acts as a wrapper to the database, by only allowing through the
   4 commands you tell it to. It filters all things related to the database handle -
   5 methods and attributes.
   6
   7 The typical usage is for your application to create a database handle via a
   8 normal DBI call to new(), then pass that to DBIx::Safe->new(), which will return
   9 you a DBIx::Safe object. After specifying exactly what is and what is not
  10 allowed, you can pass the object to the untrusted application. The object will
  11 act very similar to a DBI database handle, and in most cases can be used
  12 interchangeably.
  13
  14 By default, nothing is allowed to run at all. There are many things you can
  15 control. You can specify which SQL commands are allowed, by indicating the first
  16 word in the SQL statement (e.g. 'SELECT'). You can specify which database
  17 methods are allowed to run (e.g. 'ping'). You can specify a regular expression
  18 that allows matching SQL statements to run (e.g. 'qr{SET TIMEZONE}'). You can
  19 specify a regular expression that is NOT allowed to run (e.g. qr(UPDATE xxx}).
  20 Finally, you can indicate which database attributes are allowed to be read and
  21 changed (e.g. 'PrintError'). For all of the above, there are matching methods to
  22 remove them as well.
  23
  24 WWW: http://search.cpan.org/dist/DBIx-Safe/