integrate HybridAuth signle sign on library

3 files changed, 1467 insertions, 0 deletions

diff --git a/hauth/Hybrid/thirdparty/OAuth/OAuth.php b/hauth/Hybrid/thirdparty/OAuth/OAuth.php
new file mode 100644
index 0000000..e09d77c
--- /dev/null
+++ b/hauth/Hybrid/thirdparty/OAuth/OAuth.php
@@ -0,0 +1,901 @@
+<?php

+// http://oauth.googlecode.com/svn/code/php/OAuth.php

+// rev 1276,	July 4, 2014

+

+// vim: foldmethod=marker

+

+/* Generic exception class

+ */

+if (!class_exists('OAuthException', false)) {

+  class OAuthException extends Exception {

+    // pass

+  }

+}

+

+class OAuthConsumer {

+  public $key;

+  public $secret;

+

+  function __construct($key, $secret, $callback_url=null) {

+    $this->key = $key;

+    $this->secret = $secret;

+    $this->callback_url = $callback_url;

+  }

+

+  function __toString() {

+    return "OAuthConsumer[key=$this->key,secret=$this->secret]";

+  }

+}

+

+class OAuthToken {

+  // access tokens and request tokens

+  public $key;

+  public $secret;

+

+  /**

+   * key = the token

+   * secret = the token secret

+   */

+  function __construct($key, $secret) {

+    $this->key = $key;

+    $this->secret = $secret;

+  }

+

+  /**

+   * generates the basic string serialization of a token that a server

+   * would respond to request_token and access_token calls with

+   */

+  function to_string() {

+    return "oauth_token=" .

+           OAuthUtil::urlencode_rfc3986($this->key) .

+           "&oauth_token_secret=" .

+           OAuthUtil::urlencode_rfc3986($this->secret);

+  }

+

+  function __toString() {

+    return $this->to_string();

+  }

+}

+

+/**

+ * A class for implementing a Signature Method

+ * See section 9 ("Signing Requests") in the spec

+ */

+abstract class OAuthSignatureMethod {

+  /**

+   * Needs to return the name of the Signature Method (ie HMAC-SHA1)

+   * @return string

+   */

+  abstract public function get_name();

+

+  /**

+   * Build up the signature

+   * NOTE: The output of this function MUST NOT be urlencoded.

+   * the encoding is handled in OAuthRequest when the final

+   * request is serialized

+   * @param OAuthRequest $request

+   * @param OAuthConsumer $consumer

+   * @param OAuthToken $token

+   * @return string

+   */

+  abstract public function build_signature($request, $consumer, $token);

+

+  /**

+   * Verifies that a given signature is correct

+   * @param OAuthRequest $request

+   * @param OAuthConsumer $consumer

+   * @param OAuthToken $token

+   * @param string $signature

+   * @return bool

+   */

+  public function check_signature($request, $consumer, $token, $signature) {

+    $built = $this->build_signature($request, $consumer, $token);

+

+    // Check for zero length, although unlikely here

+    if (strlen($built) == 0 || strlen($signature) == 0) {

+      return false;

+    }

+

+    if (strlen($built) != strlen($signature)) {

+      return false;

+    }

+

+    // Avoid a timing leak with a (hopefully) time insensitive compare

+    $result = 0;

+    for ($i = 0; $i < strlen($signature); $i++) {

+      $result |= ord($built{$i}) ^ ord($signature{$i});

+    }

+

+    return $result == 0;

+  }

+}

+

+/**

+ * The HMAC-SHA1 signature method uses the HMAC-SHA1 signature algorithm as defined in [RFC2104] 

+ * where the Signature Base String is the text and the key is the concatenated values (each first 

+ * encoded per Parameter Encoding) of the Consumer Secret and Token Secret, separated by an '&' 

+ * character (ASCII code 38) even if empty.

+ *   - Chapter 9.2 ("HMAC-SHA1")

+ */

+class OAuthSignatureMethod_HMAC_SHA1 extends OAuthSignatureMethod {

+  function get_name() {

+    return "HMAC-SHA1";

+  }

+

+  public function build_signature($request, $consumer, $token) {

+    $base_string = $request->get_signature_base_string();

+    $request->base_string = $base_string;

+

+    $key_parts = array(

+      $consumer->secret,

+      ($token) ? $token->secret : ""

+    );

+

+    $key_parts = OAuthUtil::urlencode_rfc3986($key_parts);

+    $key = implode('&', $key_parts);

+

+    return base64_encode(hash_hmac('sha1', $base_string, $key, true));

+  }

+}

+

+/**

+ * The PLAINTEXT method does not provide any security protection and SHOULD only be used 

+ * over a secure channel such as HTTPS. It does not use the Signature Base String.

+ *   - Chapter 9.4 ("PLAINTEXT")

+ */

+class OAuthSignatureMethod_PLAINTEXT extends OAuthSignatureMethod {

+  public function get_name() {

+    return "PLAINTEXT";

+  }

+

+  /**

+   * oauth_signature is set to the concatenated encoded values of the Consumer Secret and 

+   * Token Secret, separated by a '&' character (ASCII code 38), even if either secret is 

+   * empty. The result MUST be encoded again.

+   *   - Chapter 9.4.1 ("Generating Signatures")

+   *

+   * Please note that the second encoding MUST NOT happen in the SignatureMethod, as

+   * OAuthRequest handles this!

+   */

+  public function build_signature($request, $consumer, $token) {

+    $key_parts = array(

+      $consumer->secret,

+      ($token) ? $token->secret : ""

+    );

+

+    $key_parts = OAuthUtil::urlencode_rfc3986($key_parts);

+    $key = implode('&', $key_parts);

+    $request->base_string = $key;

+

+    return $key;

+  }

+}

+

+/**

+ * The RSA-SHA1 signature method uses the RSASSA-PKCS1-v1_5 signature algorithm as defined in 

+ * [RFC3447] section 8.2 (more simply known as PKCS#1), using SHA-1 as the hash function for 

+ * EMSA-PKCS1-v1_5. It is assumed that the Consumer has provided its RSA public key in a 

+ * verified way to the Service Provider, in a manner which is beyond the scope of this 

+ * specification.

+ *   - Chapter 9.3 ("RSA-SHA1")

+ */

