NAME

Net::SAML2::Binding::Redirect

VERSION

version 0.27

SYNOPSIS

  my $redirect = Net::SAML2::Binding::Redirect->new(
    key => '/path/to/SPsign-nopw-key.pem',      # Service Provider (SP) private key
    url => $sso_url,                            # Service Provider Single Sign Out URL
    param => 'SAMLRequest' OR 'SAMLResponse',   # Type of request
    cert => '/path/to/IdP-cert.pem'             # Service Provider (SP) certificate
  );

  my $url = $redirect->sign($authnreq);

  my $ret = $redirect->verify($url);

NAME

Net::SAML2::Binding::Redirect

METHODS

new( ... )

Constructor. Creates an instance of the Redirect binding.

Arguments:

key

signing key (for creating Redirect URLs)

cert

IdP's signing cert (for verifying Redirect URLs)

url

IdP's SSO service url for the Redirect binding

param

query param name to use (SAMLRequest, SAMLResponse)

sign( $request, $relaystate )

Signs the given request, and returns the URL to which the user's browser should be redirected.

Accepts an optional RelayState parameter, a string which will be returned to the requestor when the user returns from the authentication process with the IdP.

verify( $url )

Decode a Redirect binding URL.

Verifies the signature on the response.

AUTHOR

Original Author: Chris Andrews <chrisa@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2020 by Chris Andrews and Others; in detail:

  Copyright 2010-2011  Chris Andrews
            2012       Peter Marschall
            2016       Jeff Fearn
            2020       Timothy Legge, Wesley Schwengle

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