Added Docusign to the Oauth2 service implementation list

README.md

@@ -68,6 +68,7 @@ Included service implementations
     - Delicious
     - Deezer
     - DeviantArt
+    - Docusign
     - Dropbox
     - Eve Online
     - Facebook

examples/docusign.php

@@ -0,0 +1,52 @@
+<?php
+
+/**
+ * Example of retrieving an authentication token of the Docusign service
+ *
+ * PHP version 5.4
+ *
+ * @author     Naveen Gopala <[email protected]>
+ * @copyright  Copyright (c) 2017 The authors
+ * @license    http://www.opensource.org/licenses/mit-license.html  MIT License
+ */
+
+use OAuth\OAuth2\Service\Docusign;
+use OAuth\Common\Storage\Session;
+use OAuth\Common\Consumer\Credentials;
+
+/**
+ * Bootstrap the example
+ */
+require_once __DIR__ . '/bootstrap.php';
+
+// Session storage
+$storage = new Session();
+
+// Setup the credentials for the requests
+$credentials = new Credentials(
+    $servicesCredentials['docusign']['key'],
+    $servicesCredentials['docusign']['secret'],
+    $currentUri->getAbsoluteUri()
+);
+
+// Instantiate the Docusign service using the credentials, http client, storage mechanism for the token and profile scope
+/** @var $docusignService Docusign */
+$docusignService = $serviceFactory->createService('docusign', $credentials, $storage, array('signature'));
+
+if (!empty($_GET['code'])) {
+    // This was a callback request from Docusign, get the token
+    $token = $docusignService->requestAccessToken($_GET['code']);
+
+    // Send a request with it
+    $result = json_decode($docusignService->request('/oauth/userinfo'), true);
+
+    // Show some of the resultant data
+    echo 'Your unique Docusign user id is: ' . $result['accounts'][0]['account_id'] . ' and your name is ' . $result['name'];
+
+} elseif (!empty($_GET['go']) && $_GET['go'] === 'go') {
+    $url = $docusignService->getAuthorizationUri();
+    header('Location: ' . $url);
+} else {
+    $url = $currentUri->getRelativeUri() . '?go=go';
+    echo "<a href='$url'>Login with Docusign!</a>";
+}

examples/init.example.php

@@ -59,6 +59,10 @@
         'key'       => '',
         'secret'    => '',
     ),
+    'docusign' => array(
+        'key'       => '',
+        'secret'    => '',
+    ),
     'dropbox' => array(
         'key'       => '',
         'secret'    => '',

src/OAuth/OAuth2/Service/Docusign.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace OAuth\OAuth2\Service;
+
+use OAuth\OAuth2\Token\StdOAuth2Token;
+use OAuth\Common\Http\Exception\TokenResponseException;
+use OAuth\Common\Http\Uri\Uri;
+use OAuth\Common\Consumer\CredentialsInterface;
+use OAuth\Common\Http\Client\ClientInterface;
+use OAuth\Common\Storage\TokenStorageInterface;
+use OAuth\Common\Http\Uri\UriInterface;
+
+/**
+ * Docusign service.
+ *
+ * @author Naveen Gopala <[email protected]>
+ * @link https://images-na.ssl-images-docusign.com/images/G/01/lwa/dev/docs/website-developer-guide._TTH_.pdf
+ */
+class Docusign extends AbstractService
+{
+    /**
+     * Defined scopes
+     * @link https://images-na.ssl-images-docusign.com/images/G/01/lwa/dev/docs/website-developer-guide._TTH_.pdf
+     */
+    const SCOPE_SIGNATURE     = 'signature';
+
+    public function __construct(
+        CredentialsInterface $credentials,
+        ClientInterface $httpClient,
+        TokenStorageInterface $storage,
+        $scopes = array(),
+        UriInterface $baseApiUri = null
+    ) {
+        parent::__construct($credentials, $httpClient, $storage, $scopes, $baseApiUri);
+
+        if (null === $baseApiUri) {
+            // account-d.docusign.com for the developer sandbox
+            // account.docusign.com for the production platform.
+            $this->baseApiUri = new Uri('https://account-d.docusign.com');
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getAuthorizationUri(array $additionalParameters = array())
+    {
+        $parameters = array_merge(
+            $additionalParameters,
+            array(
+                'client_id'     => $this->credentials->getConsumerId(),
+                'redirect_uri'  => $this->credentials->getCallbackUrl(),
+                'response_type' => 'code',
+            )
+        );
+
+        $parameters['scope'] = implode(' ', $this->scopes);
+
+        // Build the url
+        $url = clone $this->getAuthorizationEndpoint();
+        foreach ($parameters as $key => $val) {
+            $url->addToQuery($key, $val);
+        }
+
+        return $url;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getAuthorizationEndpoint()
+    {
+        return new Uri('https://account-d.docusign.com/oauth/auth');
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getAccessTokenEndpoint()
+    {
+        return new Uri('https://account-d.docusign.com/oauth/token');
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function getAuthorizationMethod()
+    {
+        return static::AUTHORIZATION_METHOD_HEADER_BEARER;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function parseAccessTokenResponse($responseBody)
+    {
+        $data = json_decode($responseBody, true);
+
+        if (null === $data || !is_array($data)) {
+            throw new TokenResponseException('Unable to parse response.');
+        } elseif (isset($data['error_description'])) {
+            throw new TokenResponseException('Error in retrieving token: "' . $data['error_description'] . '"');
+        } elseif (isset($data['error'])) {
+            throw new TokenResponseException('Error in retrieving token: "' . $data['error'] . '"');
+        }
+
+        $token = new StdOAuth2Token();
+        $token->setAccessToken($data['access_token']);
+        $token->setLifeTime($data['expires_in']);
+
+        if (isset($data['refresh_token'])) {
+            $token->setRefreshToken($data['refresh_token']);
+            unset($data['refresh_token']);
+        }
+
+        unset($data['access_token']);
+        unset($data['expires_in']);
+
+        $token->setExtraParams($data);
+
+        return $token;
+    }
+}