+abstract class OAuthSignatureMethod_RSA_SHA1 extends OAuthSignatureMethod {

+  public function get_name() {

+    return "RSA-SHA1";

+  }

+

+  // Up to the SP to implement this lookup of keys. Possible ideas are:

+  // (1) do a lookup in a table of trusted certs keyed off of consumer

+  // (2) fetch via http using a url provided by the requester

+  // (3) some sort of specific discovery code based on request

+  //

+  // Either way should return a string representation of the certificate

+  protected abstract function fetch_public_cert(&$request);

+

+  // Up to the SP to implement this lookup of keys. Possible ideas are:

+  // (1) do a lookup in a table of trusted certs keyed off of consumer

+  //

+  // Either way should return a string representation of the certificate

+  protected abstract function fetch_private_cert(&$request);

+

+  public function build_signature($request, $consumer, $token) {

+    $base_string = $request->get_signature_base_string();

+    $request->base_string = $base_string;

+

+    // Fetch the private key cert based on the request

+    $cert = $this->fetch_private_cert($request);

+

+    // Pull the private key ID from the certificate

+    $privatekeyid = openssl_get_privatekey($cert);

+

+    // Sign using the key

+    $ok = openssl_sign($base_string, $signature, $privatekeyid);

+

+    // Release the key resource

+    openssl_free_key($privatekeyid);

+

+    return base64_encode($signature);

+  }

+

+  public function check_signature($request, $consumer, $token, $signature) {

+    $decoded_sig = base64_decode($signature);

+

+    $base_string = $request->get_signature_base_string();

+

+    // Fetch the public key cert based on the request

+    $cert = $this->fetch_public_cert($request);

+

+    // Pull the public key ID from the certificate

+    $publickeyid = openssl_get_publickey($cert);

+

+    // Check the computed signature against the one passed in the query

+    $ok = openssl_verify($base_string, $decoded_sig, $publickeyid);

+

+    // Release the key resource

+    openssl_free_key($publickeyid);

+

+    return $ok == 1;

+  }

+}

+

+class OAuthRequest {

+  protected $parameters;

+  protected $http_method;

+  protected $http_url;

+  // for debug purposes

+  public $base_string;

+  public static $version = '1.0';

+  public static $POST_INPUT = 'php://input';

+

+  function __construct($http_method, $http_url, $parameters=null) {

+    $parameters = ($parameters) ? $parameters : array();

+    $parameters = array_merge( OAuthUtil::parse_parameters(parse_url($http_url, PHP_URL_QUERY)), $parameters);

+    $this->parameters = $parameters;

+    $this->http_method = $http_method;

+    $this->http_url = $http_url;

+  }

+

+

+  /**

+   * attempt to build up a request from what was passed to the server

+   */

+  public static function from_request($http_method=null, $http_url=null, $parameters=null) {

+    $scheme = (!isset($_SERVER['HTTPS']) || $_SERVER['HTTPS'] != "on")

+              ? 'http'

+              : 'https';

+    if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])) {

+      $scheme = $_SERVER['HTTP_X_FORWARDED_PROTO'];

+    }

+    $http_url = ($http_url) ? $http_url : $scheme .

+                              '://' . $_SERVER['SERVER_NAME'] .

+                              ':' .

+                              $_SERVER['SERVER_PORT'] .

+                              $_SERVER['REQUEST_URI'];

+    $http_method = ($http_method) ? $http_method : $_SERVER['REQUEST_METHOD'];

+

+    // We weren't handed any parameters, so let's find the ones relevant to

+    // this request.

+    // If you run XML-RPC or similar you should use this to provide your own

+    // parsed parameter-list

+    if (!$parameters) {

+      // Find request headers

+      $request_headers = OAuthUtil::get_headers();

+

+      // Parse the query-string to find GET parameters

+      $parameters = OAuthUtil::parse_parameters($_SERVER['QUERY_STRING']);

+

+      // It's a POST request of the proper content-type, so parse POST

+      // parameters and add those overriding any duplicates from GET

+      if ($http_method == "POST"

+          &&  isset($request_headers['Content-Type'])

+          && strstr($request_headers['Content-Type'],

+                     'application/x-www-form-urlencoded')

+          ) {

+        $post_data = OAuthUtil::parse_parameters(

+          file_get_contents(self::$POST_INPUT)

+        );

+        $parameters = array_merge($parameters, $post_data);

+      }

+

+      // We have a Authorization-header with OAuth data. Parse the header

+      // and add those overriding any duplicates from GET or POST

+      if (isset($request_headers['Authorization']) && substr($request_headers['Authorization'], 0, 6) == 'OAuth ') {

+        $header_parameters = OAuthUtil::split_header(

+          $request_headers['Authorization']

+        );

+        $parameters = array_merge($parameters, $header_parameters);

+      }

+

+    }

+

+    return new OAuthRequest($http_method, $http_url, $parameters);

+  }

+

+  /**

+   * pretty much a helper function to set up the request

+   */

+  public static function from_consumer_and_token($consumer, $token, $http_method, $http_url, $parameters=null) {

+    $parameters = ($parameters) ?  $parameters : array();

+    $defaults = array("oauth_version" => OAuthRequest::$version,

+                      "oauth_nonce" => OAuthRequest::generate_nonce(),

+                      "oauth_timestamp" => OAuthRequest::generate_timestamp(),

+                      "oauth_consumer_key" => $consumer->key);

+    if ($token)

+      $defaults['oauth_token'] = $token->key;

+

+    $parameters = array_merge($defaults, $parameters);

+

+    return new OAuthRequest($http_method, $http_url, $parameters);

+  }

+

+  public function set_parameter($name, $value, $allow_duplicates = true) {

+    if ($allow_duplicates && isset($this->parameters[$name])) {

+      // We have already added parameter(s) with this name, so add to the list

+      if (is_scalar($this->parameters[$name])) {

+        // This is the first duplicate, so transform scalar (string)

+        // into an array so we can add the duplicates

+        $this->parameters[$name] = array($this->parameters[$name]);

+      }

+

+      $this->parameters[$name][] = $value;

+    } else {

+      $this->parameters[$name] = $value;

+    }

+  }

+

+  public function get_parameter($name) {

+    return isset($this->parameters[$name]) ? $this->parameters[$name] : null;

+  }

