NAME
    Apache2::AuthHatena - Simple authentication mod_perl module using Hatena
    Auth API

SYNOPSIS
      LoadModule perl_module modules/mod_perl.so
      PerlLoadModule Apache2::AuthHatena

      AuthType Hatena
      AuthName "My private documents"
      HatenaAuthKey yourauthkeygoeshere
      HatenaAuthSecret youauthsecretgoeshere
      HatenaAuthCallback http://sample.com/path/to/callback
      require valid-user

DESCRIPTION
    This mod_perl module allows you to implement easy authentication with
    Hatena Authentication API. You need Hatena Authentication API key from
    <http://auth.hatena.ne.jp>.

    Add the folloing lines to you Apache configuration file to load this
    module:

      LoadModule perl_module modules/mod_perl.so
      PerlLoadModule Apache2::AuthHatena

    And then you can write .htaccess file like this:

      AuthType Hatena
      AuthName "My private documents"
      HatenaAuthKey yourauthkeygoeshere
      HatenaAuthSecret youauthsecretgoeshere
      HatenaAuthCallback http://sample.com/path/to/callback
      require valid-user

    AuthType must be "hatena", and each of HatenaAuthKey, HatenaAuthSecret,
    and HatenaAuthCallback should be the value you've got from
    <http://auth.hatena.ne.jp>. If you assign 'valid-user' to 'require'
    directive, it means all people who has Hatena ID can see the protected
    documents. When you want to show the document only to, for example,
    id:jkondo and id:naoya, you can write like this:

      require user jkondo naoya

COMPATIBILITY
    This module will only work with mod_perl2. mod_perl1 is not supported.

SEE ALSO
    Hatena::API::Auth <http://auth.hatena.ne.jp>

AUTHOR
    "Nobuo Danjou, danjou@hatena.ne.jp"

COPYRIGHT AND LICENSE
    Copyright (C) 2007 by Nobuo Danjou

    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself, either Perl version 5.8.6 or, at
    your option, any later version of Perl 5 you may have available.

