NAME

Authen::Pluggable::JSON - Authentication via external json

VERSION

version 0.03

SYNOPSIS

  use Authen::Pluggable;

  my $auth = Authen::Pluggable->new();

  $auth->provider('JSON')->cfg({
    url           => ...,
    query_builder => ...,
    res_builder   => ...,
  });

  my $user_info = $auth->authen($username, $password) || die "Login failed";

DESCRIPTION

Authen::Pluggable::JSON is a Authen::Pluggable plugin to authenticate users via JSON calls. You can personalize url, query parameters and returned JSON via configuration.

METHODS

cfg

This method takes a hash of parameters. The following options are valid:

url

Url to JSON service. Default: a Mojo::URL istance to http://127.0.0.1:3000/api/auth

query_builder

A subroutine ref for appending query string to url. The sub is called like this:

  $qb->($url, $username, $password);

Default appends user=$username&pass=$password to url.

res_builder

A subroutine ref for altering JSON structure returned by remote service to be compliance with Authen::Pluggable structure. The sub is called like this:

  $rb->($json);

Default: return JSON structure returned by remote service as is or undef if remote service return {}.

BUGS/CONTRIBUTING

Please report any bugs through the web interface at https://github.com/EmilianoBruni/authen-pluggable/issues

If you want to contribute changes or otherwise involve yourself in development, feel free to fork the Git repository from https://github.com/EmilianoBruni/authen-pluggable/.

SUPPORT

You can find this documentation with the perldoc command too.

    perldoc Authen::Pluggable::JSON

AUTHOR

Emiliano Bruni <info@ebruni.it>

COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by Emiliano Bruni.

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