IkiWiki/Plugin/openid.pm

   1 #!/usr/bin/perl
   2 # OpenID support.
   3 package IkiWiki::Plugin::openid;
   4
   5 use warnings;
   6 use strict;
   7 use IkiWiki 3.00;
   8
   9 sub import {
  10         add_underlay("openid-selector");
  11         hook(type => "checkconfig", id => "openid", call => \&checkconfig);
  12         hook(type => "getsetup", id => "openid", call => \&getsetup);
  13         hook(type => "auth", id => "openid", call => \&auth);
  14         hook(type => "formbuilder_setup", id => "openid",
  15                 call => \&formbuilder_setup, last => 1);
  16 }
  17
  18 sub checkconfig () {
  19         if ($config{cgi}) {
  20                 # Intercept normal signin form, so the openid selector
  21                 # can be displayed.
  22                 #
  23                 # When other auth hooks are registered, give the selector
  24                 # a reference to the normal signin form.
  25                 require IkiWiki::CGI;
  26                 my $real_cgi_signin;
  27                 if (keys %{$IkiWiki::hooks{auth}} > 1) {
  28                         $real_cgi_signin=\&IkiWiki::cgi_signin;
  29                 }
  30                 inject(name => "IkiWiki::cgi_signin", call => sub ($$) {
  31                         openid_selector($real_cgi_signin, @_);
  32                 });
  33         }
  34 }
  35
  36 sub getsetup () {
  37         return
  38                 plugin => {
  39                         safe => 1,
  40                         rebuild => 0,
  41                         section => "auth",
  42                 },
  43                 openid_realm => {
  44                         type => "string",
  45                         description => "url pattern of openid realm (default is cgiurl)",
  46                         safe => 0,
  47                         rebuild => 0,
  48                 },
  49                 openid_cgiurl => {
  50                         type => "string",
  51                         description => "url to ikiwiki cgi to use for openid authentication (default is cgiurl)",
  52                         safe => 0,
  53                         rebuild => 0,
  54                 },
  55 }
  56
  57 sub openid_selector {
  58         my $real_cgi_signin=shift;
  59         my $q=shift;
  60         my $session=shift;
  61
  62         my $openid_url=$q->param('openid_identifier');
  63         my $openid_error;
  64
  65         if (! load_openid_module()) {
  66                 if ($real_cgi_signin) {
  67                         $real_cgi_signin->($q, $session);
  68                         exit;
  69                 }
  70                 error(sprintf(gettext("failed to load openid module: "), @_));
  71         }
  72         elsif (defined $q->param("action") && $q->param("action") eq "verify") {
  73                 validate($q, $session, $openid_url, sub {
  74                         $openid_error=shift;
  75                 });
  76         }
  77
  78         my $template=IkiWiki::template("openid-selector.tmpl");
  79         $template->param(
  80                 cgiurl => $config{cgiurl},
  81                 (defined $openid_error ? (openid_error => $openid_error) : ()),
  82                 (defined $openid_url ? (openid_url => $openid_url) : ()),
  83                 ($real_cgi_signin ? (nonopenidform => $real_cgi_signin->($q, $session, 1)) : ()),
  84         );
  85
  86         IkiWiki::printheader($session);
  87         print IkiWiki::misctemplate("signin", $template->output);
  88         exit;
  89 }
  90
  91 sub formbuilder_setup (@) {
  92         my %params=@_;
  93
  94         my $form=$params{form};
  95         my $session=$params{session};
  96         my $cgi=$params{cgi};
  97
  98         if ($form->title eq "preferences" &&
  99                IkiWiki::openiduser($session->param("name"))) {
 100                 $form->field(name => "openid_identifier", disabled => 1,
 101                         label => htmllink("", "", "ikiwiki/OpenID", noimageinline => 1),
 102                         value => $session->param("name"),
 103                         size => length($session->param("name")), force => 1,
 104                         fieldset => "login");
 105                 $form->field(name => "email", type => "hidden");
 106         }
 107 }
 108
 109 sub validate ($$$;$) {
 110         my $q=shift;
 111         my $session=shift;
 112         my $openid_url=shift;
 113         my $errhandler=shift;
 114
 115         my $csr=getobj($q, $session);
 116
 117         my $claimed_identity = $csr->claimed_identity($openid_url);
 118         if (! $claimed_identity) {
 119                 if ($errhandler) {
 120                         $errhandler->($csr->err);
 121                         return 0;
 122                 }
 123                 else {
 124                         error($csr->err);
 125                 }
 126         }
 127
 128         # Ask for client to provide a name and email, if possible.
 129         # Try sreg and ax
 130         if ($claimed_identity->can("set_extension_args")) {
 131                 $claimed_identity->set_extension_args(
 132                         'http://openid.net/extensions/sreg/1.1',
 133                         {
 134                                 optional => 'email,fullname,nickname',
 135                         },
 136                 );
 137                 $claimed_identity->set_extension_args(
 138                         'http://openid.net/srv/ax/1.0',
 139                         {
 140                                 mode => 'fetch_request',
 141                                 'required' => 'email,fullname,nickname,firstname',
 142                                 'type.email' => "http://schema.openid.net/contact/email",
 143                                 'type.fullname' => "http://axschema.org/namePerson",
 144                                 'type.nickname' => "http://axschema.org/namePerson/friendly",
 145                                 'type.firstname' => "http://axschema.org/namePerson/first",
 146                         },
 147                 );
 148         }
 149
 150         my $cgiurl=$config{openid_cgiurl};
 151         $cgiurl=$config{cgiurl} if ! defined $cgiurl;
 152
 153         my $trust_root=$config{openid_realm};
 154         $trust_root=$cgiurl if ! defined $trust_root;
 155
 156         my $check_url = $claimed_identity->check_url(
 157                 return_to => "$cgiurl?do=postsignin",
 158                 trust_root => $trust_root,
 159                 delayed_return => 1,
 160         );
 161         # Redirect the user to the OpenID server, which will
 162         # eventually bounce them back to auth()
 163         IkiWiki::redirect($q, $check_url);
 164         exit 0;
 165 }
 166
 167 sub auth ($$) {
 168         my $q=shift;
 169         my $session=shift;
 170
 171         if (defined $q->param('openid.mode')) {
 172                 my $csr=getobj($q, $session);
 173
 174                 if (my $setup_url = $csr->user_setup_url) {
 175                         IkiWiki::redirect($q, $setup_url);
 176                 }
 177                 elsif ($csr->user_cancel) {
 178                         IkiWiki::redirect($q, $config{url});
 179                 }
 180                 elsif (my $vident = $csr->verified_identity) {
 181                         $session->param(name => $vident->url);
 182
 183                         my @extensions;
 184                         if ($vident->can("signed_extension_fields")) {
 185                                 @extensions=grep { defined } (
 186                                         $vident->signed_extension_fields('http://openid.net/extensions/sreg/1.1'),
 187                                         $vident->signed_extension_fields('http://openid.net/srv/ax/1.0'),
 188                                 );
 189                         }
 190                         foreach my $ext (@extensions) {
 191                                 foreach my $field (qw{value.email email}) {
 192                                         if (exists $ext->{$field} &&
 193                                             defined $ext->{$field} &&
 194                                             length $ext->{$field}) {
 195                                                 $session->param(email => $ext->{$field});
 196                                                 last;
 197                                         }
 198                                 }
 199                                 foreach my $field (qw{value.nickname nickname value.fullname fullname value.firstname}) {
 200                                         if (exists $ext->{$field} &&
 201                                             defined $ext->{$field} &&
 202                                             length $ext->{$field}) {
 203                                                 $session->param(username => $ext->{$field});
 204                                                 last;
 205                                         }
 206                                 }
 207                         }
 208                 }
 209                 else {
 210                         error("OpenID failure: ".$csr->err);
 211                 }
 212         }
 213         elsif (defined $q->param('openid_identifier')) {
 214                 # myopenid.com affiliate support
 215                 validate($q, $session, $q->param('openid_identifier'));
 216         }
 217 }
 218
 219 sub getobj ($$) {
 220         my $q=shift;
 221         my $session=shift;
 222
 223         eval q{use Net::OpenID::Consumer};
 224         error($@) if $@;
 225
 226         my $ua;
 227         eval q{use LWPx::ParanoidAgent};
 228         if (! $@) {
 229                 $ua=LWPx::ParanoidAgent->new;
 230         }
 231         else {
 232                 $ua=LWP::UserAgent->new;
 233         }
 234
 235         # Store the secret in the session.
 236         my $secret=$session->param("openid_secret");
 237         if (! defined $secret) {
 238                 $secret=rand;
 239                 $session->param(openid_secret => $secret);
 240         }
 241
 242         my $cgiurl=$config{openid_cgiurl};
 243         $cgiurl=$config{cgiurl} if ! defined $cgiurl;
 244
 245         return Net::OpenID::Consumer->new(
 246                 ua => $ua,
 247                 args => $q,
 248                 consumer_secret => sub { return shift()+$secret },
 249                 required_root => $cgiurl,
 250         );
 251 }
 252
 253 sub load_openid_module {
 254         # Give up if module is unavailable to avoid needing to depend on it.
 255         eval q{use Net::OpenID::Consumer};
 256         if ($@) {
 257                 debug("unable to load Net::OpenID::Consumer, not enabling OpenID login ($@)");
 258                 return;
 259         }
 260         return 1;
 261 }
 262
 263 1