plugins/Diaspora/DiasporaPlugin.php

   1 <?php
   2 /*
   3  * GNU Social - a federating social network
   4  * Copyright (C) 2015, Free Software Foundation, Inc.
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU Affero General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU Affero General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Affero General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 if (!defined('GNUSOCIAL')) { exit(1); }
  21
  22 /**
  23  * Diaspora federation protocol plugin for GNU Social
  24  *
  25  * Depends on:
  26  *  - OStatus plugin
  27  *  - WebFinger plugin
  28  *
  29  * @package ProtocolDiasporaPlugin
  30  * @maintainer Mikael Nordfeldth <mmn@hethane.se>
  31  */
  32
  33 class DiasporaPlugin extends Plugin
  34 {
  35     const REL_SEED_LOCATION = 'http://joindiaspora.com/seed_location';
  36     const REL_GUID          = 'http://joindiaspora.com/guid';
  37     const REL_PUBLIC_KEY    = 'diaspora-public-key';
  38
  39     public function onEndAttachPubkeyToUserXRD(Magicsig $magicsig, XML_XRD $xrd, Profile $target)
  40     {
  41         // So far we've only handled RSA keys, but it can change in the future,
  42         // so be prepared. And remember to change the statically assigned type attribute below!
  43         assert($magicsig->publicKey instanceof Crypt_RSA);
  44         $xrd->links[] = new XML_XRD_Element_Link(self::REL_PUBLIC_KEY,
  45                                     base64_encode($magicsig->exportPublicKey()), 'RSA');
  46
  47         // Instead of choosing a random string, we calculate our GUID from the public key
  48         // by fingerprint through a sha256 hash.
  49         $xrd->links[] = new XML_XRD_Element_Link(self::REL_GUID,
  50                                     strtolower($magicsig->toFingerprint()));
  51     }
  52
  53     public function onPluginVersion(array &$versions)
  54     {
  55         $versions[] = array('name' => 'Diaspora',
  56                             'version' => '0.1',
  57                             'author' => 'Mikael Nordfeldth',
  58                             'homepage' => 'https://gnu.io/social',
  59                             // TRANS: Plugin description.
  60                             'rawdescription' => _m('Follow people across social networks that implement '.
  61                                'the <a href="https://diasporafoundation.org/">Diaspora</a> federation protocol.'));
  62
  63         return true;
  64     }
  65 }