The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

VERSION

This documentation refers to <Authen::CAS::External> version 0.01

SYNOPSIS

  my $cas_auth = Authen::CAS::External->new(
      cas_url => URI->new('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);

DESCRIPTION

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.

CONSTRUCTOR

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.

new

This will construct a new object.

cas_url

This is the URL of the CAS site excluding /login. This is required and is a URI object.

password

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 usernamd or password.

username

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

METHODS

authenticate

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

DEPENDENCIES

AUTHOR

Douglas Christopher Wilson, <doug at somethingdoug.com>

BUGS AND LIMITATIONS

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.

SUPPORT

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

    perldoc Authen::CAS::External

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2009 Douglas Christopher Wilson, all rights reserved.

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