NAME
    RT-Authen-Token - token-based authentication

DESCRIPTION
    This module adds the ability for users to generate and login with
    authentication tokens. Users with the ManageAuthTokens permission will
    see a new "Auth Tokens" menu item under "Logged in as ____" -> Settings.
    On that page they will be able to generate new tokens and modify or
    revoke existing tokens.

    Once you have an authentication token, you may use it in place of a
    password to log into RT. (Additionally, RT::Extension::REST2 allows for
    using auth tokens with the Authorization: token HTTP header.) One common
    use case is to use an authentication token as an application-specific
    password, so that you may revoke that application's access without
    disturbing other applications. You also need not change your password,
    since the application never received it.

    If you have the AdminUsers permission, along with ManageAuthTokens, you
    may generate, modify, and revoke tokens for other users as well by
    visiting Admin -> Users -> Select -> (user) -> Auth Tokens.

    Authentication tokens are stored securely (hashed and salted) in the
    database just like passwords, and so cannot be recovered after they are
    generated.

INSTALLATION
    RT-Authen-Token requires version RT 4.2.5 or later.

    perl Makefile.PL
    make
    make install
        This step may require root permissions.

    make initdb
        Only run this the first time you install this module.

        If you run this twice, you will end up with duplicate data in your
        database.

        If you are upgrading this module, check for upgrading instructions
        in case changes need to be made to your database.

    Edit your /opt/rt4/etc/RT_SiteConfig.pm
        Add this line:

            Plugin( "RT::Authen::Token" );

    Update your Apache configuration
        If you are running RT under Apache, add the following directive to
        your RT Apache configuration to allow RT to access the Authorization
        header.

            SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

    Restart your webserver

AUTHOR
    Best Practical Solutions, LLC <modules@bestpractical.com>

BUGS
    All bugs should be reported via email to

        L<bug-RT-Authen-Token@rt.cpan.org|mailto:bug-RT-Authen-Token@rt.cpan.org>

    or via the web at

        L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Authen-Token>.

COPYRIGHT
    This extension is Copyright (C) 2017 Best Practical Solutions, LLC.

    This is free software, licensed under:

      The GNU General Public License, Version 2, June 1991

