authcas(3pm) [debian man page]

AuthCAS(3pm)						User Contributed Perl Documentation					      AuthCAS(3pm)

NAME

       AuthCAS - Client library for CAS 2.0 authentication server

VERSION

       Version 1.5

DESCRIPTION

       AuthCAS aims at providing a Perl API to Yale's Central Authentication System (CAS). Only a basic Perl library is provided with CAS whereas
       AuthCAS is a full object-oriented library.  =head1 PREREQUISITES

       This script requires IO::Socket::SSL and LWP::UserAgent

       any

       Network

SYNOPSIS

	 A simple example with a direct CAS authentication

	 use AuthCAS;
	 my $cas = new AuthCAS(casUrl => 'https://cas.myserver,
			   CAFile => '/etc/httpd/conf/ssl.crt/ca-bundle.crt',
			   );

	 my $login_url = $cas->getServerLoginURL('http://myserver/app.cgi');

	 ## The user should be redirected to the $login_url
	 ## When coming back from the CAS server a ticket is provided in the QUERY_STRING

	 ## $ST should contain the receaved Service Ticket
	 my $user = $cas->validateST('http://myserver/app.cgi', $ST);

	 printf "User authenticated as %s
", $user;

	 In the following example a proxy is requesting a Proxy Ticket for the target application

	 $cas->proxyMode(pgtFile => '/tmp/pgt.txt',
			 pgtCallbackUrl => 'https://myserver/proxy.cgi?callback=1
			 );

	 ## Same as before but the URL is the proxy URL
	 my $login_url = $cas->getServerLoginURL('http://myserver/proxy.cgi');

	 ## Like in the previous example we should receave a $ST

	 my $user = $cas->validateST('http://myserver/proxy.cgi', $ST);

	 ## Process errors
	 printf STDERR "Error: %s
", &AuthCAS::get_errors() unless (defined $user);

	 ## Now we request a Proxy Ticket for the target application
	 my $PT = $cas->retrievePT('http://myserver/app.cgi');

	 ## This piece of code is executed by the target application
	 ## It received a Proxy Ticket from the proxy
	 my ($user, @proxies) = $cas->validatePT('http://myserver/app.cgi', $PT);

	 printf "User authenticated as %s via %s proxies
", $user, join(',',@proxies);

DESCRIPTION

       CAS is Yale University's web authentication system, heavily inspired by Kerberos.  Release 2.0 of CAS provides "proxied credential" feature
       that allows authentication tickets to be carried by intermediate applications (Portals for instance), they are called proxy.

       This AuthCAS Perl module provides required subroutines to validate and retrieve CAS tickets.

SEE ALSO

       Yale Central Authentication Service (http://www.yale.edu/tp/auth/)
	phpCAS (http://esup-phpcas.sourceforge.net/)

COPYRIGHT

       Copyright (C) 2003 Comite Reseau des Universites (http://www.cru.fr). All rights reserved.

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

AUTHORS

       Olivier Salaun

perl v5.12.3							    2011-05-17							      AuthCAS(3pm)

Check Out this Related Man Page

Net::Proxy::Connector::connect_ssl(3pm) 		User Contributed Perl Documentation		   Net::Proxy::Connector::connect_ssl(3pm)

NAME

       Net::Proxy::Connector::connect_ssl - Create SSL/CONNECT tunnels through HTTP proxies

SYNOPSIS

	   # sample proxy using Net::Proxy::Connector::tcp
	   #		    and Net::Proxy::Connector::connect_ssl
	   use Net::Proxy;

	   # listen on localhost:6789
	   # and proxy to remotehost:9876 through proxy.company.com:8080
	   # using the given credentials
	   my $proxy = Net::Proxy->new(
	       in  => { type => 'tcp', port => '6789' },
	       out => {
		   type        => 'connect_ssl',
		   host        => 'remotehost',
		   port        => '9876',
		   proxy_host  => 'proxy.company.com',
		   proxy_port  => '8080',
		   proxy_user  => 'jrandom',
		   proxy_pass  => 's3kr3t',
		   proxy_agent => 'Mozilla/4.04 (X11; I; SunOS 5.4 sun4m)',
	       },
	   );
	   $proxy->register();

	   Net::Proxy->mainloop();

DESCRIPTION

       "Net::Proxy::Connecter::connect_ssl" is a "Net::Proxy::Connector" that uses the HTTP CONNECT method to ask the proxy to create a tunnel to
       an outside server. The data is then encrypted using SSL.

       Obviously, you'll need a server that understands SSL (or a proxy using "Net::Proxy::Connector::ssl") at the other end.

       This connector is only an "out" connector.

       In addition to the options listed below, this connector accepts all "SSL_..." options to "IO::Socket::SSL". They are transparently passed
       through to the appropriate "IO::Socket::SSL" methods when upgrading the socket to SSL.

CONNECTOR OPTIONS

       "Net::Proxy::Connector::connect" accepts the following options:

"out"
       o   host

	   The destination host.

       o   port

	   The destination port.

       o   proxy_host

	   The web proxy name or address.

       o   proxy_port

	   The web proxy port.

       o   proxy_user

	   The authentication username for the proxy.

       o   proxy_pass

	   The authentication password for the proxy.

       o   proxy_agent

	   The user-agent string to use when connecting to the proxy.

AUTHOR

       Philippe 'BooK' Bruhat, "<book@cpan.org>".

HISTORY

       Because "Net::Proxy" blocks when it tries to connect to itself, it wasn't possible to pass an SSL-encrypted connection through a proxy with
       a single script: you needed one for the SSL encapsulation, and another one for bypassing the proxy with the "CONNECT" HTTP method.

       See "Net::Proxy::Connector::connect" and "Net::Proxy::Connector::ssl" for details.

COPYRIGHT

       Copyright 2007 Philippe 'BooK' Bruhat, All Rights Reserved.

LICENSE

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

perl v5.10.1							    2009-10-18				   Net::Proxy::Connector::connect_ssl(3pm)

Linux and UNIX Man Pages

authcas(3pm) [debian man page]

Check Out this Related Man Page