2144a114b0
This didn't really work anyways and Chrome 54 for Android has been pushed out via Google Play on October 19th. So we should remove this. This is only in master and doesn't affect any stable branch. Fixes https://github.com/nextcloud/server/issues/2318 Signed-off-by: Lukas Reschke <lukas@statuscode.ch>
1086 lines
37 KiB
PHP
1086 lines
37 KiB
PHP
<?php
|
||
/**
|
||
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
||
*
|
||
* @author Adam Williamson <awilliam@redhat.com>
|
||
* @author Andreas Fischer <bantu@owncloud.com>
|
||
* @author Arthur Schiwon <blizzz@arthur-schiwon.de>
|
||
* @author Bart Visscher <bartv@thisnet.nl>
|
||
* @author Bernhard Posselt <dev@bernhard-posselt.com>
|
||
* @author Björn Schießle <bjoern@schiessle.org>
|
||
* @author Christoph Wurst <christoph@owncloud.com>
|
||
* @author davidgumberg <davidnoizgumberg@gmail.com>
|
||
* @author Florin Peter <github@florin-peter.de>
|
||
* @author Georg Ehrke <georg@owncloud.com>
|
||
* @author Hugo Gonzalez Labrador <hglavra@gmail.com>
|
||
* @author Individual IT Services <info@individual-it.net>
|
||
* @author Jakob Sack <mail@jakobsack.de>
|
||
* @author Joachim Bauch <bauch@struktur.de>
|
||
* @author Joachim Sokolowski <github@sokolowski.org>
|
||
* @author Joas Schilling <coding@schilljs.com>
|
||
* @author Jörn Friedrich Dreyer <jfd@butonic.de>
|
||
* @author Lukas Reschke <lukas@statuscode.ch>
|
||
* @author Michael Gapczynski <GapczynskiM@gmail.com>
|
||
* @author Morris Jobke <hey@morrisjobke.de>
|
||
* @author Owen Winkler <a_github@midnightcircus.com>
|
||
* @author Phil Davis <phil.davis@inf.org>
|
||
* @author Ramiro Aparicio <rapariciog@gmail.com>
|
||
* @author Robin Appelman <robin@icewind.nl>
|
||
* @author Robin McCorkell <robin@mccorkell.me.uk>
|
||
* @author Roeland Jago Douma <roeland@famdouma.nl>
|
||
* @author Stefan Weil <sw@weilnetz.de>
|
||
* @author Thomas Müller <thomas.mueller@tmit.eu>
|
||
* @author Thomas Pulzer <t.pulzer@kniel.de>
|
||
* @author Thomas Tanghus <thomas@tanghus.net>
|
||
* @author Vincent Petry <pvince81@owncloud.com>
|
||
* @author Volkan Gezer <volkangezer@gmail.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/>
|
||
*
|
||
*/
|
||
|
||
require_once 'public/Constants.php';
|
||
|
||
/**
|
||
* Class that is a namespace for all global OC variables
|
||
* No, we can not put this class in its own file because it is used by
|
||
* OC_autoload!
|
||
*/
|
||
class OC {
|
||
/**
|
||
* Associative array for autoloading. classname => filename
|
||
*/
|
||
public static $CLASSPATH = array();
|
||
/**
|
||
* The installation path for Nextcloud on the server (e.g. /srv/http/nextcloud)
|
||
*/
|
||
public static $SERVERROOT = '';
|
||
/**
|
||
* the current request path relative to the Nextcloud root (e.g. files/index.php)
|
||
*/
|
||
private static $SUBURI = '';
|
||
/**
|
||
* the Nextcloud root path for http requests (e.g. nextcloud/)
|
||
*/
|
||
public static $WEBROOT = '';
|
||
/**
|
||
* The installation path array of the apps folder on the server (e.g. /srv/http/nextcloud) 'path' and
|
||
* web path in 'url'
|
||
*/
|
||
public static $APPSROOTS = array();
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
public static $configDir;
|
||
|
||
/**
|
||
* requested app
|
||
*/
|
||
public static $REQUESTEDAPP = '';
|
||
|
||
/**
|
||
* check if Nextcloud runs in cli mode
|
||
*/
|
||
public static $CLI = false;
|
||
|
||
/**
|
||
* @var \OC\Autoloader $loader
|
||
*/
|
||
public static $loader = null;
|
||
|
||
/** @var \Composer\Autoload\ClassLoader $composerAutoloader */
|
||
public static $composerAutoloader = null;
|
||
|
||
/**
|
||
* @var \OC\Server
|
||
*/
|
||
public static $server = null;
|
||
|
||
/**
|
||
* @var \OC\Config
|
||
*/
|
||
private static $config = null;
|
||
|
||
/**
|
||
* @throws \RuntimeException when the 3rdparty directory is missing or
|
||
* the app path list is empty or contains an invalid path
|
||
*/
|
||
public static function initPaths() {
|
||
if(defined('PHPUNIT_CONFIG_DIR')) {
|
||
self::$configDir = OC::$SERVERROOT . '/' . PHPUNIT_CONFIG_DIR . '/';
|
||
} elseif(defined('PHPUNIT_RUN') and PHPUNIT_RUN and is_dir(OC::$SERVERROOT . '/tests/config/')) {
|
||
self::$configDir = OC::$SERVERROOT . '/tests/config/';
|
||
} elseif($dir = getenv('NEXTCLOUD_CONFIG_DIR')) {
|
||
self::$configDir = rtrim($dir, '/') . '/';
|
||
} else {
|
||
self::$configDir = OC::$SERVERROOT . '/config/';
|
||
}
|
||
self::$config = new \OC\Config(self::$configDir);
|
||
|
||
OC::$SUBURI = str_replace("\\", "/", substr(realpath($_SERVER["SCRIPT_FILENAME"]), strlen(OC::$SERVERROOT)));
|
||
/**
|
||
* FIXME: The following lines are required because we can't yet instantiiate
|
||
* \OC::$server->getRequest() since \OC::$server does not yet exist.
|
||
*/
|
||
$params = [
|
||
'server' => [
|
||
'SCRIPT_NAME' => $_SERVER['SCRIPT_NAME'],
|
||
'SCRIPT_FILENAME' => $_SERVER['SCRIPT_FILENAME'],
|
||
],
|
||
];
|
||
$fakeRequest = new \OC\AppFramework\Http\Request($params, null, new \OC\AllConfig(new \OC\SystemConfig(self::$config)));
|
||
$scriptName = $fakeRequest->getScriptName();
|
||
if (substr($scriptName, -1) == '/') {
|
||
$scriptName .= 'index.php';
|
||
//make sure suburi follows the same rules as scriptName
|
||
if (substr(OC::$SUBURI, -9) != 'index.php') {
|
||
if (substr(OC::$SUBURI, -1) != '/') {
|
||
OC::$SUBURI = OC::$SUBURI . '/';
|
||
}
|
||
OC::$SUBURI = OC::$SUBURI . 'index.php';
|
||
}
|
||
}
|
||
|
||
|
||
if (OC::$CLI) {
|
||
OC::$WEBROOT = self::$config->getValue('overwritewebroot', '');
|
||
} else {
|
||
if (substr($scriptName, 0 - strlen(OC::$SUBURI)) === OC::$SUBURI) {
|
||
OC::$WEBROOT = substr($scriptName, 0, 0 - strlen(OC::$SUBURI));
|
||
|
||
if (OC::$WEBROOT != '' && OC::$WEBROOT[0] !== '/') {
|
||
OC::$WEBROOT = '/' . OC::$WEBROOT;
|
||
}
|
||
} else {
|
||
// The scriptName is not ending with OC::$SUBURI
|
||
// This most likely means that we are calling from CLI.
|
||
// However some cron jobs still need to generate
|
||
// a web URL, so we use overwritewebroot as a fallback.
|
||
OC::$WEBROOT = self::$config->getValue('overwritewebroot', '');
|
||
}
|
||
|
||
// Resolve /nextcloud to /nextcloud/ to ensure to always have a trailing
|
||
// slash which is required by URL generation.
|
||
if($_SERVER['REQUEST_URI'] === \OC::$WEBROOT &&
|
||
substr($_SERVER['REQUEST_URI'], -1) !== '/') {
|
||
header('Location: '.\OC::$WEBROOT.'/');
|
||
exit();
|
||
}
|
||
}
|
||
|
||
// search the apps folder
|
||
$config_paths = self::$config->getValue('apps_paths', array());
|
||
if (!empty($config_paths)) {
|
||
foreach ($config_paths as $paths) {
|
||
if (isset($paths['url']) && isset($paths['path'])) {
|
||
$paths['url'] = rtrim($paths['url'], '/');
|
||
$paths['path'] = rtrim($paths['path'], '/');
|
||
OC::$APPSROOTS[] = $paths;
|
||
}
|
||
}
|
||
} elseif (file_exists(OC::$SERVERROOT . '/apps')) {
|
||
OC::$APPSROOTS[] = array('path' => OC::$SERVERROOT . '/apps', 'url' => '/apps', 'writable' => true);
|
||
} elseif (file_exists(OC::$SERVERROOT . '/../apps')) {
|
||
OC::$APPSROOTS[] = array(
|
||
'path' => rtrim(dirname(OC::$SERVERROOT), '/') . '/apps',
|
||
'url' => '/apps',
|
||
'writable' => true
|
||
);
|
||
}
|
||
|
||
if (empty(OC::$APPSROOTS)) {
|
||
throw new \RuntimeException('apps directory not found! Please put the Nextcloud apps folder in the Nextcloud folder'
|
||
. ' or the folder above. You can also configure the location in the config.php file.');
|
||
}
|
||
$paths = array();
|
||
foreach (OC::$APPSROOTS as $path) {
|
||
$paths[] = $path['path'];
|
||
if (!is_dir($path['path'])) {
|
||
throw new \RuntimeException(sprintf('App directory "%s" not found! Please put the Nextcloud apps folder in the'
|
||
. ' Nextcloud folder or the folder above. You can also configure the location in the'
|
||
. ' config.php file.', $path['path']));
|
||
}
|
||
}
|
||
|
||
// set the right include path
|
||
set_include_path(
|
||
implode(PATH_SEPARATOR, $paths)
|
||
);
|
||
}
|
||
|
||
public static function checkConfig() {
|
||
$l = \OC::$server->getL10N('lib');
|
||
|
||
// Create config if it does not already exist
|
||
$configFilePath = self::$configDir .'/config.php';
|
||
if(!file_exists($configFilePath)) {
|
||
@touch($configFilePath);
|
||
}
|
||
|
||
// Check if config is writable
|
||
$configFileWritable = is_writable($configFilePath);
|
||
if (!$configFileWritable && !OC_Helper::isReadOnlyConfigEnabled()
|
||
|| !$configFileWritable && self::checkUpgrade(false)) {
|
||
|
||
$urlGenerator = \OC::$server->getURLGenerator();
|
||
|
||
if (self::$CLI) {
|
||
echo $l->t('Cannot write into "config" directory!')."\n";
|
||
echo $l->t('This can usually be fixed by giving the webserver write access to the config directory')."\n";
|
||
echo "\n";
|
||
echo $l->t('See %s', [ $urlGenerator->linkToDocs('admin-dir_permissions') ])."\n";
|
||
exit;
|
||
} else {
|
||
OC_Template::printErrorPage(
|
||
$l->t('Cannot write into "config" directory!'),
|
||
$l->t('This can usually be fixed by '
|
||
. '%sgiving the webserver write access to the config directory%s.',
|
||
array('<a href="' . $urlGenerator->linkToDocs('admin-dir_permissions') . '" target="_blank" rel="noreferrer">', '</a>'))
|
||
);
|
||
}
|
||
}
|
||
}
|
||
|
||
public static function checkInstalled() {
|
||
if (defined('OC_CONSOLE')) {
|
||
return;
|
||
}
|
||
// Redirect to installer if not installed
|
||
if (!\OC::$server->getSystemConfig()->getValue('installed', false) && OC::$SUBURI !== '/index.php' && OC::$SUBURI !== '/status.php') {
|
||
if (OC::$CLI) {
|
||
throw new Exception('Not installed');
|
||
} else {
|
||
$url = OC::$WEBROOT . '/index.php';
|
||
header('Location: ' . $url);
|
||
}
|
||
exit();
|
||
}
|
||
}
|
||
|
||
public static function checkMaintenanceMode() {
|
||
// Allow ajax update script to execute without being stopped
|
||
if (\OC::$server->getSystemConfig()->getValue('maintenance', false) && OC::$SUBURI != '/core/ajax/update.php') {
|
||
// send http status 503
|
||
header('HTTP/1.1 503 Service Temporarily Unavailable');
|
||
header('Status: 503 Service Temporarily Unavailable');
|
||
header('Retry-After: 120');
|
||
|
||
// render error page
|
||
$template = new OC_Template('', 'update.user', 'guest');
|
||
OC_Util::addScript('maintenance-check');
|
||
$template->printPage();
|
||
die();
|
||
}
|
||
}
|
||
|
||
public static function checkSingleUserMode($lockIfNoUserLoggedIn = false) {
|
||
if (!\OC::$server->getSystemConfig()->getValue('singleuser', false)) {
|
||
return;
|
||
}
|
||
$user = OC_User::getUserSession()->getUser();
|
||
if ($user) {
|
||
$group = \OC::$server->getGroupManager()->get('admin');
|
||
if ($group->inGroup($user)) {
|
||
return;
|
||
}
|
||
} else {
|
||
if(!$lockIfNoUserLoggedIn) {
|
||
return;
|
||
}
|
||
}
|
||
// send http status 503
|
||
header('HTTP/1.1 503 Service Temporarily Unavailable');
|
||
header('Status: 503 Service Temporarily Unavailable');
|
||
header('Retry-After: 120');
|
||
|
||
// render error page
|
||
$template = new OC_Template('', 'singleuser.user', 'guest');
|
||
$template->printPage();
|
||
die();
|
||
}
|
||
|
||
/**
|
||
* Checks if the version requires an update and shows
|
||
* @param bool $showTemplate Whether an update screen should get shown
|
||
* @return bool|void
|
||
*/
|
||
public static function checkUpgrade($showTemplate = true) {
|
||
if (\OCP\Util::needUpgrade()) {
|
||
$systemConfig = \OC::$server->getSystemConfig();
|
||
if ($showTemplate && !$systemConfig->getValue('maintenance', false)) {
|
||
self::printUpgradePage();
|
||
exit();
|
||
} else {
|
||
return true;
|
||
}
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Prints the upgrade page
|
||
*/
|
||
private static function printUpgradePage() {
|
||
$systemConfig = \OC::$server->getSystemConfig();
|
||
|
||
$disableWebUpdater = $systemConfig->getValue('upgrade.disable-web', false);
|
||
$tooBig = false;
|
||
if (!$disableWebUpdater) {
|
||
$apps = \OC::$server->getAppManager();
|
||
$tooBig = $apps->isInstalled('user_ldap') || $apps->isInstalled('user_shibboleth');
|
||
if (!$tooBig) {
|
||
// count users
|
||
$stats = \OC::$server->getUserManager()->countUsers();
|
||
$totalUsers = array_sum($stats);
|
||
$tooBig = ($totalUsers > 50);
|
||
}
|
||
}
|
||
if ($disableWebUpdater || $tooBig) {
|
||
// send http status 503
|
||
header('HTTP/1.1 503 Service Temporarily Unavailable');
|
||
header('Status: 503 Service Temporarily Unavailable');
|
||
header('Retry-After: 120');
|
||
|
||
// render error page
|
||
$template = new OC_Template('', 'update.use-cli', 'guest');
|
||
$template->assign('productName', 'nextcloud'); // for now
|
||
$template->assign('version', OC_Util::getVersionString());
|
||
$template->assign('tooBig', $tooBig);
|
||
|
||
$template->printPage();
|
||
die();
|
||
}
|
||
|
||
// check whether this is a core update or apps update
|
||
$installedVersion = $systemConfig->getValue('version', '0.0.0');
|
||
$currentVersion = implode('.', \OCP\Util::getVersion());
|
||
|
||
// if not a core upgrade, then it's apps upgrade
|
||
$isAppsOnlyUpgrade = (version_compare($currentVersion, $installedVersion, '='));
|
||
|
||
$oldTheme = $systemConfig->getValue('theme');
|
||
$systemConfig->setValue('theme', '');
|
||
\OCP\Util::addScript('config'); // needed for web root
|
||
\OCP\Util::addScript('update');
|
||
\OCP\Util::addStyle('update');
|
||
|
||
/** @var \OC\App\AppManager $appManager */
|
||
$appManager = \OC::$server->getAppManager();
|
||
|
||
$tmpl = new OC_Template('', 'update.admin', 'guest');
|
||
$tmpl->assign('version', OC_Util::getVersionString());
|
||
$tmpl->assign('isAppsOnlyUpgrade', $isAppsOnlyUpgrade);
|
||
|
||
// get third party apps
|
||
$ocVersion = \OCP\Util::getVersion();
|
||
$incompatibleApps = $appManager->getIncompatibleApps($ocVersion);
|
||
$incompatibleShippedApps = [];
|
||
foreach ($incompatibleApps as $appInfo) {
|
||
if ($appManager->isShipped($appInfo['id'])) {
|
||
$incompatibleShippedApps[] = $appInfo['name'] . ' (' . $appInfo['id'] . ')';
|
||
}
|
||
}
|
||
|
||
if (!empty($incompatibleShippedApps)) {
|
||
$l = \OC::$server->getL10N('core');
|
||
$hint = $l->t('The files of the app %$1s were not replaced correctly. Make sure it is a version compatible with the server.', [implode(', ', $incompatibleShippedApps)]);
|
||
throw new \OC\HintException('The files of the app ' . implode(', ', $incompatibleShippedApps) . ' were not replaced correctly. Make sure it is a version compatible with the server.', $hint);
|
||
}
|
||
|
||
$tmpl->assign('appsToUpgrade', $appManager->getAppsNeedingUpgrade($ocVersion));
|
||
$tmpl->assign('incompatibleAppsList', $incompatibleApps);
|
||
$tmpl->assign('productName', 'Nextcloud'); // for now
|
||
$tmpl->assign('oldTheme', $oldTheme);
|
||
$tmpl->printPage();
|
||
}
|
||
|
||
public static function initSession() {
|
||
// prevents javascript from accessing php session cookies
|
||
ini_set('session.cookie_httponly', true);
|
||
|
||
// set the cookie path to the Nextcloud directory
|
||
$cookie_path = OC::$WEBROOT ? : '/';
|
||
ini_set('session.cookie_path', $cookie_path);
|
||
|
||
// Let the session name be changed in the initSession Hook
|
||
$sessionName = OC_Util::getInstanceId();
|
||
|
||
try {
|
||
// Allow session apps to create a custom session object
|
||
$useCustomSession = false;
|
||
$session = self::$server->getSession();
|
||
OC_Hook::emit('OC', 'initSession', array('session' => &$session, 'sessionName' => &$sessionName, 'useCustomSession' => &$useCustomSession));
|
||
if (!$useCustomSession) {
|
||
// set the session name to the instance id - which is unique
|
||
$session = new \OC\Session\Internal($sessionName);
|
||
}
|
||
|
||
$cryptoWrapper = \OC::$server->getSessionCryptoWrapper();
|
||
$session = $cryptoWrapper->wrapSession($session);
|
||
self::$server->setSession($session);
|
||
|
||
// if session can't be started break with http 500 error
|
||
} catch (Exception $e) {
|
||
\OCP\Util::logException('base', $e);
|
||
//show the user a detailed error page
|
||
OC_Response::setStatus(OC_Response::STATUS_INTERNAL_SERVER_ERROR);
|
||
OC_Template::printExceptionErrorPage($e);
|
||
die();
|
||
}
|
||
|
||
$sessionLifeTime = self::getSessionLifeTime();
|
||
|
||
// session timeout
|
||
if ($session->exists('LAST_ACTIVITY') && (time() - $session->get('LAST_ACTIVITY') > $sessionLifeTime)) {
|
||
if (isset($_COOKIE[session_name()])) {
|
||
setcookie(session_name(), null, -1, self::$WEBROOT ? : '/');
|
||
}
|
||
\OC::$server->getUserSession()->logout();
|
||
}
|
||
|
||
$session->set('LAST_ACTIVITY', time());
|
||
}
|
||
|
||
/**
|
||
* @return string
|
||
*/
|
||
private static function getSessionLifeTime() {
|
||
return \OC::$server->getConfig()->getSystemValue('session_lifetime', 60 * 60 * 24);
|
||
}
|
||
|
||
public static function loadAppClassPaths() {
|
||
foreach (OC_App::getEnabledApps() as $app) {
|
||
$appPath = OC_App::getAppPath($app);
|
||
if ($appPath === false) {
|
||
continue;
|
||
}
|
||
|
||
$file = $appPath . '/appinfo/classpath.php';
|
||
if (file_exists($file)) {
|
||
require_once $file;
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Try to set some values to the required Nextcloud default
|
||
*/
|
||
public static function setRequiredIniValues() {
|
||
@ini_set('default_charset', 'UTF-8');
|
||
@ini_set('gd.jpeg_ignore_warning', 1);
|
||
}
|
||
|
||
/**
|
||
* Send the same site cookies
|
||
*/
|
||
private static function sendSameSiteCookies() {
|
||
$cookieParams = session_get_cookie_params();
|
||
$secureCookie = ($cookieParams['secure'] === true) ? 'secure; ' : '';
|
||
$policies = [
|
||
'lax',
|
||
'strict',
|
||
];
|
||
|
||
// Append __Host to the cookie if it meets the requirements
|
||
$cookiePrefix = '';
|
||
if($cookieParams['secure'] === true && $cookieParams['path'] === '/') {
|
||
$cookiePrefix = '__Host-';
|
||
}
|
||
|
||
foreach($policies as $policy) {
|
||
header(
|
||
sprintf(
|
||
'Set-Cookie: %snc_sameSiteCookie%s=true; path=%s; httponly;' . $secureCookie . 'expires=Fri, 31-Dec-2100 23:59:59 GMT; SameSite=%s',
|
||
$cookiePrefix,
|
||
$policy,
|
||
$cookieParams['path'],
|
||
$policy
|
||
),
|
||
false
|
||
);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Same Site cookie to further mitigate CSRF attacks. This cookie has to
|
||
* be set in every request if cookies are sent to add a second level of
|
||
* defense against CSRF.
|
||
*
|
||
* If the cookie is not sent this will set the cookie and reload the page.
|
||
* We use an additional cookie since we want to protect logout CSRF and
|
||
* also we can't directly interfere with PHP's session mechanism.
|
||
*/
|
||
private static function performSameSiteCookieProtection() {
|
||
$request = \OC::$server->getRequest();
|
||
|
||
// Some user agents are notorious and don't really properly follow HTTP
|
||
// specifications. For those, have an automated opt-out. Since the protection
|
||
// for remote.php is applied in base.php as starting point we need to opt out
|
||
// here.
|
||
$incompatibleUserAgents = [
|
||
// OS X Finder
|
||
'/^WebDAVFS/',
|
||
];
|
||
if($request->isUserAgent($incompatibleUserAgents)) {
|
||
return;
|
||
}
|
||
|
||
if(count($_COOKIE) > 0) {
|
||
$requestUri = $request->getScriptName();
|
||
$processingScript = explode('/', $requestUri);
|
||
$processingScript = $processingScript[count($processingScript)-1];
|
||
// FIXME: In a SAML scenario we don't get any strict or lax cookie
|
||
// send for the ACS endpoint. Since we have some legacy code in Nextcloud
|
||
// (direct PHP files) the enforcement of lax cookies is performed here
|
||
// instead of the middleware.
|
||
//
|
||
// This means we cannot exclude some routes from the cookie validation,
|
||
// which normally is not a problem but is a little bit cumbersome for
|
||
// this use-case.
|
||
// Once the old legacy PHP endpoints have been removed we can move
|
||
// the verification into a middleware and also adds some exemptions.
|
||
//
|
||
// Questions about this code? Ask Lukas ;-)
|
||
$currentUrl = substr(explode('?',$request->getRequestUri(), 2)[0], strlen(\OC::$WEBROOT));
|
||
if($currentUrl === '/index.php/apps/user_saml/saml/acs') {
|
||
return;
|
||
}
|
||
// For the "index.php" endpoint only a lax cookie is required.
|
||
if($processingScript === 'index.php') {
|
||
if(!$request->passesLaxCookieCheck()) {
|
||
self::sendSameSiteCookies();
|
||
header('Location: '.$_SERVER['REQUEST_URI']);
|
||
exit();
|
||
}
|
||
} else {
|
||
// All other endpoints require the lax and the strict cookie
|
||
if(!$request->passesStrictCookieCheck()) {
|
||
self::sendSameSiteCookies();
|
||
// Debug mode gets access to the resources without strict cookie
|
||
// due to the fact that the SabreDAV browser also lives there.
|
||
if(!\OC::$server->getConfig()->getSystemValue('debug', false)) {
|
||
http_response_code(\OCP\AppFramework\Http::STATUS_SERVICE_UNAVAILABLE);
|
||
exit();
|
||
}
|
||
}
|
||
}
|
||
} elseif(!isset($_COOKIE['nc_sameSiteCookielax']) || !isset($_COOKIE['nc_sameSiteCookiestrict'])) {
|
||
self::sendSameSiteCookies();
|
||
}
|
||
}
|
||
|
||
public static function init() {
|
||
// calculate the root directories
|
||
OC::$SERVERROOT = str_replace("\\", '/', substr(__DIR__, 0, -4));
|
||
|
||
// register autoloader
|
||
$loaderStart = microtime(true);
|
||
require_once __DIR__ . '/autoloader.php';
|
||
self::$loader = new \OC\Autoloader([
|
||
OC::$SERVERROOT . '/lib/private/legacy',
|
||
]);
|
||
if (defined('PHPUNIT_RUN')) {
|
||
self::$loader->addValidRoot(OC::$SERVERROOT . '/tests');
|
||
}
|
||
spl_autoload_register(array(self::$loader, 'load'));
|
||
$loaderEnd = microtime(true);
|
||
|
||
self::$CLI = (php_sapi_name() == 'cli');
|
||
|
||
// Add default composer PSR-4 autoloader
|
||
self::$composerAutoloader = require_once OC::$SERVERROOT . '/lib/composer/autoload.php';
|
||
|
||
try {
|
||
self::initPaths();
|
||
// setup 3rdparty autoloader
|
||
$vendorAutoLoad = OC::$SERVERROOT. '/3rdparty/autoload.php';
|
||
if (!file_exists($vendorAutoLoad)) {
|
||
throw new \RuntimeException('Composer autoloader not found, unable to continue. Check the folder "3rdparty". Running "git submodule update --init" will initialize the git submodule that handles the subfolder "3rdparty".');
|
||
}
|
||
require_once $vendorAutoLoad;
|
||
|
||
} catch (\RuntimeException $e) {
|
||
if (!self::$CLI) {
|
||
$claimedProtocol = strtoupper($_SERVER['SERVER_PROTOCOL']);
|
||
$protocol = in_array($claimedProtocol, ['HTTP/1.0', 'HTTP/1.1', 'HTTP/2']) ? $claimedProtocol : 'HTTP/1.1';
|
||
header($protocol . ' ' . OC_Response::STATUS_SERVICE_UNAVAILABLE);
|
||
}
|
||
// we can't use the template error page here, because this needs the
|
||
// DI container which isn't available yet
|
||
print($e->getMessage());
|
||
exit();
|
||
}
|
||
|
||
// setup the basic server
|
||
self::$server = new \OC\Server(\OC::$WEBROOT, self::$config);
|
||
\OC::$server->getEventLogger()->log('autoloader', 'Autoloader', $loaderStart, $loaderEnd);
|
||
\OC::$server->getEventLogger()->start('boot', 'Initialize');
|
||
|
||
// Don't display errors and log them
|
||
error_reporting(E_ALL | E_STRICT);
|
||
@ini_set('display_errors', 0);
|
||
@ini_set('log_errors', 1);
|
||
|
||
if(!date_default_timezone_set('UTC')) {
|
||
throw new \RuntimeException('Could not set timezone to UTC');
|
||
};
|
||
|
||
//try to configure php to enable big file uploads.
|
||
//this doesn´t work always depending on the webserver and php configuration.
|
||
//Let´s try to overwrite some defaults anyway
|
||
|
||
//try to set the maximum execution time to 60min
|
||
@set_time_limit(3600);
|
||
@ini_set('max_execution_time', 3600);
|
||
@ini_set('max_input_time', 3600);
|
||
|
||
//try to set the maximum filesize to 10G
|
||
@ini_set('upload_max_filesize', '10G');
|
||
@ini_set('post_max_size', '10G');
|
||
@ini_set('file_uploads', '50');
|
||
|
||
self::setRequiredIniValues();
|
||
self::handleAuthHeaders();
|
||
self::registerAutoloaderCache();
|
||
|
||
// initialize intl fallback is necessary
|
||
\Patchwork\Utf8\Bootup::initIntl();
|
||
OC_Util::isSetLocaleWorking();
|
||
|
||
if (!defined('PHPUNIT_RUN')) {
|
||
OC\Log\ErrorHandler::setLogger(\OC::$server->getLogger());
|
||
$debug = \OC::$server->getConfig()->getSystemValue('debug', false);
|
||
OC\Log\ErrorHandler::register($debug);
|
||
}
|
||
|
||
// register the stream wrappers
|
||
stream_wrapper_register('fakedir', 'OC\Files\Stream\Dir');
|
||
stream_wrapper_register('static', 'OC\Files\Stream\StaticStream');
|
||
stream_wrapper_register('close', 'OC\Files\Stream\Close');
|
||
stream_wrapper_register('quota', 'OC\Files\Stream\Quota');
|
||
|
||
\OC::$server->getEventLogger()->start('init_session', 'Initialize session');
|
||
OC_App::loadApps(array('session'));
|
||
if (!self::$CLI) {
|
||
self::initSession();
|
||
}
|
||
\OC::$server->getEventLogger()->end('init_session');
|
||
self::checkConfig();
|
||
self::checkInstalled();
|
||
|
||
OC_Response::addSecurityHeaders();
|
||
if(self::$server->getRequest()->getServerProtocol() === 'https') {
|
||
ini_set('session.cookie_secure', true);
|
||
}
|
||
|
||
self::performSameSiteCookieProtection();
|
||
|
||
if (!defined('OC_CONSOLE')) {
|
||
$errors = OC_Util::checkServer(\OC::$server->getConfig());
|
||
if (count($errors) > 0) {
|
||
if (self::$CLI) {
|
||
// Convert l10n string into regular string for usage in database
|
||
$staticErrors = [];
|
||
foreach ($errors as $error) {
|
||
echo $error['error'] . "\n";
|
||
echo $error['hint'] . "\n\n";
|
||
$staticErrors[] = [
|
||
'error' => (string)$error['error'],
|
||
'hint' => (string)$error['hint'],
|
||
];
|
||
}
|
||
|
||
try {
|
||
\OC::$server->getConfig()->setAppValue('core', 'cronErrors', json_encode($staticErrors));
|
||
} catch (\Exception $e) {
|
||
echo('Writing to database failed');
|
||
}
|
||
exit(1);
|
||
} else {
|
||
OC_Response::setStatus(OC_Response::STATUS_SERVICE_UNAVAILABLE);
|
||
OC_Template::printGuestPage('', 'error', array('errors' => $errors));
|
||
exit;
|
||
}
|
||
} elseif (self::$CLI && \OC::$server->getConfig()->getSystemValue('installed', false)) {
|
||
\OC::$server->getConfig()->deleteAppValue('core', 'cronErrors');
|
||
}
|
||
}
|
||
//try to set the session lifetime
|
||
$sessionLifeTime = self::getSessionLifeTime();
|
||
@ini_set('gc_maxlifetime', (string)$sessionLifeTime);
|
||
|
||
$systemConfig = \OC::$server->getSystemConfig();
|
||
|
||
// User and Groups
|
||
if (!$systemConfig->getValue("installed", false)) {
|
||
self::$server->getSession()->set('user_id', '');
|
||
}
|
||
|
||
OC_User::useBackend(new \OC\User\Database());
|
||
OC_Group::useBackend(new \OC\Group\Database());
|
||
|
||
// Subscribe to the hook
|
||
\OCP\Util::connectHook(
|
||
'\OCA\Files_Sharing\API\Server2Server',
|
||
'preLoginNameUsedAsUserName',
|
||
'\OC\User\Database',
|
||
'preLoginNameUsedAsUserName'
|
||
);
|
||
|
||
//setup extra user backends
|
||
if (!self::checkUpgrade(false)) {
|
||
OC_User::setupBackends();
|
||
} else {
|
||
// Run upgrades in incognito mode
|
||
OC_User::setIncognitoMode(true);
|
||
}
|
||
|
||
self::registerCacheHooks();
|
||
self::registerFilesystemHooks();
|
||
if ($systemConfig->getValue('enable_previews', true)) {
|
||
self::registerPreviewHooks();
|
||
}
|
||
self::registerShareHooks();
|
||
self::registerLogRotate();
|
||
self::registerEncryptionWrapper();
|
||
self::registerEncryptionHooks();
|
||
self::registerSettingsHooks();
|
||
|
||
//make sure temporary files are cleaned up
|
||
$tmpManager = \OC::$server->getTempManager();
|
||
register_shutdown_function(array($tmpManager, 'clean'));
|
||
$lockProvider = \OC::$server->getLockingProvider();
|
||
register_shutdown_function(array($lockProvider, 'releaseAll'));
|
||
|
||
// Check whether the sample configuration has been copied
|
||
if($systemConfig->getValue('copied_sample_config', false)) {
|
||
$l = \OC::$server->getL10N('lib');
|
||
header('HTTP/1.1 503 Service Temporarily Unavailable');
|
||
header('Status: 503 Service Temporarily Unavailable');
|
||
OC_Template::printErrorPage(
|
||
$l->t('Sample configuration detected'),
|
||
$l->t('It has been detected that the sample configuration has been copied. This can break your installation and is unsupported. Please read the documentation before performing changes on config.php')
|
||
);
|
||
return;
|
||
}
|
||
|
||
$request = \OC::$server->getRequest();
|
||
$host = $request->getInsecureServerHost();
|
||
/**
|
||
* if the host passed in headers isn't trusted
|
||
* FIXME: Should not be in here at all :see_no_evil:
|
||
*/
|
||
if (!OC::$CLI
|
||
// overwritehost is always trusted, workaround to not have to make
|
||
// \OC\AppFramework\Http\Request::getOverwriteHost public
|
||
&& self::$server->getConfig()->getSystemValue('overwritehost') === ''
|
||
&& !\OC::$server->getTrustedDomainHelper()->isTrustedDomain($host)
|
||
&& self::$server->getConfig()->getSystemValue('installed', false)
|
||
) {
|
||
header('HTTP/1.1 400 Bad Request');
|
||
header('Status: 400 Bad Request');
|
||
|
||
\OC::$server->getLogger()->warning(
|
||
'Trusted domain error. "{remoteAddress}" tried to access using "{host}" as host.',
|
||
[
|
||
'app' => 'core',
|
||
'remoteAddress' => $request->getRemoteAddress(),
|
||
'host' => $host,
|
||
]
|
||
);
|
||
|
||
$tmpl = new OCP\Template('core', 'untrustedDomain', 'guest');
|
||
$tmpl->assign('domain', $host);
|
||
$tmpl->printPage();
|
||
|
||
exit();
|
||
}
|
||
\OC::$server->getEventLogger()->end('boot');
|
||
}
|
||
|
||
/**
|
||
* register hooks for the cache
|
||
*/
|
||
public static function registerCacheHooks() {
|
||
//don't try to do this before we are properly setup
|
||
if (\OC::$server->getSystemConfig()->getValue('installed', false) && !self::checkUpgrade(false)) {
|
||
|
||
// NOTE: This will be replaced to use OCP
|
||
$userSession = self::$server->getUserSession();
|
||
$userSession->listen('\OC\User', 'postLogin', function () {
|
||
try {
|
||
$cache = new \OC\Cache\File();
|
||
$cache->gc();
|
||
} catch (\OC\ServerNotAvailableException $e) {
|
||
// not a GC exception, pass it on
|
||
throw $e;
|
||
} catch (\Exception $e) {
|
||
// a GC exception should not prevent users from using OC,
|
||
// so log the exception
|
||
\OC::$server->getLogger()->warning('Exception when running cache gc: ' . $e->getMessage(), array('app' => 'core'));
|
||
}
|
||
});
|
||
}
|
||
}
|
||
|
||
public static function registerSettingsHooks() {
|
||
$dispatcher = \OC::$server->getEventDispatcher();
|
||
$dispatcher->addListener(OCP\App\ManagerEvent::EVENT_APP_DISABLE, function($event) {
|
||
/** @var \OCP\App\ManagerEvent $event */
|
||
\OC::$server->getSettingsManager()->onAppDisabled($event->getAppID());
|
||
});
|
||
$dispatcher->addListener(OCP\App\ManagerEvent::EVENT_APP_UPDATE, function($event) {
|
||
/** @var \OCP\App\ManagerEvent $event */
|
||
$jobList = \OC::$server->getJobList();
|
||
$job = 'OC\\Settings\\RemoveOrphaned';
|
||
if(!($jobList->has($job, null))) {
|
||
$jobList->add($job);
|
||
}
|
||
});
|
||
}
|
||
|
||
private static function registerEncryptionWrapper() {
|
||
$manager = self::$server->getEncryptionManager();
|
||
\OCP\Util::connectHook('OC_Filesystem', 'preSetup', $manager, 'setupStorage');
|
||
}
|
||
|
||
private static function registerEncryptionHooks() {
|
||
$enabled = self::$server->getEncryptionManager()->isEnabled();
|
||
if ($enabled) {
|
||
\OCP\Util::connectHook('OCP\Share', 'post_shared', 'OC\Encryption\HookManager', 'postShared');
|
||
\OCP\Util::connectHook('OCP\Share', 'post_unshare', 'OC\Encryption\HookManager', 'postUnshared');
|
||
\OCP\Util::connectHook('OC_Filesystem', 'post_rename', 'OC\Encryption\HookManager', 'postRename');
|
||
\OCP\Util::connectHook('\OCA\Files_Trashbin\Trashbin', 'post_restore', 'OC\Encryption\HookManager', 'postRestore');
|
||
}
|
||
}
|
||
|
||
/**
|
||
* register hooks for the cache
|
||
*/
|
||
public static function registerLogRotate() {
|
||
$systemConfig = \OC::$server->getSystemConfig();
|
||
if ($systemConfig->getValue('installed', false) && $systemConfig->getValue('log_rotate_size', false) && !self::checkUpgrade(false)) {
|
||
//don't try to do this before we are properly setup
|
||
//use custom logfile path if defined, otherwise use default of nextcloud.log in data directory
|
||
\OCP\BackgroundJob::registerJob('OC\Log\Rotate', $systemConfig->getValue('logfile', $systemConfig->getValue('datadirectory', OC::$SERVERROOT . '/data') . '/nextcloud.log'));
|
||
}
|
||
}
|
||
|
||
/**
|
||
* register hooks for the filesystem
|
||
*/
|
||
public static function registerFilesystemHooks() {
|
||
// Check for blacklisted files
|
||
OC_Hook::connect('OC_Filesystem', 'write', 'OC\Files\Filesystem', 'isBlacklisted');
|
||
OC_Hook::connect('OC_Filesystem', 'rename', 'OC\Files\Filesystem', 'isBlacklisted');
|
||
}
|
||
|
||
/**
|
||
* register hooks for previews
|
||
*/
|
||
public static function registerPreviewHooks() {
|
||
OC_Hook::connect('OC_Filesystem', 'post_write', 'OC\Preview', 'post_write');
|
||
OC_Hook::connect('OC_Filesystem', 'delete', 'OC\Preview', 'prepare_delete_files');
|
||
OC_Hook::connect('\OCP\Versions', 'preDelete', 'OC\Preview', 'prepare_delete');
|
||
OC_Hook::connect('\OCP\Trashbin', 'preDelete', 'OC\Preview', 'prepare_delete');
|
||
OC_Hook::connect('OC_Filesystem', 'post_delete', 'OC\Preview', 'post_delete_files');
|
||
OC_Hook::connect('\OCP\Versions', 'delete', 'OC\Preview', 'post_delete_versions');
|
||
OC_Hook::connect('\OCP\Trashbin', 'delete', 'OC\Preview', 'post_delete');
|
||
OC_Hook::connect('\OCP\Versions', 'rollback', 'OC\Preview', 'post_delete_versions');
|
||
}
|
||
|
||
/**
|
||
* register hooks for sharing
|
||
*/
|
||
public static function registerShareHooks() {
|
||
if (\OC::$server->getSystemConfig()->getValue('installed')) {
|
||
OC_Hook::connect('OC_User', 'post_deleteUser', 'OC\Share20\Hooks', 'post_deleteUser');
|
||
OC_Hook::connect('OC_User', 'post_removeFromGroup', 'OC\Share20\Hooks', 'post_removeFromGroup');
|
||
OC_Hook::connect('OC_User', 'post_deleteGroup', 'OC\Share20\Hooks', 'post_deleteGroup');
|
||
}
|
||
}
|
||
|
||
protected static function registerAutoloaderCache() {
|
||
// The class loader takes an optional low-latency cache, which MUST be
|
||
// namespaced. The instanceid is used for namespacing, but might be
|
||
// unavailable at this point. Furthermore, it might not be possible to
|
||
// generate an instanceid via \OC_Util::getInstanceId() because the
|
||
// config file may not be writable. As such, we only register a class
|
||
// loader cache if instanceid is available without trying to create one.
|
||
$instanceId = \OC::$server->getSystemConfig()->getValue('instanceid', null);
|
||
if ($instanceId) {
|
||
try {
|
||
$memcacheFactory = \OC::$server->getMemCacheFactory();
|
||
self::$loader->setMemoryCache($memcacheFactory->createLocal('Autoloader'));
|
||
} catch (\Exception $ex) {
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Handle the request
|
||
*/
|
||
public static function handleRequest() {
|
||
|
||
\OC::$server->getEventLogger()->start('handle_request', 'Handle request');
|
||
$systemConfig = \OC::$server->getSystemConfig();
|
||
// load all the classpaths from the enabled apps so they are available
|
||
// in the routing files of each app
|
||
OC::loadAppClassPaths();
|
||
|
||
// Check if Nextcloud is installed or in maintenance (update) mode
|
||
if (!$systemConfig->getValue('installed', false)) {
|
||
\OC::$server->getSession()->clear();
|
||
$setupHelper = new OC\Setup(\OC::$server->getConfig(), \OC::$server->getIniWrapper(),
|
||
\OC::$server->getL10N('lib'), \OC::$server->getThemingDefaults(), \OC::$server->getLogger(),
|
||
\OC::$server->getSecureRandom());
|
||
$controller = new OC\Core\Controller\SetupController($setupHelper);
|
||
$controller->run($_POST);
|
||
exit();
|
||
}
|
||
|
||
$request = \OC::$server->getRequest();
|
||
$requestPath = $request->getRawPathInfo();
|
||
if ($requestPath === '/heartbeat') {
|
||
return;
|
||
}
|
||
if (substr($requestPath, -3) !== '.js') { // we need these files during the upgrade
|
||
self::checkMaintenanceMode();
|
||
self::checkUpgrade();
|
||
}
|
||
|
||
// emergency app disabling
|
||
if ($requestPath === '/disableapp'
|
||
&& $request->getMethod() === 'POST'
|
||
&& ((string)$request->getParam('appid')) !== ''
|
||
) {
|
||
\OCP\JSON::callCheck();
|
||
\OCP\JSON::checkAdminUser();
|
||
$appId = (string)$request->getParam('appid');
|
||
$appId = \OC_App::cleanAppId($appId);
|
||
|
||
\OC_App::disable($appId);
|
||
\OC_JSON::success();
|
||
exit();
|
||
}
|
||
|
||
// Always load authentication apps
|
||
OC_App::loadApps(['authentication']);
|
||
|
||
// Load minimum set of apps
|
||
if (!self::checkUpgrade(false)
|
||
&& !$systemConfig->getValue('maintenance', false)) {
|
||
// For logged-in users: Load everything
|
||
if(OC_User::isLoggedIn()) {
|
||
OC_App::loadApps();
|
||
} else {
|
||
// For guests: Load only filesystem and logging
|
||
OC_App::loadApps(array('filesystem', 'logging'));
|
||
self::handleLogin($request);
|
||
}
|
||
}
|
||
|
||
if (!self::$CLI) {
|
||
try {
|
||
if (!$systemConfig->getValue('maintenance', false) && !self::checkUpgrade(false)) {
|
||
OC_App::loadApps(array('filesystem', 'logging'));
|
||
OC_App::loadApps();
|
||
}
|
||
self::checkSingleUserMode();
|
||
OC_Util::setupFS();
|
||
OC::$server->getRouter()->match(\OC::$server->getRequest()->getRawPathInfo());
|
||
return;
|
||
} catch (Symfony\Component\Routing\Exception\ResourceNotFoundException $e) {
|
||
//header('HTTP/1.0 404 Not Found');
|
||
} catch (Symfony\Component\Routing\Exception\MethodNotAllowedException $e) {
|
||
OC_Response::setStatus(405);
|
||
return;
|
||
}
|
||
}
|
||
|
||
// Handle WebDAV
|
||
if ($_SERVER['REQUEST_METHOD'] == 'PROPFIND') {
|
||
// not allowed any more to prevent people
|
||
// mounting this root directly.
|
||
// Users need to mount remote.php/webdav instead.
|
||
header('HTTP/1.1 405 Method Not Allowed');
|
||
header('Status: 405 Method Not Allowed');
|
||
return;
|
||
}
|
||
|
||
// Someone is logged in
|
||
if (OC_User::isLoggedIn()) {
|
||
OC_App::loadApps();
|
||
OC_User::setupBackends();
|
||
OC_Util::setupFS();
|
||
// FIXME
|
||
// Redirect to default application
|
||
OC_Util::redirectToDefaultPage();
|
||
} else {
|
||
// Not handled and not logged in
|
||
header('Location: '.\OC::$server->getURLGenerator()->linkToRouteAbsolute('core.login.showLoginForm'));
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Check login: apache auth, auth token, basic auth
|
||
*
|
||
* @param OCP\IRequest $request
|
||
* @return boolean
|
||
*/
|
||
static function handleLogin(OCP\IRequest $request) {
|
||
$userSession = self::$server->getUserSession();
|
||
if (OC_User::handleApacheAuth()) {
|
||
return true;
|
||
}
|
||
if ($userSession->tryTokenLogin($request)) {
|
||
return true;
|
||
}
|
||
if (isset($_COOKIE['nc_username'])
|
||
&& isset($_COOKIE['nc_token'])
|
||
&& isset($_COOKIE['nc_session_id'])
|
||
&& $userSession->loginWithCookie($_COOKIE['nc_username'], $_COOKIE['nc_token'], $_COOKIE['nc_session_id'])) {
|
||
return true;
|
||
}
|
||
if ($userSession->tryBasicAuthLogin($request, \OC::$server->getBruteForceThrottler())) {
|
||
return true;
|
||
}
|
||
return false;
|
||
}
|
||
|
||
protected static function handleAuthHeaders() {
|
||
//copy http auth headers for apache+php-fcgid work around
|
||
if (isset($_SERVER['HTTP_XAUTHORIZATION']) && !isset($_SERVER['HTTP_AUTHORIZATION'])) {
|
||
$_SERVER['HTTP_AUTHORIZATION'] = $_SERVER['HTTP_XAUTHORIZATION'];
|
||
}
|
||
|
||
// Extract PHP_AUTH_USER/PHP_AUTH_PW from other headers if necessary.
|
||
$vars = array(
|
||
'HTTP_AUTHORIZATION', // apache+php-cgi work around
|
||
'REDIRECT_HTTP_AUTHORIZATION', // apache+php-cgi alternative
|
||
);
|
||
foreach ($vars as $var) {
|
||
if (isset($_SERVER[$var]) && preg_match('/Basic\s+(.*)$/i', $_SERVER[$var], $matches)) {
|
||
list($name, $password) = explode(':', base64_decode($matches[1]), 2);
|
||
$_SERVER['PHP_AUTH_USER'] = $name;
|
||
$_SERVER['PHP_AUTH_PW'] = $password;
|
||
break;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
OC::init();
|