NAME

PlugAuth::Client::Tiny - (Deprecated) Minimal PlugAuth client

VERSION

version 0.03

SYNOPSIS

use PlugAuth::Client::Tiny;
my $client = PlugAuth::Client::Tiny->new( url => "http://localhost:3000/" );
if($client->auth('primus', 'spark'))
{
  # authentication succeeded
}
else
{
  # authentication failed
}

DESCRIPTION

NOTE: Development for this tool is winding down, and PlugAuth::Client::Tiny and modules that depend on are deprecated. Please contact me ASAP if you depend on this tool. This distribution may be removed from CPAN, but not before june 30, 2018.

PlugAuth::Client::Tiny is a minimal PlugAuth client. It uses HTTP::Tiny instead of LWP or Mojo::UserAgent. It provides only a mechanism for authenticating and authorizing against a PlugAuth server. If you need to modify the users/groups/authorization on the server through the RESTful API then you will need the heavier PlugAuth::Client which relies on Clustericious::Client and Mojo::UserAgent.

PlugAuth::Client::Tiny should work perfectly with PlugAuth::Lite as well, because it only uses the subset of the PlugAuth API which is implemented by PlugAuth::Lite.

CONSTRUCTOR

new

use PlugAuth::Client::Tiny->new;
my $client = PlugAuth::Client::Tiny->new;

PlugAuth::Client::Tiny's constructor accepts one optional option:

url

The URL of the PlugAuth server. If not specified, http://localhost:3000 is used.

All other options passed to new will be passed on to the constructor of HTTP::Tiny, which allows you to set agent, default_headers, etc. See the documentation of HTTP::Tiny for details.

ATTRIBUTES

url

my $url = $client->url;

Returns the URL for the PlugAuth server. This attribute is read-only.

METHODS

auth

my $bool = $client->auth( $user, $password );

Attempt to authenticate against the PlugAuth server using the given username and password. Returns 1 on success, 0 on failure and dies on a connection failure.

authz

my $bool = $client->authz( $user, $action, $resource );

Determine if the given user is authorized to perform the given action on the given resource. Returns 1 on success, 0 on failure and dies on connection failure.

version

my $version = $client->version;

Returns the version of the PlugAuth server.

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.