+

+  public function get_parameters() {

+    return $this->parameters;

+  }

+

+  public function unset_parameter($name) {

+    unset($this->parameters[$name]);

+  }

+

+  /**

+   * The request parameters, sorted and concatenated into a normalized string.

+   * @return string

+   */

+  public function get_signable_parameters() {

+    // Grab all parameters

+    $params = $this->parameters;

+

+    // Remove oauth_signature if present

+    // Ref: Spec: 9.1.1 ("The oauth_signature parameter MUST be excluded.")

+    if (isset($params['oauth_signature'])) {

+      unset($params['oauth_signature']);

+    }

+

+    return OAuthUtil::build_http_query($params);

+  }

+

+  /**

+   * Returns the base string of this request

+   *

+   * The base string defined as the method, the url

+   * and the parameters (normalized), each urlencoded

+   * and the concated with &.

+   */

+  public function get_signature_base_string() {

+    $parts = array(

+      $this->get_normalized_http_method(),

+      $this->get_normalized_http_url(),

+      $this->get_signable_parameters()

+    );

+

+    $parts = OAuthUtil::urlencode_rfc3986($parts);

+

+    return implode('&', $parts);

+  }

+

+  /**

+   * just uppercases the http method

+   */

+  public function get_normalized_http_method() {

+    return strtoupper($this->http_method);

+  }

+

+  /**

+   * parses the url and rebuilds it to be

+   * scheme://host/path

+   */

+  public function get_normalized_http_url() {

+    $parts = parse_url($this->http_url);

+

+    $scheme = (isset($parts['scheme'])) ? $parts['scheme'] : 'http';

+    $port = (isset($parts['port'])) ? $parts['port'] : (($scheme == 'https') ? '443' : '80');

+    $host = (isset($parts['host'])) ? strtolower($parts['host']) : '';

+    $path = (isset($parts['path'])) ? $parts['path'] : '';

+

+    if (($scheme == 'https' && $port != '443')

+        || ($scheme == 'http' && $port != '80')) {

+      $host = "$host:$port";

+    }

+    return "$scheme://$host$path";

+  }

+

+  /**

+   * builds a url usable for a GET request

+   */

+  public function to_url() {

+    $post_data = $this->to_postdata();

+    $out = $this->get_normalized_http_url();

+    if ($post_data) {

+      $out .= '?'.$post_data;

+    }

+    return $out;

+  }

+

+  /**

+   * builds the data one would send in a POST request

+   */

+  public function to_postdata() {

+    return OAuthUtil::build_http_query($this->parameters);

+  }

+

+  /**

+   * builds the Authorization: header

+   */

+  public function to_header($realm=null) {

+    $first = true;

+	if($realm) {

+      $out = 'Authorization: OAuth realm="' . OAuthUtil::urlencode_rfc3986($realm) . '"';

+      $first = false;

+    } else

+      $out = 'Authorization: OAuth';

+

+    $total = array();

+    foreach ($this->parameters as $k => $v) {

+      if (substr($k, 0, 5) != "oauth") continue;

+      if (is_array($v)) {

+        throw new OAuthException('arrays not supported in headers');

+      }

+      $out .= ($first) ? ' ' : ',';

+      $out .= OAuthUtil::urlencode_rfc3986($k) .

+              '="' .

+              OAuthUtil::urlencode_rfc3986($v) .

+              '"';

+      $first = false;

+    }

+    return $out;

+  }

+

+  public function __toString() {

+    return $this->to_url();

+  }

+

+

+  public function sign_request($signature_method, $consumer, $token) {

+    $this->set_parameter(

+      "oauth_signature_method",

+      $signature_method->get_name(),

+      false

+    );

+    $signature = $this->build_signature($signature_method, $consumer, $token);

+    $this->set_parameter("oauth_signature", $signature, false);

+  }

+

+  public function build_signature($signature_method, $consumer, $token) {

+    $signature = $signature_method->build_signature($this, $consumer, $token);

+    return $signature;

+  }

+

+  /**

+   * util function: current timestamp

+   */

+  private static function generate_timestamp() {

+    return time();

+  }

+

+  /**

+   * util function: current nonce

+   */

+  private static function generate_nonce() {

+    $mt = microtime();

+    $rand = mt_rand();

+

+    return md5($mt . $rand); // md5s look nicer than numbers

+  }

+}

+

