Authen::CAS::External - Authenticate with CAS servers as a browser would.

This documentation refers to Authen::CAS::External version 0.06

  my $cas_auth = Authen::CAS::External->new(
      cas_url => 'https://cas.mydomain.com/',
  );

  # Set the username and password
  $cas_auth->username('joe_smith');
  $cas_auth->password('hAkaT5eR');

  my $response = $cas_auth->authentiate();

  my $secured_page = $ua->get($response->destination);

Provides a way to authenticate with a CAS server just as a browser would. This is useful with web scrapers needing to login to a CAS site.

This is fully object-oriented, and as such before any method can be used, the constructor needs to be called to create an object to work with.

This will construct a new object.

new(%attributes)

%attributes is a HASH where the keys are attributes (specified in the ATTRIBUTES section).

new($attributes)

$attributes is a HASHREF where the keys are attributes (specified in the ATTRIBUTES section).

This is the URL of the CAS site excluding /login. This can be a URI object or a string of a URL.

This is the password to use for logging in to the CAS site. When set, this clears the ticket_granting_cookie.

This is the ticket granting cookie to use for logging into the CAS site. This can be set to log in with just the cookie and no username or password.

This is the username to use for logging in to the CAS site. When set, this clears the ticket_granting_cookie.

This method will authenticate against the CAS service using the already supplied username and password and will return a Authen::CAS::External::Response object.

This method takes a HASH with the following keys:

gateway

This is a Boolean of if the gateway parameter should be sent to the CAS server. The default is to not send any gateway parameter.

renew

This is a Boolean of if the renew parameter should be sent to the CAS server. The default is to not send any renew parameter.

service

This is a string that specifies the service value to send to the CAS server. The default is to not send any service parameter.

This method is not actually used, but is required for classes to consume the Authen::CAS::External::UserAgent role as this class does. This method will return the currently set username and password to the user agent.

This method is not actually used but is required for classes to consume the Authen::CAS::External::UserAgent role as this class does. This method will return the currently set ticket granting cookie if the username requested matches the username set (and always should).

* Moose 0.89

* MooseX::StrictConstructor 0.08

* MooseX::Types::Moose

* URI 1.22

* namespace::clean 0.04

Douglas Christopher Wilson, <doug at somethingdoug.com>

Please report any bugs or feature requests to bug-authen-cas-external at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Authen-CAS-External. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

I highly encourage the submission of bugs and enhancements to my modules.

You can find documentation for this module with the perldoc command.

  perldoc Authen::CAS::External

You can also look for information at:

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=Authen-CAS-External

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/Authen-CAS-External

* CPAN Ratings

http://cpanratings.perl.org/d/Authen-CAS-External

* Search CPAN

http://search.cpan.org/dist/Authen-CAS-External/

Copyright 2009 Douglas Christopher Wilson.

This program is free software; you can redistribute it and/or modify it under the terms of either:

* the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or

* the Artistic License version 2.0.