Documentation/privileged_db/priv_db_HOWTO.txt

   1 By default, OpenEMR is configured to use the same database account information all the time which has full access to all tables.  Thus if that account is compromised (through SQL Injection as an example) modification can be made to anything.
   2
   3 The concept behind privDB is to allow a separate user that can be used for more “privileged operations” (such as modifying passwords) so the MySQL credentials for routine operations do  not need access.
   4
   5 After creating a privileged user and revoking permissions for the default user, the file sites/<sitename>/secure_sqlconf.php is used to specify the details of the privileged user.
   6
   7 It is not recommended that you make this change unless you are comfortable with MySQL administration.  In addition, the 'openemr' user no longer has full permissions, so when patching/upgrading the .SQL schema, the user defined in sites/<sitename>sqlconf.php will need to be modified to use a more privileged account (e.g. root, or a “secure” whose creation is being described below.).
   8
   9 Configuration of the privileged user should not be done with phpMyAdmin and is best done with a tool such a MySQL Workbench or with the mysql command-line tool with root db access. This is because you would be trying to change the permissions of the account phpMyAdmin is logged in with and are likely to encounter problem as a result.
  10
  11 In this description “openemr” is the MySQL username and 'secure' is the login to be created that has “full permissions.”
  12
  13 Manage the Database Users
  14         an example script is provided in:Documentation/privileged_db/example_user_permissions”
  15 1. Revoke “ALL” privileges for “openemr” by executing this command
  16         revoke all on openemr.* FROM 'openemr'@'localhost';
  17 2. Explicitly grant permissions to each table individually by executing statements like this:
  18         GRANT ALL ON openemr.addresses to 'openemr'@'localhost';
  19         GRANT ALL ON openemr.amc_misc_data to 'openemr'@'localhost';
  20         ...
  21     every table needs to be specified except for those tables that you wish to restrict access to (e.g. users_secure).
  22 3. Create the secure user.
  23         CREATE USER 'secure'@'localhost' identified by 'securepassword'
  24 4. Grant the secure user full permissions (or a subset of your choosing, access to users and users_secure are required at a minimum at present.
  25         GRANT ALL on openemr.* to 'secure'@'localhost'
  26
  27
  28 Update the OpenEMR files
  29 1. create sites/<sitename>/secure_sqlconf.php
  30 2. see example in Documentation/privileged_db/secure_sqlconf.php for reference
  31
  32 If you are having problems and want to “revert” delete the secure_sqlconf.php file and execute
  33         GRANT ALL on openemr.* to 'openemr'@'localhost'