+class OAuthServer {

+  protected $timestamp_threshold = 300; // in seconds, five minutes

+  protected $version = '1.0';             // hi blaine

+  protected $signature_methods = array();

+

+  protected $data_store;

+

+  function __construct($data_store) {

+    $this->data_store = $data_store;

+  }

+

+  public function add_signature_method($signature_method) {

+    $this->signature_methods[$signature_method->get_name()] =

+      $signature_method;

+  }

+

+  // high level functions

+

+  /**

+   * process a request_token request

+   * returns the request token on success

+   */

+  public function fetch_request_token(&$request) {

+    $this->get_version($request);

+

+    $consumer = $this->get_consumer($request);

+

+    // no token required for the initial token request

+    $token = null;

+

+    $this->check_signature($request, $consumer, $token);

+

+    // Rev A change

+    $callback = $request->get_parameter('oauth_callback');

+    $new_token = $this->data_store->new_request_token($consumer, $callback);

+

+    return $new_token;

+  }

+

+  /**

+   * process an access_token request

+   * returns the access token on success

+   */

+  public function fetch_access_token(&$request) {

+    $this->get_version($request);

+

+    $consumer = $this->get_consumer($request);

+

+    // requires authorized request token

+    $token = $this->get_token($request, $consumer, "request");

+

+    $this->check_signature($request, $consumer, $token);

+

+    // Rev A change

+    $verifier = $request->get_parameter('oauth_verifier');

+    $new_token = $this->data_store->new_access_token($token, $consumer, $verifier);

+

+    return $new_token;

+  }

+

+  /**

+   * verify an api call, checks all the parameters

+   */

+  public function verify_request(&$request) {

+    $this->get_version($request);

+    $consumer = $this->get_consumer($request);

+    $token = $this->get_token($request, $consumer, "access");

+    $this->check_signature($request, $consumer, $token);

+    return array($consumer, $token);

+  }

+

+  // Internals from here

+  /**

+   * version 1

+   */

+  private function get_version(&$request) {

+    $version = $request->get_parameter("oauth_version");

+    if (!$version) {

+      // Service Providers MUST assume the protocol version to be 1.0 if this parameter is not present. 

+      // Chapter 7.0 ("Accessing Protected Ressources")

+      $version = '1.0';

+    }

+    if ($version !== $this->version) {

+      throw new OAuthException("OAuth version '$version' not supported");

+    }

+    return $version;

+  }

+

+  /**

+   * figure out the signature with some defaults

+   */

+  private function get_signature_method($request) {

+    $signature_method = $request instanceof OAuthRequest 

+        ? $request->get_parameter("oauth_signature_method")

+        : null;

+

+    if (!$signature_method) {

+      // According to chapter 7 ("Accessing Protected Ressources") the signature-method

+      // parameter is required, and we can't just fallback to PLAINTEXT

+      throw new OAuthException('No signature method parameter. This parameter is required');

+    }

+

+    if (!in_array($signature_method,

+                  array_keys($this->signature_methods))) {

+      throw new OAuthException(

+        "Signature method '$signature_method' not supported " .

+        "try one of the following: " .

+        implode(", ", array_keys($this->signature_methods))

+      );

+    }

+    return $this->signature_methods[$signature_method];

+  }

+

+  /**

+   * try to find the consumer for the provided request's consumer key

+   */

+  private function get_consumer($request) {

+    $consumer_key = $request instanceof OAuthRequest 

+        ? $request->get_parameter("oauth_consumer_key")

+        : null;

+

+    if (!$consumer_key) {

+      throw new OAuthException("Invalid consumer key");

+    }

+

+    $consumer = $this->data_store->lookup_consumer($consumer_key);

+    if (!$consumer) {

+      throw new OAuthException("Invalid consumer");

+    }

+

+    return $consumer;

+  }

+

+  /**

+   * try to find the token for the provided request's token key

+   */

+  private function get_token($request, $consumer, $token_type="access") {

+    $token_field = $request instanceof OAuthRequest

+         ? $request->get_parameter('oauth_token')

+         : null;

+

+    $token = $this->data_store->lookup_token(

+      $consumer, $token_type, $token_field

+    );

+    if (!$token) {

+      throw new OAuthException("Invalid $token_type token: $token_field");

+    }

+    return $token;

+  }

+

+  /**

+   * all-in-one function to check the signature on a request

+   * should guess the signature method appropriately

+   */

+  private function check_signature($request, $consumer, $token) {

+    // this should probably be in a different method

+    $timestamp = $request instanceof OAuthRequest

+        ? $request->get_parameter('oauth_timestamp')

+        : null;

+    $nonce = $request instanceof OAuthRequest

+        ? $request->get_parameter('oauth_nonce')

+        : null;

+

+    $this->check_timestamp($timestamp);

+    $this->check_nonce($consumer, $token, $nonce, $timestamp);

+

+    $signature_method = $this->get_signature_method($request);

+

+    $signature = $request->get_parameter('oauth_signature');

+    $valid_sig = $signature_method->check_signature(

+      $request,

+      $consumer,

+      $token,

+      $signature

+    );

+

+    if (!$valid_sig) {

+      throw new OAuthException("Invalid signature");

+    }

+  }

+

+  /**

+   * check that the timestamp is new enough

+   */

+  private function check_timestamp($timestamp) {

+    if( ! $timestamp )

+      throw new OAuthException(

+        'Missing timestamp parameter. The parameter is required'

+      );

+    

+    // verify that timestamp is recentish

+    $now = time();

+    if (abs($now - $timestamp) > $this->timestamp_threshold) {

+      throw new OAuthException(

+        "Expired timestamp, yours $timestamp, ours $now"

+      );

+    }

+  }

+

+  /**

+   * check that the nonce is not repeated

+   */

+  private function check_nonce($consumer, $token, $nonce, $timestamp) {

+    if( ! $nonce )

+      throw new OAuthException(

+        'Missing nonce parameter. The parameter is required'

+      );

+

+    // verify that the nonce is uniqueish

+    $found = $this->data_store->lookup_nonce(

+      $consumer,

+      $token,

+      $nonce,

+      $timestamp

+    );

+    if ($found) {

+      throw new OAuthException("Nonce already used: $nonce");

+    }

+  }

+

+}

+

+class OAuthDataStore {

+  function lookup_consumer($consumer_key) {

+    // implement me

+  }

+

+  function lookup_token($consumer, $token_type, $token) {

+    // implement me

+  }

+

+  function lookup_nonce($consumer, $token, $nonce, $timestamp) {

+    // implement me

+  }

+

+  function new_request_token($consumer, $callback = null) {

+    // return a new token attached to this consumer

+  }

+

+  function new_access_token($token, $consumer, $verifier = null) {

+    // return a new access token attached to this consumer

+    // for the user associated with this token if the request token

+    // is authorized

+    // should also invalidate the request token

+  }

+

+}

+

