1Net::OpenID::VerifiedIdUesnetritCyo(n3t)ributed Perl DocNuemte:n:tOapteinoInD::VerifiedIdentity(3)
2
6 Net::OpenID::VerifiedIdentity - Object representing a verified OpenID
7 identity
8
10 version 1.18
11
13 use Net::OpenID::Consumer;
14 my $csr = Net::OpenID::Consumer->new;
15 ....
16 my $vident = $csr->verified_identity
17 or die $csr->err;
18 my $url = $vident->url;
20
22 After Net::OpenID::Consumer verifies a user's identity and does the
23 signature checks, it gives you this Net::OpenID::VerifiedIdentity
24 object, from which you can learn more about the user.
25
27 $vident->url
28 Returns the URL (as a scalar) that was verified. (Remember, an
29 OpenID is just a URL.)
30 $vident->display
32 Returns the a short "display form" of the verified URL using a
33 couple brain-dead patterns. For instance, the identity
34 "http://www.foo.com/~bob/" will map to "bob [foo.com]" The www.
35 prefix is removed, as well as http, and a username is looked for,
36 in either the tilde form, or "/users/USERNAME" or
37 "/members/USERNAME". If the path component is empty or just "/",
38 then the display form is just the hostname, so "http://myblog.com/"
39 is just "myblog.com".
40 Suggestions for improving this function are welcome, but you'll
42 probably get more satisfying results if you make use of the data
43 returned by the Simple Registration (SREG) extension, which allows
44 the user to choose a preferred nickname to use on your site.
45 $vident->extension_fields($ns_uri)
47 Return the fields from the given extension namespace, if any, that
48 were included in the assertion request. The fields are returned in
49 a hashref.
50 In most cases you'll probably want to use signed_extension_fields
52 instead, to avoid attacks where a man-in-the-middle alters the
53 extension fields in transit.
54 Note that for OpenID 1.1 transactions only Simple Registration
56 (SREG) 1.1 is supported.
57 $vident->signed_extension_fields($ns_uri)
59 The same as extension_fields except that only fields that were
60 signed as part of the assertion are included in the returned
61 hashref. For example, if you included a Simple Registration request
62 in your initial message, you might fetch the results (if any) like
63 this:
64 $sreg = $vident->signed_extension_fields(
66 'http://openid.net/extensions/sreg/1.1',
67 );
68 An important gotcha to bear in mind is that for OpenID 2.0
70 responses no extension fields can be considered signed unless the
71 corresponding extension namespace declaration is also signed. If
72 that is not the case, this method will behave as if no extension
73 fields for that URI were signed.
74 $vident->rss
76 $vident->atom
77 $vident->foaf
78 $vident->declared_rss
79 $vident->declared_atom
80 $vident->declared_foaf
81 Returns the absolute URLs (as scalars) of the user's RSS, Atom, and
82 FOAF XML documents that were also found in their HTML's <head>
83 section. The short versions will only return a URL if they're
84 below the root URL that was verified. If you want to get at the
85 user's declared rss/atom/foaf, even if it's on a different host or
86 parent directory, use the declared_* versions, which don't have the
87 additional checks.
88 2005-05-24: A future module will take a
90 Net::OpenID::VerifiedIdentity object and create an OpenID profile
91 object so you don't have to manually parse all those documents to
92 get profile information.
93 $vident->foafmaker
95 Returns the value of the "foaf:maker" meta tag, if declared.
96
98 See Net::OpenID::Consumer for author, copyrignt and licensing
99 information.
100
102 Net::OpenID::Consumer
103 Net::OpenID::ClaimedIdentity
105 Net::OpenID::Server
107 Website: <http://openid.net/>
109perl v5.32.1 2021-01-27 Net::OpenID::VerifiedIdentity(3)