function drupal_valid_test_ua

7.x bootstrap.inc drupal_valid_test_ua()
8.x bootstrap.inc drupal_valid_test_ua($new_prefix = NULL)

Returns the test prefix if this is an internal request from SimpleTest.

Return value

Either the simpletest prefix (the string "simpletest" followed by any number of digits) or FALSE if the user agent does not contain a valid HMAC and timestamp.

8 calls to drupal_valid_test_ua()
drupal_system_listing in drupal/includes/common.inc
Returns information about system object files (modules, themes, etc.).
http.php in drupal/modules/simpletest/tests/http.php
Fake an HTTP request, for use during testing.
https.php in drupal/modules/simpletest/tests/https.php
Fake an HTTPS request, for use during testing.
SimpleTestBrokenSetUp::setUp in drupal/modules/simpletest/simpletest.test
Sets up a Drupal site for running functional and integration tests.
SimpleTestBrokenSetUp::tearDown in drupal/modules/simpletest/simpletest.test
Delete created files and temporary files directory, delete the tables created by setUp(), and reset the database prefix.

... See full list

File

drupal/includes/bootstrap.inc, line 2533
Functions that need to be loaded on every Drupal request.

Code

function drupal_valid_test_ua() {
  // No reason to reset this.
  static $test_prefix;

  if (isset($test_prefix)) {
    return $test_prefix;
  }

  if (isset($_SERVER['HTTP_USER_AGENT']) && preg_match("/^(simpletest\d+);(.+);(.+);(.+)$/", $_SERVER['HTTP_USER_AGENT'], $matches)) {
    list(, $prefix, $time, $salt, $hmac) = $matches;
    $check_string = $prefix . ';' . $time . ';' . $salt;
    // We use the salt from settings.php to make the HMAC key, since
    // the database is not yet initialized and we can't access any Drupal variables.
    // The file properties add more entropy not easily accessible to others.
    $key = drupal_get_hash_salt() . filectime(__FILE__) . fileinode(__FILE__);
    $time_diff = REQUEST_TIME - $time;
    // Since we are making a local request a 5 second time window is allowed,
    // and the HMAC must match.
    if ($time_diff >= 0 && $time_diff <= 5 && $hmac == drupal_hmac_base64($check_string, $key)) {
      $test_prefix = $prefix;
      return $test_prefix;
    }
  }

  $test_prefix = FALSE;
  return $test_prefix;
}