+class OAuthUtil {

+  public static function urlencode_rfc3986($input) {

+  if (is_array($input)) {

+    return array_map(array('OAuthUtil', 'urlencode_rfc3986'), $input);

+  } else if (is_scalar($input)) {

+    return str_replace(

+      '+',

+      ' ',

+      str_replace('%7E', '~', rawurlencode($input))

+    );

+  } else {

+    return '';

+  }

+}

+

+

+  // This decode function isn't taking into consideration the above

+  // modifications to the encoding process. However, this method doesn't

+  // seem to be used anywhere so leaving it as is.

+  public static function urldecode_rfc3986($string) {

+    return urldecode($string);

+  }

+

+  // Utility function for turning the Authorization: header into

+  // parameters, has to do some unescaping

+  // Can filter out any non-oauth parameters if needed (default behaviour)

+  // May 28th, 2010 - method updated to tjerk.meesters for a speed improvement.

+  //                  see http://code.google.com/p/oauth/issues/detail?id=163

+  public static function split_header($header, $only_allow_oauth_parameters = true) {

+    $params = array();

+    if (preg_match_all('/('.($only_allow_oauth_parameters ? 'oauth_' : '').'[a-z_-]*)=(:?"([^"]*)"|([^,]*))/', $header, $matches)) {

+      foreach ($matches[1] as $i => $h) {

+        $params[$h] = OAuthUtil::urldecode_rfc3986(empty($matches[3][$i]) ? $matches[4][$i] : $matches[3][$i]);

+      }

+      if (isset($params['realm'])) {

+        unset($params['realm']);

+      }

+    }

+    return $params;

+  }

+

+  // helper to try to sort out headers for people who aren't running apache

+  public static function get_headers() {

+    if (function_exists('apache_request_headers')) {

+      // we need this to get the actual Authorization: header

+      // because apache tends to tell us it doesn't exist

+      $headers = apache_request_headers();

+

+      // sanitize the output of apache_request_headers because

+      // we always want the keys to be Cased-Like-This and arh()

+      // returns the headers in the same case as they are in the

+      // request

+      $out = array();

+      foreach ($headers AS $key => $value) {

+        $key = str_replace(

+            " ",

+            "-",

+            ucwords(strtolower(str_replace("-", " ", $key)))

+          );

+        $out[$key] = $value;

+      }

+    } else {

+      // otherwise we don't have apache and are just going to have to hope

+      // that $_SERVER actually contains what we need

+      $out = array();

+      if( isset($_SERVER['CONTENT_TYPE']) )

+        $out['Content-Type'] = $_SERVER['CONTENT_TYPE'];

+      if( isset($_ENV['CONTENT_TYPE']) )

+        $out['Content-Type'] = $_ENV['CONTENT_TYPE'];

+

+      foreach ($_SERVER as $key => $value) {

+        if (substr($key, 0, 5) == "HTTP_") {

+          // this is chaos, basically it is just there to capitalize the first

+          // letter of every word that is not an initial HTTP and strip HTTP

+          // code from przemek

+          $key = str_replace(

+            " ",

+            "-",

+            ucwords(strtolower(str_replace("_", " ", substr($key, 5))))

+          );

+          $out[$key] = $value;

+        }

+      }

+    }

+    return $out;

+  }

+

+  // This function takes a input like a=b&a=c&d=e and returns the parsed

+  // parameters like this

+  // array('a' => array('b','c'), 'd' => 'e')

+  public static function parse_parameters( $input ) {

+    if (!isset($input) || !$input) return array();

+

+    $pairs = explode('&', $input);

+

+    $parsed_parameters = array();

+    foreach ($pairs as $pair) {

+      $split = explode('=', $pair, 2);

+      $parameter = OAuthUtil::urldecode_rfc3986($split[0]);

+      $value = isset($split[1]) ? OAuthUtil::urldecode_rfc3986($split[1]) : '';

+

+      if (isset($parsed_parameters[$parameter])) {

+        // We have already recieved parameter(s) with this name, so add to the list

+        // of parameters with this name

+

+        if (is_scalar($parsed_parameters[$parameter])) {

+          // This is the first duplicate, so transform scalar (string) into an array

+          // so we can add the duplicates

+          $parsed_parameters[$parameter] = array($parsed_parameters[$parameter]);

+        }

+

+        $parsed_parameters[$parameter][] = $value;

+      } else {

+        $parsed_parameters[$parameter] = $value;

+      }

+    }

+    return $parsed_parameters;

+  }

+

+  public static function build_http_query($params) {

+    if (!$params) return '';

+

+    // Urlencode both keys and values

+    $keys = OAuthUtil::urlencode_rfc3986(array_keys($params));

+    $values = OAuthUtil::urlencode_rfc3986(array_values($params));

+    $params = array_combine($keys, $values);

+

+    // Parameters are sorted by name, using lexicographical byte value ordering.

+    // Ref: Spec: 9.1.1 (1)

+    uksort($params, 'strcmp');

+

+    $pairs = array();

+    foreach ($params as $parameter => $value) {

+      if (is_array($value)) {

+        // If two or more parameters share the same name, they are sorted by their value

+        // Ref: Spec: 9.1.1 (1)

+        // June 12th, 2010 - changed to sort because of issue 164 by hidetaka

+        sort($value, SORT_STRING);

+        foreach ($value as $duplicate_value) {

+          $pairs[] = $parameter . '=' . $duplicate_value;

+        }

+      } else {

+        $pairs[] = $parameter . '=' . $value;

+      }

+    }

+    // For each parameter, the name is separated from the corresponding value by an '=' character (ASCII code 61)

+    // Each name-value pair is separated by an '&' character (ASCII code 38)

+    return implode('&', $pairs);

+  }

+}

