oAuth library functions

0.6.0

Introduction

liboauth is a collection of c functions implementing the oAuth Core 1.0 Rev A standard API. liboauth provides basic functions to escape and encode parameters according to oAuth specs and offers high-level functions to sign requests or verify signatures.

liboauth depends on the openssl library, which is used for generating the hash signature, and optionally libcurl for issueing HTTP requests.

The source includes example code and a selftest based on http://wiki.oauth.net/TestCases. The library has been tested against the http://oauth-sandbox.mediamatic.nl and http://term.ie/oauth/example test servers using commandline-cURL, libcurl and a QT4.3.2 QHttp C++ application on win32 (mingw), gnu/Linux and Mac/OSX.

Installation

The source is debianized. On debian systems debian-buildpackage can be used to compile and dpkg -i to install liboauth and liboauth-dev package.

liboauth uses autotools and libtools. The tar.gz package includes the configure script, but if you get the source from the repository, you first need to generate the build environement with something alike: aclocal; autoheader; libtoolize --copy; autoconf; automake --gnu --add-missing --copy. (OSX users use glibtoolize).

run ./configure and build liboauth with make. see the INSTALL file for further instructions on gnu autotools.

If doxygen is available, the documentation can be rendered from the source by calling make dox. The http://wiki.oauth.net/TestCases scenarios in the example code can be run with make check.

Usage

Consult oauth.h for a detailed reference of available functions. This documentation is also available as unix manual page: man 3 oauth.

See tests/oauthtest.c for the self-test code and example. tests/oauthexample.c implements a simple hardcoded consumer. If you simply want to calculate the oAuth-signiature, all you need is oauth_sign_url. Future releases might include more elaborate usage information: Feel free to ask questions.

oauth-utils includes a command-line OAuth-consumer using liboauth.

Download

Download Source: liboauth-0.6.0.tar.gz  Changelog.

liboauth is maintained at sourceforge subversion repositories: Browse Web SVN URL: https://liboauth.svn.sourceforge.net/svnroot/liboauth/, and mirrored at oauth googlecode repository.

Bugs

send bug reports, patches or suggestions to robin @ gareus . org.

Ask the oauth-community or join the mailing list for discussion.

License

While the oauth source-code itself is under MIT license, this package integrated with xmalloc (and possibly libcurl) is licensed under LGPL.

This package is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this package; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA