3 * StatusNet - the distributed open-source microblogging tool
4 * Copyright (C) 2010, StatusNet, Inc.
6 * A sample module to show best practices for StatusNet plugins
10 * This program is free software: you can redistribute it and/or modify
11 * it under the terms of the GNU Affero General Public License as published by
12 * the Free Software Foundation, either version 3 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU Affero General Public License for more details.
20 * You should have received a copy of the GNU Affero General Public License
21 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * @author James Walker <james@status.net>
25 * @copyright 2010 StatusNet, Inc.
26 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
27 * @link http://status.net/
30 define('WEBFINGER_SERVICE_REL_VALUE', 'lrdd');
33 * Implement the webfinger protocol.
38 * Perform a webfinger lookup given an account.
40 public function lookup($id)
42 $id = $this->normalize($id);
43 list($name, $domain) = explode('@', $id);
45 $links = $this->getServiceLinks($domain);
51 foreach ($links as $link) {
52 if ($link['template']) {
53 return $this->getServiceDescription($link['template'], $id);
56 return $this->getServiceDescription($link['href'], $id);
62 * Normalize an account ID
64 function normalize($id)
66 if (substr($id, 0, 7) == 'acct://') {
67 return substr($id, 7);
68 } else if (substr($id, 0, 5) == 'acct:') {
69 return substr($id, 5);
75 function getServiceLinks($domain)
77 $url = 'http://'. $domain .'/.well-known/host-meta';
78 $content = $this->fetchURL($url);
79 if (empty($content)) {
80 common_log(LOG_DEBUG, 'Error fetching host-meta');
83 $result = XRD::parse($content);
85 // Ensure that the host == domain (spec may include signing later)
86 if ($result->host != $domain) {
91 foreach ($result->links as $link) {
92 if ($link['rel'] == WEBFINGER_SERVICE_REL_VALUE) {
100 function getServiceDescription($template, $id)
102 $url = $this->applyTemplate($template, 'acct:' . $id);
104 $content = $this->fetchURL($url);
106 return XRD::parse($content);
109 function fetchURL($url)
112 $client = new HTTPClient();
113 $response = $client->get($url);
114 } catch (HTTP_Request2_Exception $e) {
118 if ($response->getStatus() != 200) {
122 return $response->getBody();
125 function applyTemplate($template, $id)
127 $template = str_replace('{uri}', urlencode($id), $template);
132 function getHostMeta($domain, $template) {
134 $xrd->host = $domain;
135 $xrd->links[] = array('rel' => 'lrdd',
136 'template' => $template,
137 'title' => array('Resource Descriptor'));
139 return $xrd->toXML();