net::openid::indirectmessage(3pm) [debian man page]

Net::OpenID::IndirectMessage(3pm)			User Contributed Perl Documentation			 Net::OpenID::IndirectMessage(3pm)

NAME

       Net::OpenID::IndirectMessage - Class representing a collection of namespaced arguments

VERSION

       version 1.14

DESCRIPTION

       This class acts as an abstraction layer over a collection of flat URL arguments which supports namespaces as defined by the OpenID Auth 2.0
       specification.

       It also recognises when it is given OpenID 1.1 non-namespaced arguments and acts as if the relevant namespaces were present. In this case,
       it only supports the basic OpenID 1.1 arguments and the extension arguments for Simple Registration.

       This class can operate on a normal hashref, a CGI object, an Apache object, an Apache::Request object, an Apache2::Request object, a
       Plack::Request object, or an arbitrary "CODE" ref that takes a key name as its first parameter and returns a value.  However, if you use a
       coderef then extension arguments are not supported.

       If you pass in a hashref or a coderef it is your responsibility as the caller to check the HTTP request method and pass in the correct set
       of arguments.  For the other kinds of objects, this module will do the right thing automatically.

SYNOPSIS

	   use Net::OpenID::IndirectMessage;

	   # Pass in something suitable for the underlying flat dictionary.
	   # Will return an instance if the request arguments can be understood
	   # as a supported OpenID Message format.
	   # Will return undef if this doesn't seem to be an OpenID Auth message.
	   # Will croak if the $argumenty_thing is not of a suitable type.
	   my $args = Net::OpenID::IndirectMessage->new($argumenty_thing);

	   # Determine which protocol version the message is using.
	   # Currently this can be either 1 for 1.1 or 2 for 2.0.
	   # Expect larger numbers for other versions in future.
	   # Most callers don't really need to care about this.
	   my $version = $args->protocol_version();

	   # Get a core argument value ("openid.mode")
	   my $mode = $args->get("mode");

	   # Get an extension argument value
	   my $nickname = $args->get_ext("http://openid.net/extensions/sreg/1.1", "nickname");

	   # Get hashref of all arguments in a given namespace
	   my $sreg = $args->get_ext("http://openid.net/extensions/sreg/1.1");

       Most of the time callers won't need to use this class directly, but will instead access it through a Net::OpenID::Consumer instance.

perl v5.12.4							    2011-11-11					 Net::OpenID::IndirectMessage(3pm)

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)