class SecurityAdvisoriesFetcher

Same name in other branches
  1. 10 core/modules/system/src/SecurityAdvisories/SecurityAdvisoriesFetcher.php \Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher
  2. 11.x core/modules/system/src/SecurityAdvisories/SecurityAdvisoriesFetcher.php \Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher

Defines a service to get security advisories.

Hierarchy

Expanded class hierarchy of SecurityAdvisoriesFetcher

1 file declares its use of SecurityAdvisoriesFetcher
AdvisoriesConfigSubscriber.php in core/modules/system/src/EventSubscriber/AdvisoriesConfigSubscriber.php
1 string reference to 'SecurityAdvisoriesFetcher'
system.services.yml in core/modules/system/system.services.yml
core/modules/system/system.services.yml
1 service uses SecurityAdvisoriesFetcher
system.sa_fetcher in core/modules/system/system.services.yml
Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher

File

core/modules/system/src/SecurityAdvisories/SecurityAdvisoriesFetcher.php, line 22

Namespace

Drupal\system\SecurityAdvisories
View source
final class SecurityAdvisoriesFetcher {
    
    /**
     * The key to use to store the advisories feed response.
     */
    protected const ADVISORIES_JSON_EXPIRABLE_KEY = 'advisories_response';
    
    /**
     * The 'system.advisories' configuration.
     *
     * @var \Drupal\Core\Config\ImmutableConfig
     */
    protected $config;
    
    /**
     * The HTTP client.
     *
     * @var \GuzzleHttp\Client
     */
    protected $httpClient;
    
    /**
     * The expirable key/value store for the advisories JSON response.
     *
     * @var \Drupal\Core\KeyValueStore\KeyValueStoreExpirableInterface
     */
    protected $keyValueExpirable;
    
    /**
     * Array of extension lists, keyed by extension type.
     *
     * @var \Drupal\Core\Extension\ExtensionList[]
     */
    protected $extensionLists = [];
    
    /**
     * The logger.
     *
     * @var \Psr\Log\LoggerInterface
     */
    protected $logger;
    
    /**
     * Whether to fall back to HTTP if the HTTPS request fails.
     *
     * @var bool
     */
    protected $withHttpFallback;
    
    /**
     * Constructs a new SecurityAdvisoriesFetcher object.
     *
     * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
     *   The config factory.
     * @param \Drupal\Core\KeyValueStore\KeyValueExpirableFactoryInterface $key_value_factory
     *   The expirable key/value factory.
     * @param \GuzzleHttp\ClientInterface $client
     *   The HTTP client.
     * @param \Drupal\Core\Extension\ModuleExtensionList $module_list
     *   The module extension list.
     * @param \Drupal\Core\Extension\ThemeExtensionList $theme_list
     *   The theme extension list.
     * @param \Drupal\Core\Extension\ProfileExtensionList $profile_list
     *   The profile extension list.
     * @param \Psr\Log\LoggerInterface $logger
     *   The logger.
     * @param \Drupal\Core\Site\Settings $settings
     *   The settings instance.
     */
    public function __construct(ConfigFactoryInterface $config_factory, KeyValueExpirableFactoryInterface $key_value_factory, ClientInterface $client, ModuleExtensionList $module_list, ThemeExtensionList $theme_list, ProfileExtensionList $profile_list, LoggerInterface $logger, Settings $settings) {
        $this->config = $config_factory->get('system.advisories');
        $this->keyValueExpirable = $key_value_factory->get('system');
        $this->httpClient = $client;
        $this->extensionLists['module'] = $module_list;
        $this->extensionLists['theme'] = $theme_list;
        $this->extensionLists['profile'] = $profile_list;
        $this->logger = $logger;
        $this->withHttpFallback = $settings->get('update_fetch_with_http_fallback', FALSE);
    }
    
