. /** * ActivityPub implementation for GNU social * * @package GNUsocial * @author Diogo Cordeiro * @copyright 2018-2019 Free Software Foundation, Inc http://www.fsf.org * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later * @link http://www.gnu.org/software/social/ */ defined('GNUSOCIAL') || die(); /** * ActivityPub's own Postman * * Standard workflow expects that we send an Explorer to find out destinataries' * inbox address. Then we send our postman to deliver whatever we want to send them. * * @category Plugin * @package GNUsocial * @author Diogo Cordeiro * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later */ class Activitypub_postman { private $actor; private $actor_uri; private $to = []; private $client; private $headers; /** * Create a postman to deliver something to someone * * @param Profile $from Profile of sender * @param $to * @throws Exception * @author Diogo Cordeiro */ public function __construct($from, $to) { $this->actor = $from; $discovery = new Activitypub_explorer(); $this->to = $to; $followers = apActorFollowersAction::generate_followers($this->actor, 0, null); foreach ($followers as $sub) { try { $to[]= Activitypub_profile::from_profile($discovery->lookup($sub)[0]); } catch (Exception $e) { // Not an ActivityPub Remote Follower, let it go } } unset($discovery); $this->actor_uri = ActivityPubPlugin::actor_uri($this->actor); $this->client = new HTTPClient(); } /** * Send something to remote instance * * @param string $data request body * @param string $inbox url of remote inbox * @param string $method request method * @return GNUsocial_HTTPResponse * @throws HTTP_Request2_Exception * @throws Exception * @author Diogo Cordeiro */ public function send($data, $inbox, $method = 'POST') { common_debug('ActivityPub Postman: Delivering '.$data.' to '.$inbox); $headers = HttpSignature::sign($this->actor, $inbox, $data); common_debug('ActivityPub Postman: Delivery headers were: '.print_r($headers, true)); $this->client->setBody($data); switch ($method) { case 'POST': $response = $this->client->post($inbox, $headers); break; case 'GET': $response = $this->client->get($inbox, $headers); break; default: throw new Exception("Unsupported request method for postman."); } common_debug('ActivityPub Postman: Delivery result with status code '.$response->getStatus().': '.$response->getBody()); return $response; } /** * Send a follow notification to remote instance * * @return bool * @throws HTTP_Request2_Exception * @throws Exception * @author Diogo Cordeiro */ public function follow() { $data = Activitypub_follow::follow_to_array(ActivityPubPlugin::actor_uri($this->actor), $this->to[0]->getUrl()); $res = $this->send(json_encode($data, JSON_UNESCAPED_SLASHES), $this->to[0]->get_inbox()); $res_body = json_decode($res->getBody()); if ($res->getStatus() == 200 || $res->getStatus() == 202 || $res->getStatus() == 409) { $pending_list = new Activitypub_pending_follow_requests($this->actor->getID(), $this->to[0]->getID()); $pending_list->add(); return true; } elseif (isset($res_body[0]->error)) { throw new Exception($res_body[0]->error); } throw new Exception("An unknown error occurred."); } /** * Send a Undo Follow notification to remote instance * * @return bool * @throws HTTP_Request2_Exception * @throws Exception * @throws Exception * @throws Exception * @throws Exception * @author Diogo Cordeiro */ public function undo_follow() { $data = Activitypub_undo::undo_to_array( Activitypub_follow::follow_to_array( ActivityPubPlugin::actor_uri($this->actor), $this->to[0]->getUrl() ) ); $res = $this->send(json_encode($data, JSON_UNESCAPED_SLASHES), $this->to[0]->get_inbox()); $res_body = json_decode($res->getBody()); if ($res->getStatus() == 200 || $res->getStatus() == 202 || $res->getStatus() == 409) { $pending_list = new Activitypub_pending_follow_requests($this->actor->getID(), $this->to[0]->getID()); $pending_list->remove(); return true; } if (isset($res_body[0]->error)) { throw new Exception($res_body[0]->error); } throw new Exception("An unknown error occurred."); } /** * Send a Accept Follow notification to remote instance * * @return bool * @throws HTTP_Request2_Exception * @throws Exception * @throws Exception * @throws Exception * @throws Exception * @author Diogo Cordeiro */ public function accept_follow() { $data = Activitypub_accept::accept_to_array( Activitypub_follow::follow_to_array( $this->to[0]->getUrl(), ActivityPubPlugin::actor_uri($this->actor) ) ); $res = $this->send(json_encode($data, JSON_UNESCAPED_SLASHES), $this->to[0]->get_inbox()); $res_body = json_decode($res->getBody()); if ($res->getStatus() == 200 || $res->getStatus() == 202 || $res->getStatus() == 409) { $pending_list = new Activitypub_pending_follow_requests($this->actor->getID(), $this->to[0]->getID()); $pending_list->remove(); return true; } if (isset($res_body[0]->error)) { throw new Exception($res_body[0]->error); } throw new Exception("An unknown error occurred."); } /** * Send a Like notification to remote instances holding the notice * * @param Notice $notice * @throws HTTP_Request2_Exception * @throws InvalidUrlException * @throws Exception * @author Diogo Cordeiro */ public function like($notice) { $data = Activitypub_like::like_to_array( ActivityPubPlugin::actor_uri($this->actor), $notice->getUrl() ); $data = json_encode($data, JSON_UNESCAPED_SLASHES); foreach ($this->to_inbox() as $inbox) { $this->send($data, $inbox); } } /** * Send a Undo Like notification to remote instances holding the notice * * @param Notice $notice * @throws HTTP_Request2_Exception * @throws InvalidUrlException * @throws Exception * @author Diogo Cordeiro */ public function undo_like($notice) { $data = Activitypub_undo::undo_to_array( Activitypub_like::like_to_array( ActivityPubPlugin::actor_uri($this->actor), $notice->getUrl() ) ); $data = json_encode($data, JSON_UNESCAPED_SLASHES); foreach ($this->to_inbox() as $inbox) { $this->send($data, $inbox); } } /** * Send a Create notification to remote instances * * @param Notice $notice * @throws EmptyPkeyValueException * @throws HTTP_Request2_Exception * @throws InvalidUrlException * @throws ServerException * @author Diogo Cordeiro */ public function create_note($notice) { $data = Activitypub_create::create_to_array( $this->actor_uri, Activitypub_notice::notice_to_array($notice) ); $data = json_encode($data, JSON_UNESCAPED_SLASHES); foreach ($this->to_inbox() as $inbox) { $this->send($data, $inbox); } } /** * Send a Announce notification to remote instances * * @param Notice $notice * @throws HTTP_Request2_Exception * @throws Exception * @author Diogo Cordeiro */ public function announce($notice) { $data = Activitypub_announce::announce_to_array( ActivityPubPlugin::actor_uri($this->actor), $notice->getUri() ); $data = json_encode($data, JSON_UNESCAPED_SLASHES); foreach ($this->to_inbox() as $inbox) { $this->send($data, $inbox); } } /** * Send a Delete notification to remote instances holding the notice * * @param Notice $notice * @throws HTTP_Request2_Exception * @throws InvalidUrlException * @throws Exception * @throws Exception * @author Diogo Cordeiro */ public function delete($notice) { $data = Activitypub_delete::delete_to_array( ActivityPubPlugin::actor_uri($notice->getProfile()), $notice->getUrl() ); $errors = []; $data = json_encode($data, JSON_UNESCAPED_SLASHES); foreach ($this->to_inbox() as $inbox) { $res = $this->send($data, $inbox); if (!$res->getStatus() == 200) { $res_body = json_decode($res->getBody(), true); if (isset($res_body[0]['error'])) { $errors[] = ($res_body[0]['error']); continue; } $errors[] = ("An unknown error occurred."); } } if (!empty($errors)) { throw new Exception(json_encode($errors)); } } /** * Clean list of inboxes to deliver messages * * @author Diogo Cordeiro * @return array To Inbox URLs */ private function to_inbox() { $to_inboxes = []; foreach ($this->to as $to_profile) { $i = $to_profile->get_inbox(); // Prevent delivering to self if ($i == [common_local_url('apInbox')]) { continue; } $to_inboxes[] = $i; } return array_unique($to_inboxes); } }