App-OdinAuthorizer -- Authorization webapp for Apache2::Authen::OdinAuth

This is a Perl Dancer implementation of an authorizer webapp for
Apache2::Authen::OdinAuth, a cookie-based single sign-on system. It
calls back to Google Apps for Domains, and allows users who authorize
with email of a preconfigured domain.

You can learn more about Odin Authenticator system at
http://ginzamarkets.github.com/odin_authenticator/.

INSTALLATION

To run this module, run the following commands:

	perl Build.PL
	./Build
	./Build test
	./Build installdeps
        ./bin/app.pl

CONFIGURATION

Default values are provided in the config.yml file. For development or
review, you can stick with the defaults or customize the
environments/development.yml file. For production, prepare
environments/production.yml file (you can start based on the
environments/sample_production.yml example).

To use production settings, pass DANCER_ENVIRONMENT=production
environment variable to the app.pl script.

PRODUCTION DEPLOYMENT

You don't really want to use ./bin/app.pl directly in production
settings. Recommended setup is to use Apache with mod_perl and the
Plack handler. Here is a sample Apache config file:

    <VirtualHost *:80>
      ServerName i.yourdomain.com
      DocumentRoot /srv/App-OdinAuthorizer/public
    
      SetHandler perl-script
      PerlHandler Plack::Handler::Apache2
      PerlSetVar psgi_app /srv/App-OdinAuthorizer/bin/app.pl
      SetEnv DANCER_ENVIRONMENT "production"
    
      <Location ~ "^/(?:[^/]+.(?:html|jpg|png|ico)$|bootstrap/|css/|js/)">
        SetHandler None
      </Location>
    </VirtualHost>

SUPPORT AND DOCUMENTATION

This module is developed at
https://github.com/ginzamarkets/App-OdinAuthorizer/. The file you are
reading right now is the main documentation. You can learn more about
the Odin Authenticator system at
http://ginzamarkets.github.com/odin_authenticator/.

You can also look for information at:

    RT, CPAN's request tracker (report bugs here)
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-OdinAuthorizer

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/App-OdinAuthorizer

    CPAN Ratings
        http://cpanratings.perl.org/d/App-OdinAuthorizer

    Search CPAN
        http://search.cpan.org/dist/App-OdinAuthorizer/


LICENSE AND COPYRIGHT

Copyright (C) 2012 Maciej Pasternacki

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.