detailnet/dfw-varcrypt-module

This package is abandoned and no longer maintained. No replacement package was suggested.

Zend Framework 2 Module for dfw-varcrypt

0.1.2 2015-08-11 16:28 UTC

Requires

• php: >=5.4.0
• detailnet/dfw-core: ~0.2
• detailnet/dfw-varcrypt: ~0.1.1
• keboola/php-encryption: ~0.2.1
• psr/log: ~1.0
• zendframework/zend-config: 2.*
• zendframework/zend-console: 2.*
• zendframework/zend-loader: 2.*
• zendframework/zend-modulemanager: 2.*
• zendframework/zend-mvc: 2.*
• zendframework/zend-servicemanager: 2.*
• zendframework/zend-view: 2.*

Requires (Dev)

• phpmd/phpmd: ~2.1.3
• phpunit/phpunit: ~4.4.5
• satooshi/php-coveralls: dev-master
• squizlabs/php_codesniffer: ~2.2.0

MIT

• Ivan Wolf

• zf2
• module
• encryption
• environment
• variables
• dfw
• detailnet

README

Introduction

This module integrates the DETAIL Framework library for for working with encrypted environment variables with Zend Framework 2.

Requirements

Zend Framework 2 Skeleton Application (or compatible architecture)

Installation

Install the module through Composer using the following steps:

1. cd my/project/directory

2. Create a composer.json file with following contents (or update your existing file accordingly):

   {
       "require": {
           "detailnet/dfw-varcrypt-module": "1.x-dev"
       }
   }

3. Install Composer via curl -s http://getcomposer.org/installer | php (on Windows, download the installer and execute it with PHP)

4. Run php composer.phar self-update

5. Run php composer.phar install

6. Open configs/application.config.php and add following key to your modules:

   'service_manager' => array(
       'delegators' => array(
           'ModuleManager' => array(
               // By attaching this delegator the module Detail\VarCrypt is loaded before
               // all other modules so that the encrypted environment variables can be
               // applied before the configs of the other modules are merged/applied.
               'Detail\VarCrypt\Factory\ModuleManager\ModuleManagerDelegatorFactory',
           ),
       ),
   ),

7. Copy vendor/detailnet/dfw-varcrypt-module/config/detail_varcrypt.local.php.dist into your application's config/autoload directory, rename it to detail_varcrypt.local.php and make the appropriate changes.

Usage

Save/encode config

Before the module can be used, a config (simple string or JSON encoded string) needs to be encoded and provided as environment variable.

Here's an example for providing MongoDB credentials as a single environment variable:

1. Define credentials as JSON:

   {
     "server": "localhost",
     "user": "root",
     "password": "root",
     "port": 27017,
     "dbname": null,
     "options": []
   }

2. Make sure an encryption key is set in detail_varcrypt.local.php.

3. Encode JSON: php public/index.php varcrypt encode-value {"server": ...}

4. Save the output as environment variable (e.g. MONGO).

5. Test that the environment variable can be accessed (at least from the CLI): php public/index.php varcrypt decode-variable MONGO

Apply/decode config

The following steps are necessary, to use an encrypted/encoded environment variable in a ZF2 app.

1. Add the environment variable to the module's config (in detail_varcrypt.local.php):

   'detail_varcrypt' => array(
       'listeners' => array(
           'Detail\VarCrypt\Listener\MultiEncryptorListener' => array(
               'apply_variables' => array(
                   'mongo',
               ),
           ),
       ),
   ),

2. Access environment variables as you normally would:

   array(
       'doctrine' => array(
           'connection' => array(
               'odm_default' => array(
                   'server' => getenv('MONGO_SERVER') ?: 'localhost',
                   ...
               ),
           ),
       ),
   )