Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

catalyst::plugin::authentication::credential::openid(3pm) [debian man page]

Catalyst::Plugin::Authentication::Credential::OpenID(3pmUser Contributed Perl DocumentatiCatalyst::Plugin::Authentication::Credential::OpenID(3pm)

NAME

       Catalyst::Plugin::Authentication::Credential::OpenID - OpenID credential for Catalyst::Auth framework

SYNOPSIS

	 use Catalyst qw/
	   Authentication
	   Authentication::Credential::OpenID
	   Session
	   Session::Store::FastMmap
	   Session::State::Cookie
	 /;

	 # MyApp.yaml -- optional
	 authentication:
	   openid:
	     use_session: 1
	     user_class: MyApp::M::User::OpenID

	 # whatever in your Controller pm
	 sub default : Private {
	     my($self, $c) = @_;
	     if ($c->user_exists) { ... }
	 }

	 sub signin_openid : Local {
	     my($self, $c) = @_;

	     if ($c->authenticate_openid) {
		 $c->res->redirect( $c->uri_for('/') );
	     }
	 }

	 # foo.tt
	 <form action="[% c.uri_for('/signin_openid') %]" method="GET">
	 <input type="text" name="openid_url" class="openid" />
	 <input type="submit" value="Sign in with OpenID" />
	 </form>

DESCRIPTION

       Catalyst::Plugin::Authentication::Credential::OpenID is an OpenID credential for Catalyst::Plugin::Authentication framework.

METHODS

       authenticate_openid
	     $c->authenticate_openid;

	   Call this method in the action you'd like to authenticate the user via OpenID. Returns 0 if auth is not successful, and 1 if user is
	   authenticated.

	   User class specified with user_class config, which defaults to Catalyst::Plugin::Authentication::User::Hash, will be instantiated with
	   the following parameters.

	   By default, authenticate_openid method looks for claimed URI parameter from the form field named "openid_url", "openid_identifier" or
	   "claimed_uri". If you want to use another form field name, call it like:

	     $c->authenticate_openid( $c->req->param('myopenid_param') );

	   url
	   display
	   rss
	   atom
	   foaf
	   declared_rss
	   declared_atom
	   declared_foaf
	   foafmaker

	   See Net::OpenID::VerifiedIdentity for details.

DIFFERENCE WITH Authentication::OpenID
       There's already Catalyst::Plugin::Authentication::OpenID (Auth::OpenID) and this plugin tries to deprecate it.

       o   Don't use this plugin with Auth::OpenID since method names will conflict and your app won't work.

       o   Auth::OpenID uses your root path (/) as an authentication callback but this plugin uses the current path, which means you can use this
	   plugin with other Credential plugins, like Flickr or TypeKey.

       o   This plugin is NOT a drop-in replacement for Auth::OpenID, but your app needs only slight modifications to work with this one.

       o   This plugin is based on Catalyst authentication framework, which means you can specify user_class or auth_store in your app config and
	   this modules does the right thing, like other Credential modules. This crates new User object if authentication is successful, and
	   works with Session too.

AUTHOR

       Six Apart, Ltd. <cpan@sixapart.com>

LICENSE

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

SEE ALSO

       Catalyst::Plugin::Authentication::OpenID, Catalyst::Plugin::Authentication::Credential::Flickr

perl v5.10.1							    2007-10-26		 Catalyst::Plugin::Authentication::Credential::OpenID(3pm)

Check Out this Related Man Page

Catalyst::Authentication::Store::IMAP(3pm)		User Contributed Perl Documentation		Catalyst::Authentication::Store::IMAP(3pm)

NAME

       Catalyst::Authentication::Store::IMAP - Authentication store accessing an IMAP server.

SYNOPSIS

	   use Catalyst qw(
	     Authentication
	     );

	   __PACKAGE__->config(
	     'authentication' => {
		default_realm => "imap",
		realms => {
		  imap => {
		    credential => {
		      class	     => "Password",
		      password_field => "password",
		      password_type  => "self_check",
		    },
		    store => {
		      class => 'IMAP',
		      host  => 'localhost',
		    },
		  },
		},
	      },
	   );

	   sub login : Global {
	       my ( $self, $c ) = @_;

	       $c->authenticate({
				 id	     => $c->req->param("login"),
				 password    => $c->req->param("password")
				});
	       $c->res->body("Welcome " . $c->user->username . "!");
	   }

DESCRIPTION

       This plugin implements the Catalyst::Authentication v.10 API. Read that documentation first if you are upgrading from a previous version of
       this plugin.

       This plugin uses "Mail::IMAPClient" to let your application authenticate against an IMAP server.  The used imap client object is stored on
       the stash as imapclient for use in other components.

CONFIGURATION OPTIONS

   host
       Sets the host name (or IP address) of the IMAP server.

   port
       Optionally set the port to connect to, defaults to 143.	If you specify port 993, IO::Socket::SSL will be used for connecting.

ATTRIBUTES

   host
       The host name used to connect to.

METHODS

   new
   from_session
   find_user
SEE ALSO

       Catalyst::Authentication::Store::IMAP::User Catalyst::Plugin::Authentication, Mail::IMAPClient

AUTHORS

       Stefan Seifert <nine@cpan.org>

LICENSE

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

perl v5.14.2							    2012-06-16				Catalyst::Authentication::Store::IMAP(3pm)
Man Page