    /**
     * Gets security advisories that are applicable for the current site.
     *
     * @param bool $allow_outgoing_request
     *   (optional) Whether to allow an outgoing request to fetch the advisories
     *   if there is no stored JSON response. Defaults to TRUE.
     * @param int $timeout
     *   (optional) The timeout in seconds for the request. Defaults to 0, which
     *   is no timeout.
     *
     * @return \Drupal\system\SecurityAdvisories\SecurityAdvisory[]|null
     *   The upstream security advisories, if any. NULL if there was a problem
     *   retrieving the JSON feed, or if there was no stored response and
     *   $allow_outgoing_request was set to FALSE.
     *
     * @throws \GuzzleHttp\Exception\TransferException
     *   Thrown if an error occurs while retrieving security advisories.
     */
    public function getSecurityAdvisories(bool $allow_outgoing_request = TRUE, int $timeout = 0) : ?array {
        $advisories = [];
        $json_payload = $this->keyValueExpirable
            ->get(self::ADVISORIES_JSON_EXPIRABLE_KEY);
        // If $json_payload is not an array then it was not set in this method or
        // has expired in which case we should try to retrieve the advisories.
        if (!is_array($json_payload)) {
            if (!$allow_outgoing_request) {
                return NULL;
            }
            $response = $this->doRequest($timeout);
            $interval_seconds = $this->config
                ->get('interval_hours') * 60 * 60;
            $json_payload = Json::decode($response);
            if (is_array($json_payload)) {
                // Only store and use the response if it could be successfully
                // decoded to an array from the JSON string.
                // This value will be deleted if the 'advisories.interval_hours' config
                // is changed to a lower value.
                // @see \Drupal\update\EventSubscriber\ConfigSubscriber::onConfigSave()
                $this->keyValueExpirable
                    ->setWithExpire(self::ADVISORIES_JSON_EXPIRABLE_KEY, $json_payload, $interval_seconds);
            }
            else {
                $this->logger
                    ->error('The security advisory JSON feed from Drupal.org could not be decoded.');
                return NULL;
            }
        }
        foreach ($json_payload as $advisory_data) {
            try {
                $sa = SecurityAdvisory::createFromArray($advisory_data);
            } catch (\UnexpectedValueException $unexpected_value_exception) {
                // Ignore items in the feed that are in an invalid format. Although
                // this is highly unlikely we should still display the items that are
                // in the correct format.
                watchdog_exception('system', $unexpected_value_exception, 'Invalid security advisory format: ' . Json::encode($advisory_data));
                continue;
            }
            if ($this->isApplicable($sa)) {
                $advisories[] = $sa;
            }
        }
        return $advisories;
    }
    
    /**
     * Deletes the stored JSON feed response, if any.
     */
    public function deleteStoredResponse() : void {
        $this->keyValueExpirable
            ->delete(self::ADVISORIES_JSON_EXPIRABLE_KEY);
    }
    
    /**
     * Determines if an advisory matches the existing version of a project.
     *
     * @param \Drupal\system\SecurityAdvisories\SecurityAdvisory $sa
     *   The security advisory.
     *
     * @return bool
     *   TRUE if the security advisory matches the existing version of the
     *   project, or FALSE otherwise.
     */
    protected function matchesExistingVersion(SecurityAdvisory $sa) : bool {
        if ($existing_version = $this->getProjectExistingVersion($sa)) {
            $existing_project_version = ExtensionVersion::createFromVersionString($existing_version);
            $insecure_versions = $sa->getInsecureVersions();
            // If a site codebase has a development version of any project, including
            // core, we cannot be certain if their development build has the security
            // vulnerabilities that make any of the versions in $insecure_versions
            // insecure. Therefore, we should err on the side of assuming the site's
            // code does have the security vulnerabilities and show the advisories.
            // This will result in some sites seeing advisories that do not affect
            // their versions, but it will make it less likely that sites with the
            // security vulnerabilities will not see the advisories.
            if ($existing_project_version->getVersionExtra() === 'dev') {
                foreach ($insecure_versions as $insecure_version) {
                    try {
                        $insecure_project_version = ExtensionVersion::createFromVersionString($insecure_version);
                    } catch (\UnexpectedValueException $exception) {
                        // An invalid version string should not halt the evaluation of valid
                        // versions in $insecure_versions. Version numbers that start with
                        // core prefix besides '8.x-' are allowed in $insecure_versions,
                        // but will never match and will throw an exception.
                        continue;
                    }
                    if ($existing_project_version->getMajorVersion() === $insecure_project_version->getMajorVersion()) {
                        if ($existing_project_version->getMinorVersion() === NULL) {
                            // If the dev version doesn't specify a minor version, matching on
                            // the major version alone is considered a match.
                            return TRUE;
                        }
                        if ($existing_project_version->getMinorVersion() === $insecure_project_version->getMinorVersion()) {
                            // If the dev version specifies a minor version, then the insecure
                            // version must match on the minor version.
                            return TRUE;
                        }
                    }
                }
            }
            else {
                // If the existing version is not a dev version, then it must match an
                // insecure version exactly.
                return in_array($existing_version, $insecure_versions, TRUE);
            }
        }
        return FALSE;
    }
    
    /**
     * Gets the information for an extension affected by the security advisory.
     *
     * @param \Drupal\system\SecurityAdvisories\SecurityAdvisory $sa
     *   The security advisory.
     *
     * @return mixed[]|null
     *   The information as set in the info.yml file and then processed by the
     *   corresponding extension list for the first extension found that matches
     *   the project name of the security advisory. If no matching extension is
     *   found NULL is returned.
     */
    protected function getMatchingExtensionInfo(SecurityAdvisory $sa) : ?array {
        if (!isset($this->extensionLists[$sa->getProjectType()])) {
            return NULL;
        }
        $project_info = new ProjectInfo();
        // The project name on the security advisory will not always match the
        // machine name for the extension, so we need to search through all
        // extensions of the expected type to find the matching project.
        foreach ($this->extensionLists[$sa->getProjectType()]
            ->getList() as $extension) {
            if ($project_info->getProjectName($extension) === $sa->getProject()) {
                return $extension->info;
            }
        }
        return NULL;
    }
    
