Simple, standardized OAuth signature generator
PHP JavaScript Perl Python HTML Perl 6 Makefile
Switch branches/tags
Nothing to show
Clone or download
jrconlin Merge pull request #38 from artu-ole/master
Fix ReferenceError: module is not defined
Latest commit b89f20c Feb 23, 2018
Failed to load latest commit information.
package.json Node.js Compatibility Sep 17, 2012



OAuthSimple - a very simple OAuth 1.0 signed request generator


See source comments for usage examples


OAuthSimple aids in building valid OAuth 1.0 requests. It does not perform token requests by itself, however you can use it to build the request calls.

I've tried to build the library to be fairly common so that if you're familiar with how it works in one language, you can use it in any other. Right now the following languages are supported: PHP, Javascript, Perl, Python. I'd love to add additional languages and may do so in the future. (I'd be happy to accept contributions, hint, hint.)

Guido Schlabitz has provided a useful example for how to use OAuthSimple to connect to Google

Dave Bagler has provided a Composer Package His fork has more details:

OAuthSimple accepts arguments in a variety of formats and returns a structure containing valid elements, including a fully structured URL, an Authorization header and the signature value. You should only use either the Authorization Header (as per the spec), or the fully structured URL. (Again, see source comments for appropriate usage.)

Please note that the Javascript version is not heavily optimized at this time. If you wish to use a more optimized version, please consult Anton Byrna's fork

OAuth Developers may be interested in my OAuthTestPage at: This will display OAuth1a valid elements and values so you can verify things are working correctly. =head1 EXAMPLES

Node.js Installation

> npm install oauthsimple

Node.js Example

OAuthSimple = require('OAuthSimple')
oauth = new OAuthSimple("token", "secret")
request = oauth.sign({
  action: "GET",
  path: "",
  parameters: { term: 'DeNiro' }

// then use any library to request the following url


Code is released under a BSD licence.