Dancer2::Plugin::SPID
Dancer2 plugin for for SPID authentication
This Perl module is a plugin for the well-known Dancer2 web framework. It allows developers of SPID Service Providers to easily add SPID authentication to their Dancer2 applications. SPID is the Italian digital identity system, which enables citizens to access all public services with single set of credentials.
This module provides the highest level of abstraction and ease of use for integration of SPID in a Dancer2 web application. Just set a few configuration options and you'll be able to generate the HTML markup for the SPID button on the fly (to be completed) in order to place it wherever you want in your templates. This plugin will automatically generate all the routes for SAML bindings, so you don't need to perform any plumbing manually. Hooks are provided for customizing behavior.
See the example/ directory for a demo application.
This is module is based on Net::SPID which provides the lower-level framework-independent implementation of SPID for Perl.
Repository layout
- example/ contains a demo application based on Dancer2
- lib contains the source code of the Dancer2::Plugin::SPID module
- t/ contains the test suite
Prerequisites & installation
This module should be compatible with Perl 5.12+. Just install it with cpanm and it will install all dependencies automatically:
cpanm Net::SPID
Or, if you want the latest version from git, use:
cpanm https://github.com/italia/spid-perl-dancer2/archive/master.tar.gz
See also
- SPID page on Developers Italia
Authors
- Alessandro Ranellucci (maintainer) - Team per la Trasformazione Digitale - Presidenza del Consiglio dei Ministri