    /**
     * Gets the existing project version.
     *
     * @param \Drupal\system\SecurityAdvisories\SecurityAdvisory $sa
     *   The security advisory.
     *
     * @return string|null
     *   The project version, or NULL if the project does not exist on
     *   the site.
     */
    protected function getProjectExistingVersion(SecurityAdvisory $sa) : ?string {
        if ($sa->isCoreAdvisory()) {
            return \Drupal::VERSION;
        }
        $extension_info = $this->getMatchingExtensionInfo($sa);
        return $extension_info['version'] ?? NULL;
    }
    
    /**
     * Determines if a security advisory is applicable for the current site.
     *
     * @param \Drupal\system\SecurityAdvisories\SecurityAdvisory $sa
     *   The security advisory.
     *
     * @return bool
     *   TRUE if the advisory is applicable for the current site, or FALSE
     *   otherwise.
     */
    protected function isApplicable(SecurityAdvisory $sa) : bool {
        // Only projects that are in the site's codebase can be applicable. Core
        // will always be in the codebase, and other projects are in the codebase if
        // ::getProjectInfo() finds a matching extension for the project name.
        if ($sa->isCoreAdvisory() || $this->getMatchingExtensionInfo($sa)) {
            // Public service announcements are always applicable because they are not
            // dependent on the version of the project that is currently present on
            // the site. Other advisories are only applicable if they match the
            // existing version.
            return $sa->isPsa() || $this->matchesExistingVersion($sa);
        }
        return FALSE;
    }
    
    /**
     * Makes an HTTPS GET request, with a possible HTTP fallback.
     *
     * This method will fall back to HTTP if the HTTPS request fails and the site
     * setting 'update_fetch_with_http_fallback' is set to TRUE.
     *
     * @param int $timeout
     *   The timeout in seconds for the request.
     *
     * @return string
     *   The response.
     */
    protected function doRequest(int $timeout) : string {
        $options = [
            RequestOptions::TIMEOUT => $timeout,
        ];
        if (!$this->withHttpFallback) {
            // If not using an HTTP fallback just use HTTPS and do not catch any
            // exceptions.
            $response = $this->httpClient
                ->get('https://updates.drupal.org/psa.json', $options);
        }
        else {
            try {
                $response = $this->httpClient
                    ->get('https://updates.drupal.org/psa.json', $options);
            } catch (TransferException $exception) {
                watchdog_exception('system', $exception);
                $response = $this->httpClient
                    ->get('http://updates.drupal.org/psa.json', $options);
            }
        }
        return (string) $response->getBody();
    }

}

Members

Title Sort descending Modifiers Object type Summary
SecurityAdvisoriesFetcher::$config protected property The 'system.advisories' configuration.
SecurityAdvisoriesFetcher::$extensionLists protected property Array of extension lists, keyed by extension type.
SecurityAdvisoriesFetcher::$httpClient protected property The HTTP client.
SecurityAdvisoriesFetcher::$keyValueExpirable protected property The expirable key/value store for the advisories JSON response.
SecurityAdvisoriesFetcher::$logger protected property The logger.
SecurityAdvisoriesFetcher::$withHttpFallback protected property Whether to fall back to HTTP if the HTTPS request fails.
SecurityAdvisoriesFetcher::ADVISORIES_JSON_EXPIRABLE_KEY protected constant The key to use to store the advisories feed response.
SecurityAdvisoriesFetcher::deleteStoredResponse public function Deletes the stored JSON feed response, if any.
SecurityAdvisoriesFetcher::doRequest protected function Makes an HTTPS GET request, with a possible HTTP fallback.
SecurityAdvisoriesFetcher::getMatchingExtensionInfo protected function Gets the information for an extension affected by the security advisory.
SecurityAdvisoriesFetcher::getProjectExistingVersion protected function Gets the existing project version.
SecurityAdvisoriesFetcher::getSecurityAdvisories public function Gets security advisories that are applicable for the current site.
SecurityAdvisoriesFetcher::isApplicable protected function Determines if a security advisory is applicable for the current site.
SecurityAdvisoriesFetcher::matchesExistingVersion protected function Determines if an advisory matches the existing version of a project.
SecurityAdvisoriesFetcher::__construct public function Constructs a new SecurityAdvisoriesFetcher object.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.