NAME

XDI::SPIT - XDI Service Provider Interface Toolkit

SYNOPSIS

  use XDI::SPIT;

  my $iname = '@blueoxen*eekim';
  my $rtnUrl = 'http://www.blueoxen.org/?';

  my $spit = new XDI::SPIT;
  my ($idBroker, $inumber) = $spit->resolveBroker($iname);

  my $redirectUrl = $spit->getAuthUrl($idBroker, $iname, $rtnUrl);
      # Use this to redirect to identity broker login screen

DESCRIPTION

Perl library for Service Providers to authenticate and synchronize data with data brokers.

METHODS

new

Constructor.

resolveBroker($iname)

Resolves the XRI e-name. Returns the identity broker and e-number corresponding to an e-name.

getAuthUrl($idBroker, $iname, $returnUrl)

Returns the redirection URL for sending the user to the identity broker for login. Send the following HTTP header to redirect:

  Location: $redirectUrl\n\n

where $redirectUrl is the result of getAuthUrl().

validateSession($idBroker, $iname, $xsid)

Validates with $idBroker that user $iname is indeed logged in. $xsid is passed by the identity broker when it redirects to the return URL (specified in &getAuthUrl). Returns 1 or 0.

logout($idBroker, $iname, $xsid)

Logs out of a sessions with the identity broker. Returns 1 or 0.

SEE ALSO

XRI.

More information is available at the Identity Commons Wiki:

  http://wiki.idcommons.net/moin.cgi/FrontPage

and especially the following pages:

  http://wiki.idcommons.net/moin.cgi/SSO

  http://wiki.idcommons.net/moin.cgi/SPIT

AUTHOR

Eugene Eric Kim, <eekim@blueoxen.org>

COPYRIGHT AND LICENSE

Copyright (c) Blue Oxen Associates 2004. All rights reserved.

See COPYING for licensing terms.