diff --git a/hauth/Hybrid/thirdparty/OAuth/OAuth1Client.php b/hauth/Hybrid/thirdparty/OAuth/OAuth1Client.php
new file mode 100644
index 0000000..64c03c8
--- /dev/null
+++ b/hauth/Hybrid/thirdparty/OAuth/OAuth1Client.php
@@ -0,0 +1,264 @@
+<?php
+/**
+* HybridAuth
+* http://hybridauth.sourceforge.net | http://github.com/hybridauth/hybridauth
+* (c) 2009-2014, HybridAuth authors | http://hybridauth.sourceforge.net/licenses.html
+*/
+
+// A service client for the OAuth 1/1.0a flow.
+// v0.1
+class OAuth1Client{
+	public $api_base_url          = "";
+	public $authorize_url         = "";
+	public $authenticate_url      = "";
+	public $request_token_url     = "";
+	public $access_token_url      = "";
+
+	public $request_token_method  = "GET";
+	public $access_token_method   = "GET";
+
+	public $redirect_uri          = "";
+
+	public $decode_json           = true;
+	public $curl_time_out         = 30;
+	public $curl_connect_time_out = 30;
+	public $curl_ssl_verifypeer   = false;
+	public $curl_auth_header      = true;
+	public $curl_useragent        = "OAuth/1 Simple PHP Client v0.1; HybridAuth http://hybridauth.sourceforge.net/";
+	public $curl_proxy            = null;
+
+	//--
+
+	public $http_code             = "";
+	public $http_info             = "";
+	protected $response           = null;
+
+	/**
+	* OAuth client constructor
+	*/
+	function __construct( $consumer_key, $consumer_secret, $oauth_token = null, $oauth_token_secret = null )
+	{
+		$this->sha1_method = new OAuthSignatureMethod_HMAC_SHA1();
+		$this->consumer    = new OAuthConsumer( $consumer_key, $consumer_secret );
+		$this->token       = null;
+
+		if ( $oauth_token && $oauth_token_secret ){
+			$this->token = new OAuthConsumer( $oauth_token, $oauth_token_secret );
+		}
+	}
+
+	/**
+	* Build authorize url
+	*
+	* @return string
+	*/
+	function authorizeUrl( $token, $extras =array() )
+	{
+		if ( is_array( $token ) ){
+			$token = $token['oauth_token'];
+		}
+
+		$parameters = array( "oauth_token" => $token );
+
+		if( count($extras) )
+			foreach( $extras as $k=>$v )
+				$parameters[$k] = $v;
+
+		return $this->authorize_url . "?" . http_build_query( $parameters );
+    }
+
+	/**
+	* Get a request_token from provider
+	*
+	* @return array a key/value array containing oauth_token and oauth_token_secret
+	*/
+	function requestToken( $callback = null )
+	{
+		$parameters = array();
+
+		if ( $callback ) {
+			$this->redirect_uri = $parameters['oauth_callback'] = $callback;
+		}
+
+		$request     = $this->signedRequest( $this->request_token_url, $this->request_token_method, $parameters );
+		$token       = OAuthUtil::parse_parameters( $request );
+		$this->token = new OAuthConsumer( $token['oauth_token'], $token['oauth_token_secret'] );
+
+		return $token;
+	}
+
+	/**
+	* Exchange the request token and secret for an access token and secret, to sign API calls.
+	*
+	* @return array array('oauth_token' => the access token, 'oauth_token_secret' => the access secret)
+	*/
+	function accessToken( $oauth_verifier = false, $oauth_token = false )
+	{
+		$parameters = array();
+
+		// 1.0a
+		if ( $oauth_verifier ) {
+			$parameters['oauth_verifier'] = $oauth_verifier;
+		}
+
+		$request     = $this->signedRequest( $this->access_token_url, $this->access_token_method, $parameters );
+		$token       = OAuthUtil::parse_parameters( $request );
+		$this->token = new OAuthConsumer( $token['oauth_token'], $token['oauth_token_secret'] );
+
+		return $token;
+	}
+
+	/**
+	* GET wrapper for provider apis request
+	*/
+	function get($url, $parameters = array(), $content_type = null)
+	{
+		return $this->api($url, 'GET', $parameters, null, $content_type);
+	}
+
+	/**
+	* POST wrapper for provider apis request
+	*/
+	function post($url, $parameters = array(), $body = null, $content_type = null, $multipart = false)
+	{
+		return $this->api($url, 'POST', $parameters, $body, $content_type, $multipart );
+	}
+
+	/**
+	* Format and sign an oauth for provider api
+	*/
+	function api( $url, $method = 'GET', $parameters = array(), $body = null, $content_type = null, $multipart = false )
+	{
+		if ( strrpos($url, 'http://') !== 0 && strrpos($url, 'https://') !== 0 ) {
+			$url = $this->api_base_url . $url;
+		}
+
+		$response = $this->signedRequest( $url, $method, $parameters, $body, $content_type, $multipart );
+
+		if( $this->decode_json ){
+			$response = json_decode( $response );
+		}
+
+		return $this->response = $response;
+	}
+
+	/**
+	 * Return the response object afer the fact
+	 *
+	 * @return mixed
+	 */
+	public function getResponse()
+	{
+	    return $this->response;
+	}
+
+	/**
+	* Make signed request
+	*/
+	function signedRequest( $url, $method, $parameters, $body = null, $content_type = null, $multipart = false )
+	{
+
+        $signature_parameters = array();
+
+        // when making a multipart request, use only oauth_* keys for signature
+        foreach( $parameters AS $key => $value ){
+            if( !$multipart || strpos( $key, 'oauth_' ) === 0 ){
+                $signature_parameters[$key] = $value;
+            }
+        }
+
+		$request = OAuthRequest::from_consumer_and_token($this->consumer, $this->token, $method, $url, $signature_parameters);
+		$request->sign_request($this->sha1_method, $this->consumer, $this->token);
+		switch ($method) {
+			case 'GET': return $this->request( $request->to_url(), 'GET', null, null, $content_type );
+			default   :
+		if ($body)
+			return $this->request( $request->to_url(), $method, $body, $request->to_header(), $content_type );
+		else
+			return $this->request( $request->get_normalized_http_url(), $method, ($multipart ? $parameters : $request->to_postdata()), $request->to_header(), $content_type, $multipart ) ;
+		}
+	}
+
+	/**
+	* Make http request
+	*/
+	function request( $url, $method, $postfields = null, $auth_header = null, $content_type = null, $multipart = false )
+	{
+		Hybrid_Logger::info( "Enter OAuth1Client::request( $method, $url )" );
+		Hybrid_Logger::debug( "OAuth1Client::request(). dump post fields: ", serialize( $postfields ) );
+
+		$this->http_info = array();
+		$ci = curl_init();
+
+		/* Curl settings */
+		curl_setopt( $ci, CURLOPT_USERAGENT     , $this->curl_useragent );
+		curl_setopt( $ci, CURLOPT_CONNECTTIMEOUT, $this->curl_connect_time_out );
+		curl_setopt( $ci, CURLOPT_TIMEOUT       , $this->curl_time_out );
+		curl_setopt( $ci, CURLOPT_RETURNTRANSFER, true );
+		curl_setopt( $ci, CURLOPT_HTTPHEADER    , array('Expect:') );
+		curl_setopt( $ci, CURLOPT_SSL_VERIFYPEER, $this->curl_ssl_verifypeer );
+		curl_setopt( $ci, CURLOPT_HEADERFUNCTION, array($this, 'getHeader') );
+		curl_setopt( $ci, CURLOPT_HEADER        , false );
+
+        if( $multipart ){
+            curl_setopt( $ci, CURLOPT_HTTPHEADER, array( 'Expect:', $auth_header ) );
+
+        }elseif ($content_type)
+			curl_setopt( $ci, CURLOPT_HTTPHEADER, array('Expect:', "Content-Type: $content_type") );
+
+		if($this->curl_proxy){
+			curl_setopt( $ci, CURLOPT_PROXY        , $this->curl_proxy);
+		}
+
+		switch ($method){
+			case 'POST':
+				curl_setopt( $ci, CURLOPT_POST, true );
+
+				if ( !empty($postfields) ){
+					curl_setopt( $ci, CURLOPT_POSTFIELDS, $postfields );
+				}
+
+				if ( !empty($auth_header) && $this->curl_auth_header && !$multipart ){
+					curl_setopt( $ci, CURLOPT_HTTPHEADER, array( 'Content-Type: application/atom+xml', $auth_header ) );
+				}
+				break;
+			case 'DELETE':
+				curl_setopt( $ci, CURLOPT_CUSTOMREQUEST, 'DELETE' );
+				if ( !empty($postfields) ){
+				  $url = "{$url}?{$postfields}";
+				}
+		}
+
+		curl_setopt($ci, CURLOPT_URL, $url);
+		$response = curl_exec($ci);
+		if( $response === false ) {
+				Hybrid_Logger::error( "OAuth1Client::request(). curl_exec error: ", curl_error($ci) );
+		}
+
+
+		Hybrid_Logger::debug( "OAuth1Client::request(). dump request info: ", serialize( curl_getinfo($ci) ) );
+		Hybrid_Logger::debug( "OAuth1Client::request(). dump request result: ", serialize( $response ) );
+
+		$this->http_code = curl_getinfo($ci, CURLINFO_HTTP_CODE);
+		$this->http_info = array_merge($this->http_info, curl_getinfo($ci));
+
+		curl_close ($ci);
+
+		return $response;
+	}
+
+	/**
+	* Get the header info to store.
+	*/
+	function getHeader($ch, $header) {
+		$i = strpos($header, ':');
+
+		if ( !empty($i) ){
+			$key = str_replace('-', '_', strtolower(substr($header, 0, $i)));
+			$value = trim(substr($header, $i + 2));
+			$this->http_header[$key] = $value;
+		}
+
+		return strlen($header);
+	}
+}
diff --git a/hauth/Hybrid/thirdparty/OAuth/OAuth2Client.php b/hauth/Hybrid/thirdparty/OAuth/OAuth2Client.php
new file mode 100644
index 0000000..0046d2c
--- /dev/null
+++ b/hauth/Hybrid/thirdparty/OAuth/OAuth2Client.php
@@ -0,0 +1,302 @@
+<?php
+/**
+* HybridAuth
+* http://hybridauth.sourceforge.net | http://github.com/hybridauth/hybridauth
+* (c) 2009-2015, HybridAuth authors | http://hybridauth.sourceforge.net/licenses.html
+*/
+
+// A service client for the OAuth 2 flow.
+// v0.1.1
+class OAuth2Client
+{
+  public $api_base_url     = "";
+  public $authorize_url    = "";
+  public $token_url        = "";
+  public $token_info_url   = "";
+
+  public $client_id        = "" ;
+  public $client_secret    = "" ;
+  public $redirect_uri     = "" ;
+  public $access_token     = "" ;
+  public $refresh_token    = "" ;
+
+  public $access_token_expires_in = "" ;
+  public $access_token_expires_at = "" ;
+
+  //--
+
+  public $sign_token_name          = "access_token";
+  public $curl_time_out            = 30;
+  public $curl_connect_time_out    = 30;
+  public $curl_ssl_verifypeer      = false;
+  public $curl_ssl_verifyhost      = false;
+  public $curl_header              = array();
+  public $curl_useragent           = "OAuth/2 Simple PHP Client v0.1.1; HybridAuth http://hybridauth.sourceforge.net/";
+  public $curl_authenticate_method = "POST";
+  public $curl_proxy               = null;
+  public $curl_compressed          = false;
+  //--
+
+  public $http_code             = "";
+  public $http_info             = "";
+  protected $response           = null;
+
+  //--
+
+  public function __construct( $client_id = false, $client_secret = false, $redirect_uri='', $compressed = false )
+  {
+    $this->client_id       = $client_id;
+    $this->client_secret   = $client_secret;
+    $this->redirect_uri    = $redirect_uri;
+    $this->curl_compressed = $compressed;
+  }
+
+  public function authorizeUrl( $extras = array() )
+  {
+    $params = array(
+      "client_id"     => $this->client_id,
+      "redirect_uri"  => $this->redirect_uri,
+      "response_type" => "code"
+    );
+
+    if( count($extras) )
+      foreach( $extras as $k=>$v )
+        $params[$k] = $v;
+
+    return $this->authorize_url . "?" . http_build_query($params, '', '&');
+  }
+
+  public function authenticate( $code )
+  {
+    $params = array(
+      "client_id"     => $this->client_id,
+      "client_secret" => $this->client_secret,
+      "grant_type"    => "authorization_code",
+      "redirect_uri"  => $this->redirect_uri,
+      "code"          => $code
+    );
+
+    $response = $this->request( $this->token_url, $params, $this->curl_authenticate_method );
+
+    $response = $this->parseRequestResult( $response );
+
+    if( ! $response || ! isset( $response->access_token ) ){
+      throw new Exception( "The Authorization Service has return: " . $response->error );
+    }
+
+    if( isset( $response->access_token  ) )  $this->access_token           = $response->access_token;
+    if( isset( $response->refresh_token ) ) $this->refresh_token           = $response->refresh_token;
+    if( isset( $response->expires_in    ) ) $this->access_token_expires_in = $response->expires_in;
+
+    // calculate when the access token expire
+    if( isset($response->expires_in)) {
+      $this->access_token_expires_at = time() + $response->expires_in;
+    }
+
+    return $response;
+  }
+
+  public function authenticated()
+  {
+    if ( $this->access_token ){
+      if ( $this->token_info_url && $this->refresh_token ){
+        // check if this access token has expired,
+        $tokeninfo = $this->tokenInfo( $this->access_token );
+
+        // if yes, access_token has expired, then ask for a new one
+        if( $tokeninfo && isset( $tokeninfo->error ) ){
+          $response = $this->refreshToken( $this->refresh_token );
+
+          // if wrong response
+          if( ! isset( $response->access_token ) || ! $response->access_token ){
+            throw new Exception( "The Authorization Service has return an invalid response while requesting a new access token. given up!" );
+          }
+
+          // set new access_token
+          $this->access_token = $response->access_token;
+        }
+      }
+
+      return true;
+    }
+
+    return false;
+  }
+
+  /**
+  * Format and sign an oauth for provider api
+  */
+  public function api( $url, $method = "GET", $parameters = array(), $decode_json = true )
+  {
+    if ( strrpos($url, 'http://') !== 0 && strrpos($url, 'https://') !== 0 ) {
+      $url = $this->api_base_url . $url;
+    }
+
+    $parameters[$this->sign_token_name] = $this->access_token;
+    $response = null;
+
+    switch( $method ){
+      case 'GET'  : $response = $this->request( $url, $parameters, "GET"  ); break;
+      case 'POST' : $response = $this->request( $url, $parameters, "POST" ); break;
+      case 'DELETE' : $response = $this->request( $url, $parameters, "DELETE" ); break;
+      case 'PATCH'  : $response = $this->request( $url, $parameters, "PATCH" ); break;
+    }
+
+    if( $response && $decode_json ){
+      return $this->response = json_decode( $response );
+    }
+
+    return $this->response = $response;
+  }
+
+  /**
+   * Return the response object afer the fact
+   *
+   * @return mixed
+   */
+  public function getResponse()
+  {
+      return $this->response;
+  }
+
+  /**
+  * GET wrapper for provider apis request
+  */
+  function get( $url, $parameters = array(), $decode_json = true )
+  {
+    return $this->api( $url, 'GET', $parameters, $decode_json );
+  }
+
+  /**
+  * POST wrapper for provider apis request
+  */
+  function post( $url, $parameters = array(), $decode_json = true )
+  {
+    return $this->api( $url, 'POST', $parameters, $decode_json );
+  }
+
+  // -- tokens
+
+  public function tokenInfo($accesstoken)
+  {
+    $params['access_token'] = $this->access_token;
+    $response = $this->request( $this->token_info_url, $params );
+    return $this->parseRequestResult( $response );
+  }
+
+  public function refreshToken( $parameters = array() )
+  {
+    $params = array(
+      "client_id"     => $this->client_id,
+      "client_secret" => $this->client_secret,
+      "grant_type"    => "refresh_token"
+    );
+
+    foreach($parameters as $k=>$v ){
+      $params[$k] = $v;
+    }
+
+    $response = $this->request( $this->token_url, $params, "POST" );
+    return $this->parseRequestResult( $response );
+  }
+
+  // -- utilities
+
+  private function request( $url, $params=false, $type="GET" )
+  {
+    Hybrid_Logger::info( "Enter OAuth2Client::request( $url )" );
+    Hybrid_Logger::debug( "OAuth2Client::request(). dump request params: ", serialize( $params ) );
+
+	$urlEncodedParams = http_build_query($params, '', '&');
+
+    if( $type == "GET" ){
+      $url = $url . ( strpos( $url, '?' ) ? '&' : '?' ) . $urlEncodedParams;
+    }
+
+    $this->http_info = array();
+    $ch = curl_init();
+
+    curl_setopt($ch, CURLOPT_URL            , $url );
+    curl_setopt($ch, CURLOPT_RETURNTRANSFER , 1 );
+    curl_setopt($ch, CURLOPT_TIMEOUT        , $this->curl_time_out );
+    curl_setopt($ch, CURLOPT_USERAGENT      , $this->curl_useragent );
+    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT , $this->curl_connect_time_out );
+    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER , $this->curl_ssl_verifypeer );
+    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST , $this->curl_ssl_verifyhost );
+    curl_setopt($ch, CURLOPT_HTTPHEADER     , $this->curl_header );
+
+    if ($this->curl_compressed){
+      curl_setopt($ch, CURLOPT_ENCODING, "gzip,deflate");
+    }
+
+    if($this->curl_proxy){
+      curl_setopt( $ch, CURLOPT_PROXY        , $this->curl_proxy);
+    }
+
+    if ($type == "POST") {
+      curl_setopt($ch, CURLOPT_POST, 1);
+
+      // If request body exists then encode it for "application/json".
+      if (isset($params['body'])) {
+        $urlEncodedParams = json_encode($params['body']);
+      }
+
+      // Using URL encoded params here instead of a more convenient array
+      // cURL will set a wrong HTTP Content-Type header if using an array (cf. http://www.php.net/manual/en/function.curl-setopt.php, Notes section for "CURLOPT_POSTFIELDS")
+      // OAuth requires application/x-www-form-urlencoded Content-Type (cf. https://tools.ietf.org/html/rfc6749#section-2.3.1)
+      if ($params) {
+        curl_setopt($ch, CURLOPT_POSTFIELDS, $urlEncodedParams);
+      }
+    }
+
+    if( $type == "DELETE" ){
+        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
+    }
+    if( $type == "PATCH" ){
+      curl_setopt($ch, CURLOPT_POST, 1);
+      if($params) curl_setopt( $ch, CURLOPT_POSTFIELDS, $params );
+      curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
+    }
+    $response = curl_exec($ch);
+    if( $response === false ) {
+        Hybrid_Logger::error( "OAuth2Client::request(). curl_exec error: ", curl_error($ch) );
+    }
+    Hybrid_Logger::debug( "OAuth2Client::request(). dump request info: ", serialize( curl_getinfo($ch) ) );
+    Hybrid_Logger::debug( "OAuth2Client::request(). dump request result: ", serialize( $response ) );
+
+    $this->http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+    $this->http_info = array_merge($this->http_info, curl_getinfo($ch));
+
+    curl_close ($ch);
+
+    return $response;
+  }
+
+  private function parseRequestResult( $result )
+  {
+    if( json_decode( $result ) ) return json_decode( $result );
+
+    parse_str( $result, $output );
+
+    $result = new StdClass();
+
+    foreach( $output as $k => $v )
+      $result->$k = $v;
+
+    return $result;
+  }
+  /**
+ * DELETE wrapper for provider apis request
+ */
+ function delete( $url, $parameters = array() )
+ {
+   return $this->api( $url, 'DELETE', $parameters );
+ }
+ /**
+ * PATCH wrapper for provider apis request
+ */
+ function patch( $url, $parameters = array() )
+ {
+    return $this->api( $url, 'PATCH', $parameters );
+ }
+}