]> git.mxchange.org Git - friendica.git/blobdiff - src/Util/HTTPSignature.php
Add new contact/{id}/contacts[/{type}] route and module
[friendica.git] / src / Util / HTTPSignature.php
index d5e1732c08635243ca71abd08888dc078ebb593e..89da59ba26012911842589abe1e8768a4130a63a 100644 (file)
@@ -1,17 +1,34 @@
 <?php
-
 /**
- * @file src/Util/HTTPSignature.php
+ * @copyright Copyright (C) 2020, Friendica
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
  */
+
 namespace Friendica\Util;
 
-use Friendica\Core\Config;
 use Friendica\Core\Logger;
-use Friendica\Model\User;
+use Friendica\Database\DBA;
+use Friendica\DI;
 use Friendica\Model\APContact;
+use Friendica\Model\User;
 
 /**
- * @brief Implements HTTP Signatures per draft-cavage-http-signatures-07.
+ * Implements HTTP Signatures per draft-cavage-http-signatures-07.
  *
  * Ported from Hubzilla: https://framagit.org/hubzilla/core/blob/master/Zotlabs/Web/HTTPSig.php
  *
@@ -25,7 +42,7 @@ class HTTPSignature
 {
        // See draft-cavage-http-signatures-08
        /**
-        * @brief Verifies a magic request
+        * Verifies a magic request
         *
         * @param $key
         *
@@ -110,8 +127,6 @@ class HTTPSignature
        }
 
        /**
-        * @brief
-        *
         * @param array   $head
         * @param string  $prvkey
         * @param string  $keyid (optional, default 'Key')
@@ -144,8 +159,6 @@ class HTTPSignature
        }
 
        /**
-        * @brief
-        *
         * @param array  $head
         * @param string $prvkey
         * @param string $alg (optional) default 'sha256'
@@ -177,11 +190,11 @@ class HTTPSignature
        }
 
        /**
-        * @brief
-        *
         * @param string $header
-        * @return array associate array with
+        * @return array associative array with
         *   - \e string \b keyID
+        *   - \e string \b created
+        *   - \e string \b expires
         *   - \e string \b algorithm
         *   - \e array  \b headers
         *   - \e string \b signature
@@ -189,80 +202,55 @@ class HTTPSignature
         */
        public static function parseSigheader($header)
        {
-               $ret = [];
-               $matches = [];
+               // Remove obsolete folds
+               $header = preg_replace('/\n\s+/', ' ', $header);
 
-               // if the header is encrypted, decrypt with (default) site private key and continue
-               if (preg_match('/iv="(.*?)"/ism', $header, $matches)) {
-                       $header = self::decryptSigheader($header);
-               }
+               $token = "[!#$%&'*+.^_`|~0-9A-Za-z-]";
 
-               if (preg_match('/keyId="(.*?)"/ism', $header, $matches)) {
-                       $ret['keyId'] = $matches[1];
-               }
+               $quotedString = '"(?:\\\\.|[^"\\\\])*"';
 
-               if (preg_match('/algorithm="(.*?)"/ism', $header, $matches)) {
-                       $ret['algorithm'] = $matches[1];
-               } else {
-                       $ret['algorithm'] = 'rsa-sha256';
-               }
+               $regex = "/($token+)=($quotedString|$token+)/ism";
 
-               if (preg_match('/headers="(.*?)"/ism', $header, $matches)) {
-                       $ret['headers'] = explode(' ', $matches[1]);
-               }
+               $matches = [];
+               preg_match_all($regex, $header, $matches, PREG_SET_ORDER);
 
-               if (preg_match('/signature="(.*?)"/ism', $header, $matches)) {
-                       $ret['signature'] = base64_decode(preg_replace('/\s+/', '', $matches[1]));
+               $headers = [];
+               foreach ($matches as $match) {
+                       $headers[$match[1]] = trim($match[2] ?: $match[3], '"');
                }
 
-               if (!empty($ret['signature']) && !empty($ret['algorithm']) && empty($ret['headers'])) {
-                       $ret['headers'] = ['date'];
+               // if the header is encrypted, decrypt with (default) site private key and continue
+               if (!empty($headers['iv'])) {
+                       $header = self::decryptSigheader($headers, DI::config()->get('system', 'prvkey'));
+                       return self::parseSigheader($header);
+               }
+
+               $return = [
+                       'keyId'     => $headers['keyId'] ?? '',
+                       'algorithm' => $headers['algorithm'] ?? 'rsa-sha256',
+                       'created'   => $headers['created'] ?? null,
+                       'expires'   => $headers['expires'] ?? null,
+                       'headers'   => explode(' ', $headers['headers'] ?? ''),
+                       'signature' => base64_decode(preg_replace('/\s+/', '', $headers['signature'] ?? '')),
+               ];
+
+               if (!empty($return['signature']) && !empty($return['algorithm']) && empty($return['headers'])) {
+                       $return['headers'] = ['date'];
                }
 
-               return $ret;
+               return $return;
        }
 
        /**
-        * @brief
-        *
-        * @param string $header
-        * @param string $prvkey (optional), if not set use site private key
-        *
-        * @return array|string associative array, empty string if failue
-        *   - \e string \b iv
-        *   - \e string \b key
-        *   - \e string \b alg
-        *   - \e string \b data
+        * @param array  $headers Signature headers
+        * @param string $prvkey  The site private key
+        * @return string Decrypted signature string
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         */
-       private static function decryptSigheader($header, $prvkey = null)
+       private static function decryptSigheader(array $headers, string $prvkey)
        {
-               $iv = $key = $alg = $data = null;
-
-               if (!$prvkey) {
-                       $prvkey = Config::get('system', 'prvkey');
-               }
-
-               $matches = [];
-
-               if (preg_match('/iv="(.*?)"/ism', $header, $matches)) {
-                       $iv = $matches[1];
-               }
-
-               if (preg_match('/key="(.*?)"/ism', $header, $matches)) {
-                       $key = $matches[1];
-               }
-
-               if (preg_match('/alg="(.*?)"/ism', $header, $matches)) {
-                       $alg = $matches[1];
-               }
-
-               if (preg_match('/data="(.*?)"/ism', $header, $matches)) {
-                       $data = $matches[1];
-               }
-
-               if ($iv && $key && $alg && $data) {
-                       return Crypto::unencapsulate(['iv' => $iv, 'key' => $key, 'alg' => $alg, 'data' => $data], $prvkey);
+               if (!empty($headers['iv']) && !empty($headers['key']) && !empty($headers['data'])) {
+                       return Crypto::unencapsulate($headers, $prvkey);
                }
 
                return '';
@@ -273,7 +261,7 @@ class HTTPSignature
         */
 
        /**
-        * @brief Transmit given data to a target for a user
+        * Transmit given data to a target for a user
         *
         * @param array   $data   Data that is about to be send
         * @param string  $target The URL of the inbox
@@ -309,16 +297,75 @@ class HTTPSignature
 
                $headers[] = 'Content-Type: application/activity+json';
 
-               $postResult = Network::post($target, $content, $headers);
+               $postResult = DI::httpRequest()->post($target, $content, $headers);
                $return_code = $postResult->getReturnCode();
 
                Logger::log('Transmit to ' . $target . ' returned ' . $return_code, Logger::DEBUG);
 
-               return ($return_code >= 200) && ($return_code <= 299);
+               $success = ($return_code >= 200) && ($return_code <= 299);
+
+               self::setInboxStatus($target, $success);
+
+               return $success;
        }
 
        /**
-        * @brief Fetches JSON data for a user
+        * Set the delivery status for a given inbox
+        *
+        * @param string  $url     The URL of the inbox
+        * @param boolean $success Transmission status
+        */
+       static private function setInboxStatus($url, $success)
+       {
+               $now = DateTimeFormat::utcNow();
+
+               $status = DBA::selectFirst('inbox-status', [], ['url' => $url]);
+               if (!DBA::isResult($status)) {
+                       DBA::insert('inbox-status', ['url' => $url, 'created' => $now]);
+                       $status = DBA::selectFirst('inbox-status', [], ['url' => $url]);
+               }
+
+               if ($success) {
+                       $fields = ['success' => $now];
+               } else {
+                       $fields = ['failure' => $now];
+               }
+
+               if ($status['failure'] > DBA::NULL_DATETIME) {
+                       $new_previous_stamp = strtotime($status['failure']);
+                       $old_previous_stamp = strtotime($status['previous']);
+
+                       // Only set "previous" with at least one day difference.
+                       // We use this to assure to not accidentally archive too soon.
+                       if (($new_previous_stamp - $old_previous_stamp) >= 86400) {
+                               $fields['previous'] = $status['failure'];
+                       }
+               }
+
+               if (!$success) {
+                       if ($status['success'] <= DBA::NULL_DATETIME) {
+                               $stamp1 = strtotime($status['created']);
+                       } else {
+                               $stamp1 = strtotime($status['success']);
+                       }
+
+                       $stamp2 = strtotime($now);
+                       $previous_stamp = strtotime($status['previous']);
+
+                       // Archive the inbox when there had been failures for five days.
+                       // Additionally ensure that at least one previous attempt has to be in between.
+                       if ((($stamp2 - $stamp1) >= 86400 * 5) && ($previous_stamp > $stamp1)) {
+                               $fields['archive'] = true;
+                       }
+               } else {
+                       $fields['archive'] = false;
+               }
+
+               DBA::update('inbox-status', $fields, ['url' => $url]);
+       }
+
+       /**
+        * Fetches JSON data for a user
         *
         * @param string  $request request url
         * @param integer $uid     User id of the requester
@@ -348,7 +395,7 @@ class HTTPSignature
        }
 
        /**
-        * @brief Fetches raw data for a user
+        * Fetches raw data for a user
         *
         * @param string  $request request url
         * @param integer $uid     User id of the requester
@@ -395,7 +442,7 @@ class HTTPSignature
                $curl_opts = $opts;
                $curl_opts['header'] = $headers;
 
-               $curlResult = Network::curl($request, false, $redirects, $curl_opts);
+               $curlResult = DI::httpRequest()->get($request, false, $curl_opts);
                $return_code = $curlResult->getReturnCode();
 
                Logger::log('Fetched for user ' . $uid . ' from ' . $request . ' returned ' . $return_code, Logger::DEBUG);
@@ -404,7 +451,7 @@ class HTTPSignature
        }
 
        /**
-        * @brief Gets a signer from a given HTTP request
+        * Gets a signer from a given HTTP request
         *
         * @param $content
         * @param $http_headers
@@ -466,6 +513,14 @@ class HTTPSignature
 
                $algorithm = null;
 
+               // Wildcard value where signing algorithm should be derived from keyId
+               // @see https://tools.ietf.org/html/draft-ietf-httpbis-message-signatures-00#section-4.1
+               // Defaulting to SHA256 as it seems to be the prevalent implementation
+               // @see https://arewehs2019yet.vpzom.click
+               if ($sig_block['algorithm'] === 'hs2019') {
+                       $algorithm = 'sha256';
+               }
+
                if ($sig_block['algorithm'] === 'rsa-sha256') {
                        $algorithm = 'sha256';
                }
@@ -536,7 +591,7 @@ class HTTPSignature
        }
 
        /**
-        * @brief fetches a key for a given id and actor
+        * fetches a key for a given id and actor
         *
         * @param $id
         * @param $actor