documentation/manual/en/module_specs/Zend_Oauth-Introduction.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.oauth.introduction" xmlns:xi="http://www.w3.org/2001/XInclude">
   4     <title>Introduction to OAuth</title>
   5
   6     <para>
   7         OAuth allows you to approve access by any application to your private data stored a website
   8         without being forced to disclose your username or password. If you think about it, the
   9         practice of handing over your username and password for sites like Yahoo Mail or Twitter has
  10         been endemic for quite a while. This has raised some serious concerns because there's
  11         nothing to prevent other applications from misusing this data. Yes, some services may
  12         appear trustworthy but that is never guaranteed. OAuth resolves this problem by eliminating
  13         the need for any username and password sharing, replacing it with a user controlled
  14         authorization process.
  15     </para>
  16
  17     <para>
  18         This authorization process is token based. If you authorize an application (and by
  19         application we can include any web based or desktop application) to access your data, it
  20         will be in receipt of an Access Token associated with your account. Using this Access Token,
  21         the application can access your private data without continually requiring your credentials.
  22         In all this authorization delegation style of protocol is simply a more secure solution to
  23         the problem of accessing private data via any web service <acronym>API</acronym>.
  24     </para>
  25
  26     <para>
  27         OAuth is not a completely new idea, rather it is a standardized protocol building on the
  28         existing properties of protocols such as Google AuthSub, Yahoo BBAuth, Flickr
  29         <acronym>API</acronym>, etc. These all to some extent operate on the basis of exchanging
  30         user credentials for an Access Token of some description. The power of a standardized
  31         specification like OAuth is that it only requires a single implementation as opposed to many
  32         disparate ones depending on the web service. This standardization has not occurred
  33         independently of the major players, and indeed many now support OAuth as an alternative and
  34         future replacement for their own solutions.
  35     </para>
  36
  37     <para>
  38         Zend Framework's <classname>Zend_Oauth</classname> currently implements a full OAuth
  39         Consumer conforming to the OAuth Core 1.0 Revision A Specification (24 June 2009) via the
  40         <classname>Zend_Oauth_Consumer</classname> class.
  41     </para>
  42
  43     <xi:include href="Zend_Oauth-ProtocolWorkflow.xml" />
  44     <xi:include href="Zend_Oauth-SecurityArchitecture.xml" />
  45     <xi:include href="Zend_Oauth-GettingStarted.xml" />
  46 </sect1>