Authen::NZRealMe::LogonStrength - Manipulate NZ RealMe Login service AuthnContextClassRef values
The NZ RealMe Login service supports the notion of logon strength. For example a user session authenticated with a username and password is a 'low strength' logon. Whereas authenticating with a user, password and SecurID token will result in a moderate strength logon. The different logon strengths are represented by URNs which will be present in the initial SAML AuthnRequest message as well as the assertion in the resulting ArtifactResponse.
This class is used to encapsulate the URNs and to provide methods for comparing the strength of one URN to another.
The following constants are defined for referring to URNs:
Creates an object from the named strength identifier which might be a word (e.g.: 'low'), a URN (see the RealMe Login service SAML v2.0 Messaging Specification), or a URN fragment matching the last portion of a URN (e.g.: 'OTP:Token:SID').
Returns the URN for the selected logon strength.
Returns the strength score (currently either 10 or 20) which is used when comparing strengths using the 'minimum' match type.
This method returns if the provided logon strength matches the required strength, or dies if the strength does not meet the specified requirement.
The required_strength will default to 'low' if not provided.
required_strength
The strength_match parameter must be 'exact' or 'minimum' (default 'minimum'). When comparing different logon strengths, the rules outlined in the RealMe Login service SAML v2.0 Messaging Specification are used.
strength_match
See Authen::NZRealMe for documentation index.
Copyright (c) 2010-2022 Enrolment Services, New Zealand Electoral Commission
Written by Grant McLean <grant@catalyst.net.nz>
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Authen::NZRealMe, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Authen::NZRealMe
CPAN shell
perl -MCPAN -e shell install Authen::NZRealMe
For more information on module installation, please visit the detailed CPAN module installation guide.