diff options
Diffstat (limited to 'lib/private/Log.php')
-rw-r--r-- | lib/private/Log.php | 237 |
1 files changed, 118 insertions, 119 deletions
diff --git a/lib/private/Log.php b/lib/private/Log.php index 9975696ff06..301a25d12c1 100644 --- a/lib/private/Log.php +++ b/lib/private/Log.php @@ -1,38 +1,10 @@ <?php declare(strict_types=1); - /** - * @copyright Copyright (c) 2016, ownCloud, Inc. - * - * @author Arthur Schiwon <blizzz@arthur-schiwon.de> - * @author Bart Visscher <bartv@thisnet.nl> - * @author Bernhard Posselt <dev@bernhard-posselt.com> - * @author Christoph Wurst <christoph@winzerhof-wurst.at> - * @author Joas Schilling <coding@schilljs.com> - * @author Julius Härtl <jus@bitgrid.net> - * @author Morris Jobke <hey@morrisjobke.de> - * @author Olivier Paroz <github@oparoz.com> - * @author Robin Appelman <robin@icewind.nl> - * @author Roeland Jago Douma <roeland@famdouma.nl> - * @author Thomas Citharel <nextcloud@tcit.fr> - * @author Thomas Müller <thomas.mueller@tmit.eu> - * @author Victor Dubiniuk <dubiniuk@owncloud.com> - * - * @license AGPL-3.0 - * - * This code is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License, version 3, - * as published by the Free Software Foundation. - * - * 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, version 3, - * along with this program. If not, see <http://www.gnu.org/licenses/> - * + * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors + * SPDX-FileCopyrightText: 2016 ownCloud, Inc. + * SPDX-License-Identifier: AGPL-3.0-only */ namespace OC; @@ -42,6 +14,7 @@ use OC\AppFramework\Bootstrap\Coordinator; use OC\Log\ExceptionSerializer; use OCP\EventDispatcher\IEventDispatcher; use OCP\ILogger; +use OCP\IRequest; use OCP\IUserSession; use OCP\Log\BeforeMessageLoggedEvent; use OCP\Log\IDataLogger; @@ -62,42 +35,19 @@ use function strtr; * MonoLog is an example implementing this interface. */ class Log implements ILogger, IDataLogger { - private IWriter $logger; - private ?SystemConfig $config; private ?bool $logConditionSatisfied = null; - private ?Normalizer $normalizer; - private ?IRegistry $crashReporters; - private ?IEventDispatcher $eventDispatcher; + private ?IEventDispatcher $eventDispatcher = null; + private int $nestingLevel = 0; - /** - * @param IWriter $logger The logger that should be used - * @param SystemConfig $config the system config object - * @param Normalizer|null $normalizer - * @param IRegistry|null $registry - */ public function __construct( - IWriter $logger, - SystemConfig $config = null, - Normalizer $normalizer = null, - IRegistry $registry = null + private IWriter $logger, + private SystemConfig $config, + private Normalizer $normalizer = new Normalizer(), + private ?IRegistry $crashReporters = null, ) { - // FIXME: Add this for backwards compatibility, should be fixed at some point probably - if ($config === null) { - $config = \OC::$server->getSystemConfig(); - } - - $this->config = $config; - $this->logger = $logger; - if ($normalizer === null) { - $this->normalizer = new Normalizer(); - } else { - $this->normalizer = $normalizer; - } - $this->crashReporters = $registry; - $this->eventDispatcher = null; } - public function setEventDispatcher(IEventDispatcher $eventDispatcher) { + public function setEventDispatcher(IEventDispatcher $eventDispatcher): void { $this->eventDispatcher = $eventDispatcher; } @@ -106,9 +56,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function emergency(string $message, array $context = []) { + public function emergency(string $message, array $context = []): void { $this->log(ILogger::FATAL, $message, $context); } @@ -120,9 +69,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function alert(string $message, array $context = []) { + public function alert(string $message, array $context = []): void { $this->log(ILogger::ERROR, $message, $context); } @@ -133,9 +81,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function critical(string $message, array $context = []) { + public function critical(string $message, array $context = []): void { $this->log(ILogger::ERROR, $message, $context); } @@ -145,9 +92,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function error(string $message, array $context = []) { + public function error(string $message, array $context = []): void { $this->log(ILogger::ERROR, $message, $context); } @@ -159,9 +105,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function warning(string $message, array $context = []) { + public function warning(string $message, array $context = []): void { $this->log(ILogger::WARN, $message, $context); } @@ -170,9 +115,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function notice(string $message, array $context = []) { + public function notice(string $message, array $context = []): void { $this->log(ILogger::INFO, $message, $context); } @@ -183,9 +127,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function info(string $message, array $context = []) { + public function info(string $message, array $context = []): void { $this->log(ILogger::INFO, $message, $context); } @@ -194,9 +137,8 @@ class Log implements ILogger, IDataLogger { * * @param string $message * @param array $context - * @return void */ - public function debug(string $message, array $context = []) { + public function debug(string $message, array $context = []): void { $this->log(ILogger::DEBUG, $message, $context); } @@ -207,19 +149,21 @@ class Log implements ILogger, IDataLogger { * @param int $level * @param string $message * @param array $context - * @return void */ - public function log(int $level, string $message, array $context = []) { - $minLevel = $this->getLogLevel($context); + public function log(int $level, string $message, array $context = []): void { + $minLevel = $this->getLogLevel($context, $message); + if ($level < $minLevel + && (($this->crashReporters?->hasReporters() ?? false) === false) + && (($this->eventDispatcher?->hasListeners(BeforeMessageLoggedEvent::class) ?? false) === false)) { + return; // no crash reporter, no listeners, we can stop for lower log level + } array_walk($context, [$this->normalizer, 'format']); $app = $context['app'] ?? 'no app in context'; $entry = $this->interpolateMessage($context, $message); - if ($this->eventDispatcher) { - $this->eventDispatcher->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $entry)); - } + $this->eventDispatcher?->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $entry)); $hasBacktrace = isset($entry['exception']); $logBacktrace = $this->config->getValue('log.backtrace', false); @@ -241,18 +185,37 @@ class Log implements ILogger, IDataLogger { $this->crashReporters->delegateMessage($entry['message'], $messageContext); } } else { - if ($this->crashReporters !== null) { - $this->crashReporters->delegateBreadcrumb($entry['message'], 'log', $context); - } + $this->crashReporters?->delegateBreadcrumb($entry['message'], 'log', $context); } } catch (Throwable $e) { // make sure we dont hard crash if logging fails } } - public function getLogLevel($context) { + public function getLogLevel(array $context, string $message): int { + if ($this->nestingLevel > 1) { + return ILogger::WARN; + } + + $this->nestingLevel++; + /** + * @psalm-var array{ + * shared_secret?: string, + * users?: string[], + * apps?: string[], + * matches?: array<array-key, array{ + * shared_secret?: string, + * users?: string[], + * apps?: string[], + * message?: string, + * loglevel: 0|1|2|3|4, + * }> + * } $logCondition + */ $logCondition = $this->config->getValue('log.condition', []); + $userId = false; + /** * check for a special log condition - this enables an increased log on * a per request/user base @@ -262,21 +225,8 @@ class Log implements ILogger, IDataLogger { $this->logConditionSatisfied = false; if (!empty($logCondition)) { // check for secret token in the request - if (isset($logCondition['shared_secret'])) { - $request = \OC::$server->getRequest(); - - if ($request->getMethod() === 'PUT' && - !str_contains($request->getHeader('Content-Type'), 'application/x-www-form-urlencoded') && - !str_contains($request->getHeader('Content-Type'), 'application/json')) { - $logSecretRequest = ''; - } else { - $logSecretRequest = $request->getParam('log_secret', ''); - } - - // if token is found in the request change set the log condition to satisfied - if ($request && hash_equals($logCondition['shared_secret'], $logSecretRequest)) { - $this->logConditionSatisfied = true; - } + if (isset($logCondition['shared_secret']) && $this->checkLogSecret($logCondition['shared_secret'])) { + $this->logConditionSatisfied = true; } // check for user @@ -289,6 +239,8 @@ class Log implements ILogger, IDataLogger { } elseif (in_array($user->getUID(), $logCondition['users'], true)) { // if the user matches set the log condition to satisfied $this->logConditionSatisfied = true; + } else { + $userId = $user->getUID(); } } } @@ -296,24 +248,72 @@ class Log implements ILogger, IDataLogger { // if log condition is satisfied change the required log level to DEBUG if ($this->logConditionSatisfied) { + $this->nestingLevel--; return ILogger::DEBUG; } - if (isset($context['app'])) { - $app = $context['app']; + if ($userId === false && isset($logCondition['matches'])) { + $user = \OCP\Server::get(IUserSession::class)->getUser(); + $userId = $user === null ? false : $user->getUID(); + } + if (isset($context['app'])) { /** * check log condition based on the context of each log message * once this is met -> change the required log level to debug */ - if (!empty($logCondition) - && isset($logCondition['apps']) - && in_array($app, $logCondition['apps'], true)) { + if (in_array($context['app'], $logCondition['apps'] ?? [], true)) { + $this->nestingLevel--; return ILogger::DEBUG; } } - return min($this->config->getValue('loglevel', ILogger::WARN), ILogger::FATAL); + if (!isset($logCondition['matches'])) { + $configLogLevel = $this->config->getValue('loglevel', ILogger::WARN); + if (is_numeric($configLogLevel)) { + $this->nestingLevel--; + return min((int)$configLogLevel, ILogger::FATAL); + } + + // Invalid configuration, warn the user and fall back to default level of WARN + error_log('Nextcloud configuration: "loglevel" is not a valid integer'); + $this->nestingLevel--; + return ILogger::WARN; + } + + foreach ($logCondition['matches'] as $option) { + if ( + (!isset($option['shared_secret']) || $this->checkLogSecret($option['shared_secret'])) + && (!isset($option['users']) || in_array($userId, $option['users'], true)) + && (!isset($option['apps']) || (isset($context['app']) && in_array($context['app'], $option['apps'], true))) + && (!isset($option['message']) || str_contains($message, $option['message'])) + ) { + if (!isset($option['apps']) && !isset($option['loglevel']) && !isset($option['message'])) { + /* Only user and/or secret are listed as conditions, we can cache the result for the rest of the request */ + $this->logConditionSatisfied = true; + $this->nestingLevel--; + return ILogger::DEBUG; + } + $this->nestingLevel--; + return $option['loglevel'] ?? ILogger::DEBUG; + } + } + + $this->nestingLevel--; + return ILogger::WARN; + } + + protected function checkLogSecret(string $conditionSecret): bool { + $request = \OCP\Server::get(IRequest::class); + + if ($request->getMethod() === 'PUT' + && !str_contains($request->getHeader('Content-Type'), 'application/x-www-form-urlencoded') + && !str_contains($request->getHeader('Content-Type'), 'application/json')) { + return hash_equals($conditionSecret, ''); + } + + // if token is found in the request change set the log condition to satisfied + return hash_equals($conditionSecret, $request->getParam('log_secret', '')); } /** @@ -324,20 +324,22 @@ class Log implements ILogger, IDataLogger { * @return void * @since 8.2.0 */ - public function logException(Throwable $exception, array $context = []) { + public function logException(Throwable $exception, array $context = []): void { $app = $context['app'] ?? 'no app in context'; $level = $context['level'] ?? ILogger::ERROR; - $minLevel = $this->getLogLevel($context); - if ($level < $minLevel && ($this->crashReporters === null || !$this->crashReporters->hasReporters())) { - return; + $minLevel = $this->getLogLevel($context, $context['message'] ?? $exception->getMessage()); + if ($level < $minLevel + && (($this->crashReporters?->hasReporters() ?? false) === false) + && (($this->eventDispatcher?->hasListeners(BeforeMessageLoggedEvent::class) ?? false) === false)) { + return; // no crash reporter, no listeners, we can stop for lower log level } // if an error is raised before the autoloader is properly setup, we can't serialize exceptions try { $serializer = $this->getSerializer(); } catch (Throwable $e) { - $this->error("Failed to load ExceptionSerializer serializer while trying to log " . $exception->getMessage()); + $this->error('Failed to load ExceptionSerializer serializer while trying to log ' . $exception->getMessage()); return; } $data = $context; @@ -346,12 +348,9 @@ class Log implements ILogger, IDataLogger { $data = array_merge($serializer->serializeException($exception), $data); $data = $this->interpolateMessage($data, isset($context['message']) && $context['message'] !== '' ? $context['message'] : ('Exception thrown: ' . get_class($exception)), 'CustomMessage'); - array_walk($context, [$this->normalizer, 'format']); - if ($this->eventDispatcher) { - $this->eventDispatcher->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $data)); - } + $this->eventDispatcher?->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $data)); try { if ($level >= $minLevel) { @@ -374,7 +373,7 @@ class Log implements ILogger, IDataLogger { $app = $context['app'] ?? 'no app in context'; $level = $context['level'] ?? ILogger::ERROR; - $minLevel = $this->getLogLevel($context); + $minLevel = $this->getLogLevel($context, $message); array_walk($context, [$this->normalizer, 'format']); @@ -399,7 +398,7 @@ class Log implements ILogger, IDataLogger { * @param string|array $entry * @param int $level */ - protected function writeLog(string $app, $entry, int $level) { + protected function writeLog(string $app, $entry, int $level): void { $this->logger->write($app, $entry, $level); } |