| # Copyright 2015 The Chromium OS Authors. All rights reserved. |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| |
| import logging |
| |
| from autotest_lib.client.common_lib import error |
| from autotest_lib.client.cros import enterprise_policy_base |
| |
| |
| class policy_ForceGoogleSafeSearch(enterprise_policy_base.EnterprisePolicyTest): |
| """Test effect of ForceGoogleSafeSearch policy on Chrome OS behavior. |
| |
| This test verifies that the ForceGoogleSafeSearch user policy controls |
| whether Chrome OS enforces the use of Google Safe Search. The test covers |
| all valid policy values across three test cases: NotSet_NotSafe, |
| False_NotSafe, and True_Safe. |
| |
| A test case shall pass if the omnibox appends (or does not append) the |
| safe parameter to the search URL when the policy is set true (or is set |
| false or is not set). A test case shall fail if the above behavior is |
| not enforced. |
| |
| Note that DefaultSearchProviderEnabled must be not set (i.e., set to |
| None) for this test to work. |
| |
| """ |
| version = 1 |
| |
| POLICY_NAME = 'ForceGoogleSafeSearch' |
| TEST_CASES = { |
| 'True_Safe': True, |
| 'False_NotSafe': False, |
| 'NotSet_NotSafe': None |
| } |
| SUPPORTING_POLICIES = { |
| 'DefaultSearchProviderEnabled': None |
| } |
| GOOGLE_SEARCH_URL = 'https://www.google.com/search?q=kittens' |
| |
| def _test_force_safe_search(self, policy_value, policies_dict): |
| """Verify CrOS enforces ForceGoogleSafeSearch policy. |
| |
| When ForceGoogleSafeSearch is set true, then Chrome OS shall append |
| the safe search parameter to the Google Search URL, and set it active. |
| When set false or is not set, then Chrome OS shall not append the safe |
| search parameter to the search URL. |
| |
| @param policy_value: policy value string expected on policy page. |
| @param policies_dict: policy dict data to send to the fake DM server. |
| |
| """ |
| logging.info('Running _test_force_safe_search(policy_value=%s, ' |
| 'policies_dict=%s)', policy_value, policies_dict) |
| self.setup_case(self.POLICY_NAME, policy_value, policies_dict) |
| tab = self.navigate_to_url(self.GOOGLE_SEARCH_URL) |
| is_safe_search_active = True if '&safe=active' in tab.url else False |
| if policy_value == 'true': |
| if not is_safe_search_active: |
| raise error.TestFail('Safe search should be active.') |
| else: |
| if is_safe_search_active: |
| raise error.TestFail('Safe search should not be active.') |
| |
| def run_test_case(self, case): |
| """Setup and run the test configured for the specified test case. |
| |
| Set the expected |policy_value| and |policies_dict| data based on the |
| test |case|. |
| |
| @param case: Name of the test case to run. |
| |
| """ |
| policy_value = self.packed_json_string(self.TEST_CASES[case]) |
| policy_dict = {self.POLICY_NAME: self.TEST_CASES[case]} |
| policies_dict = self.SUPPORTING_POLICIES.copy() |
| policies_dict.update(policy_dict) |
| self._test_force_safe_search(policy_value, policies_dict) |