The rt-authen-oauth2 from h4ckl4bm3

rt-authen-oauth2's Introduction

NAME
    RT-Authen-OAuth2 - External authentication for OAuth 2 sources, like
    Google, Twitter, GitHub, etc.

DESCRIPTION
    External authentication for OAuth2 sources.

RT VERSION
    Works with RT 4.4

DEPENDENCIES
    Requires Net::OAuth2::Profile::WebServer

INSTALLATION
    perl Makefile.PL
    make
    make install
        May need root permissions

    Edit your /opt/rt4/etc/RT_SiteConfig.pm
        If you are using RT 4.2 or greater, add this line:

            Plugin('RT::Authen::OAuth2');

        For RT 4.0, add this line:

            Set(@Plugins, qw(RT::Authen::OAuth2));

        or add RT::Authen::OAuth2 to your existing @Plugins line.

    Add / Edit OAuth2 configs found in OAuth2_Config.pm
    Clear your mason cache
            rm -rf /opt/rt4/var/mason_data/obj

    Restart your webserver

AUTHOR
    Best Practical Solutions, LLC <[email protected]>

BUGS
    All bugs should be reported via email to

        L<[email protected]|mailto:[email protected]>

    or via the web at

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

LICENSE AND COPYRIGHT
    This software is Copyright (c) 2016 by Best Practical Solutions LLC

    This is free software, licensed under:

      The GNU General Public License, Version 2, June 1991

    RequestAuthorization()

            Creates an Authorization Request on behalf of the Resource Owner
            (user), and initiates the OAuth 2 protocol with the
            Authorization Server. The browser will redirect to the
            $OAuthRedirect endpoint specified in the config.

    LogUserIn()

            Called from the $OAuthRedirect endpoint handler element.
            Validates the user exists and is allowed to log in,
            auto-populates user metadata returned from the OAuth 2 server,
            and sets up a session. If successful, returns to the handler
            template element to redirect to the final destination.

    IDPLoginButtonImage()

            Returns the appropriate login button image for the active OAuth
            2 server. This is displayed on the RT login page.

POD ERRORS
    Hey! The above document had some coding errors, which are explained
    below:

    Around line 87:
        '=item' outside of any '=over'

        =over without closing =back

Recommend Projects