Net::OpenID::Extension(3pm) User Contributed Perl Documentation Net::OpenID::Extension(3pm)NAME
Net::OpenID::Extension - Base class for OpenID extensions
VERSION
version 1.14
METHODS
CLASS->namespace_uris
Return a hashref mapping namespace URIs to the aliases you will use to refer to them in the other methods. For example:
return {
'http://example.com/some-extension' => 'someext',
};
CLASS->new_request(@parameters)
When your extension is added to the Net::OpenID::ClaimedIdentity object in consumer-land, this method will be called to create a request
object. Any additional arguments passed when adding the extension will be passed through verbatim in @parameters.
The object you return here should at minimum provide the interface defined in Net::OpenID::ExtensionMessage.
You can return "undef" here if you have nothing useful to return.
CLASS->received_request(\%args)
In server-land, when a caller asks for the request object for your extension this method will be called to create a request object. %args
maps the aliases you returned from the "namespace_uris" method to a hashref of the key-value pairs provided in that namespace.
The object you return here should at minimum provide the interface defined in Net::OpenID::ExtensionMessage, and should behave identically
to the corresponding object returned from "new_request".
You can return "undef" here if you have nothing useful to return.
CLASS->new_response(@parameters)
When your extension is added to the response in server-land, this method will be called to create a response object. Any additional
arguments passed when adding the extension will be passed through verbatim in @parameters.
You can return "undef" here if you have nothing useful to return.
CLASS->received_response(\%args)
In consumer-land, when a caller asks for the request object for your extension in Net::OpenID::VerifiedIdentity this method will be called
to create a response object. %args maps the aliases you returned from the "namespace_uris" method to a hashref of the key-value pairs
provided in that namespace.
You can return "undef" here if you have nothing useful to return.
perl v5.12.4 2011-11-11 Net::OpenID::Extension(3pm)
Check Out this Related Man Page
Net::OpenID::VerifiedIdentity(3pm) User Contributed Perl Documentation Net::OpenID::VerifiedIdentity(3pm)NAME
Net::OpenID::VerifiedIdentity - Object representing a verified OpenID identity
VERSION
version 1.13
SYNOPSIS
use Net::OpenID::Consumer;
my $csr = Net::OpenID::Consumer->new;
....
my $vident = $csr->verified_identity
or die $csr->err;
my $url = $vident->url;
DESCRIPTION
After Net::OpenID::Consumer verifies a user's identity and does the signature checks, it gives you this Net::OpenID::VerifiedIdentity
object, from which you can learn more about the user.
METHODS
$vident->url
Returns the URL (as a scalar) that was verified. (Remember, an OpenID is just a URL.)
$vident->display
Returns the a short "display form" of the verified URL using a couple brain-dead patterns. For instance, the identity
"http://www.foo.com/~bob/" will map to "bob [foo.com]" The www. prefix is removed, as well as http, and a username is looked for, in
either the tilde form, or "/users/USERNAME" or "/members/USERNAME". If the path component is empty or just "/", then the display form
is just the hostname, so "http://myblog.com/" is just "myblog.com".
Suggestions for improving this function are welcome, but you'll probably get more satisfying results if you make use of the data
returned by the Simple Registration (SREG) extension, which allows the user to choose a preferred nickname to use on your site.
$vident->extension_fields($ns_uri)
Return the fields from the given extension namespace, if any, that were included in the assertion request. The fields are returned in a
hashref.
In most cases you'll probably want to use signed_extension_fields instead, to avoid attacks where a man-in-the-middle alters the
extension fields in transit.
Note that for OpenID 1.1 transactions only Simple Registration (SREG) 1.1 is supported.
$vident->signed_extension_fields($ns_uri)
The same as extension_fields except that only fields that were signed as part of the assertion are included in the returned hashref.
For example, if you included a Simple Registration request in your initial message, you might fetch the results (if any) like this:
$sreg = $vident->signed_extension_fields(
'http://openid.net/extensions/sreg/1.1',
);
An important gotcha to bear in mind is that for OpenID 2.0 responses no extension fields can be considered signed unless the
corresponding extension namespace declaration is also signed. If that is not the case, this method will behave as if no extension
fields for that URI were signed.
$vident->rss
$vident->atom
$vident->foaf
$vident->declared_rss
$vident->declared_atom
$vident->declared_foaf
Returns the absolute URLs (as scalars) of the user's RSS, Atom, and FOAF XML documents that were also found in their HTML's <head>
section. The short versions will only return a URL if they're below the root URL that was verified. If you want to get at the user's
declared rss/atom/foaf, even if it's on a different host or parent directory, use the declared_* versions, which don't have the
additional checks.
2005-05-24: A future module will take a Net::OpenID::VerifiedIdentity object and create an OpenID profile object so you don't have to
manually parse all those documents to get profile information.
$vident->foafmaker
Returns the value of the "foaf:maker" meta tag, if declared.
COPYRIGHT, WARRANTY, AUTHOR
See Net::OpenID::Consumer for author, copyrignt and licensing information.
SEE ALSO
Net::OpenID::Consumer
Net::OpenID::ClaimedIdentity
Net::OpenID::Server
Website: <http://openid.net/>
perl v5.14.2 2012-03-18 Net::OpenID::VerifiedIdentity(3pm)