xref: /plugin/oauth/helper.php (revision 551dc73172957cdbba718580d83d3064ede09577)
180852c15SAndreas Gohr<?php
280852c15SAndreas Gohr/**
380852c15SAndreas Gohr * DokuWiki Plugin oauth (Helper Component)
480852c15SAndreas Gohr *
580852c15SAndreas Gohr * @license GPL 2 http://www.gnu.org/licenses/gpl-2.0.html
680852c15SAndreas Gohr * @author  Andreas Gohr <andi@splitbrain.org>
780852c15SAndreas Gohr */
880852c15SAndreas Gohr
980852c15SAndreas Gohr// must be run within Dokuwiki
1080852c15SAndreas Gohrif(!defined('DOKU_INC')) die();
1180852c15SAndreas Gohr
1280852c15SAndreas Gohrclass helper_plugin_oauth extends DokuWiki_Plugin {
1380852c15SAndreas Gohr
1480852c15SAndreas Gohr    /**
15f10e09e2SAndreas Gohr     * Load the needed libraries and initialize the named oAuth service
1680852c15SAndreas Gohr     *
17f10e09e2SAndreas Gohr     * @param string $servicename
1863b91737SAndreas Gohr     * @return null|\OAuth\Plugin\AbstractAdapter
1980852c15SAndreas Gohr     */
20a7a8f46aSAndreas Gohr    public function loadService(&$servicename) {
2167e2b52dSAndreas Gohr        $id = getID(); // $ID isn't set in trustExternal, yet
22f10e09e2SAndreas Gohr
23f10e09e2SAndreas Gohr        $servicename = preg_replace('/[^a-zA-Z_]+/', '', $servicename);
24f10e09e2SAndreas Gohr        if(!$servicename) return null;
25f10e09e2SAndreas Gohr
26f10e09e2SAndreas Gohr        require_once(__DIR__.'/phpoauthlib/src/OAuth/bootstrap.php');
2763b91737SAndreas Gohr        require_once(__DIR__.'/classes/AbstractAdapter.php');
28f10e09e2SAndreas Gohr        require_once(__DIR__.'/classes/oAuthHTTPClient.php');
29*551dc731SAndreas Gohr        require_once(__DIR__.'/classes/oAuthStorage.php');
30f10e09e2SAndreas Gohr
3163b91737SAndreas Gohr        $file = __DIR__.'/classes/'.$servicename.'Adapter.php';
32f10e09e2SAndreas Gohr        if(!file_exists($file)) return null;
33f10e09e2SAndreas Gohr        require_once($file);
3463b91737SAndreas Gohr        $class = '\\OAuth\\Plugin\\'.$servicename.'Adapter';
35f10e09e2SAndreas Gohr
3663b91737SAndreas Gohr        /** @var \OAuth\Plugin\AbstractAdapter $service */
372e94f0b8SAndreas Gohr        $service = new $class($this->redirectURI());
38f10e09e2SAndreas Gohr        if(!$service->isInitialized()) {
39f10e09e2SAndreas Gohr            msg("Failed to initialize $service authentication service. Check credentials", -1);
40f10e09e2SAndreas Gohr            return null;
41f10e09e2SAndreas Gohr        }
42f10e09e2SAndreas Gohr
43a90c044eSAndreas Gohr        // The generic service can be externally configured
44a90c044eSAndreas Gohr        if(is_a($service->oAuth, 'OAuth\\OAuth2\\Service\\Generic')) {
45a90c044eSAndreas Gohr            $service->oAuth->setAuthorizationEndpoint($this->getAuthEndpoint($servicename));
46a90c044eSAndreas Gohr            $service->oAuth->setAccessTokenEndpoint($this->getTokenEndpoint($servicename));
47a90c044eSAndreas Gohr        }
48a90c044eSAndreas Gohr
49f10e09e2SAndreas Gohr        return $service;
50f10e09e2SAndreas Gohr    }
51f10e09e2SAndreas Gohr
52a90c044eSAndreas Gohr    /**
53a90c044eSAndreas Gohr     * The redirect URI used in all oAuth requests
54a90c044eSAndreas Gohr     *
55a90c044eSAndreas Gohr     * @return string
56a90c044eSAndreas Gohr     */
572e94f0b8SAndreas Gohr    public function redirectURI() {
582e94f0b8SAndreas Gohr        return DOKU_URL.DOKU_SCRIPT;
592e94f0b8SAndreas Gohr    }
602e94f0b8SAndreas Gohr
61dfbdd519SAndreas Gohr    /**
62dfbdd519SAndreas Gohr     * List available Services
63dfbdd519SAndreas Gohr     *
643c0138dbSAndreas Gohr     * @param bool $enabledonly list only enabled services
65dfbdd519SAndreas Gohr     * @return array
66dfbdd519SAndreas Gohr     */
673c0138dbSAndreas Gohr    public function listServices($enabledonly = true) {
68dfbdd519SAndreas Gohr        $services = array();
6963b91737SAndreas Gohr        $files    = glob(__DIR__.'/classes/*Adapter.php');
70dfbdd519SAndreas Gohr
71dfbdd519SAndreas Gohr        foreach($files as $file) {
7263b91737SAndreas Gohr            $file = basename($file, 'Adapter.php');
73dfbdd519SAndreas Gohr            if($file == 'Abstract') continue;
743c0138dbSAndreas Gohr            if($enabledonly && !$this->getKey($file)) continue;
75dfbdd519SAndreas Gohr            $services[] = $file;
76dfbdd519SAndreas Gohr        }
77dfbdd519SAndreas Gohr
78dfbdd519SAndreas Gohr        return $services;
79dfbdd519SAndreas Gohr    }
80f10e09e2SAndreas Gohr
81f10e09e2SAndreas Gohr    /**
82f10e09e2SAndreas Gohr     * Return the configured key for the given service
83f10e09e2SAndreas Gohr     *
84f10e09e2SAndreas Gohr     * @param $service
85f10e09e2SAndreas Gohr     * @return string
86f10e09e2SAndreas Gohr     */
87f10e09e2SAndreas Gohr    public function getKey($service) {
88f10e09e2SAndreas Gohr        $service = strtolower($service);
89f10e09e2SAndreas Gohr        return $this->getConf($service.'-key');
90f10e09e2SAndreas Gohr    }
91f10e09e2SAndreas Gohr
92f10e09e2SAndreas Gohr    /**
93f10e09e2SAndreas Gohr     * Return the configured secret for the given service
94f10e09e2SAndreas Gohr     *
95f10e09e2SAndreas Gohr     * @param $service
96f10e09e2SAndreas Gohr     * @return string
97f10e09e2SAndreas Gohr     */
98f10e09e2SAndreas Gohr    public function getSecret($service) {
99f10e09e2SAndreas Gohr        $service = strtolower($service);
100f10e09e2SAndreas Gohr        return $this->getConf($service.'-secret');
10180852c15SAndreas Gohr    }
10280852c15SAndreas Gohr
103a90c044eSAndreas Gohr    /**
104a90c044eSAndreas Gohr     * Return the configured Authentication Endpoint URL for the given service
105a90c044eSAndreas Gohr     *
106a90c044eSAndreas Gohr     * @param $service
107a90c044eSAndreas Gohr     * @return string
108a90c044eSAndreas Gohr     */
109a90c044eSAndreas Gohr    public function getAuthEndpoint($service) {
110a90c044eSAndreas Gohr        $service = strtolower($service);
111a90c044eSAndreas Gohr        return $this->getConf($service.'-authurl');
112a90c044eSAndreas Gohr    }
113a90c044eSAndreas Gohr
114a90c044eSAndreas Gohr    /**
115a90c044eSAndreas Gohr     * Return the configured Access Token Endpoint URL for the given service
116a90c044eSAndreas Gohr     *
117a90c044eSAndreas Gohr     * @param $service
118a90c044eSAndreas Gohr     * @return string
119a90c044eSAndreas Gohr     */
120a90c044eSAndreas Gohr    public function getTokenEndpoint($service) {
121a90c044eSAndreas Gohr        $service = strtolower($service);
122a90c044eSAndreas Gohr        return $this->getConf($service.'-tokenurl');
123a90c044eSAndreas Gohr    }
12480852c15SAndreas Gohr}
12580852c15SAndreas Gohr
12680852c15SAndreas Gohr// vim:ts=4:sw=4:et:
127