| # Copyright 2022 The Chromium Authors |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| """Base classes for Monorail Flask servlets. |
| |
| This is derived from servlet.py |
| This base class provides handler methods that conveniently drive |
| the process of parsing the request, checking base permisssion, |
| gathering common page information, gathering page-specific information, |
| and adding on-page debugging information (when appropriate). |
| Subclasses can simply implement the page-specific logic. |
| |
| Summary of page classes: |
| Servlet: abstract base class for all Monorail flask servlets. |
| """ |
| |
| import gc |
| import os |
| import logging |
| from six.moves import http_client |
| import time |
| from businesslogic import work_env |
| |
| import ezt |
| from features import features_bizobj, hotlist_views |
| import flask |
| import httpagentparser |
| from project import project_constants |
| from mrproto import project_pb2 |
| from search import query2ast |
| |
| import settings |
| from framework import alerts, exceptions, framework_helpers, urls |
| from framework import framework_views, servlet_helpers |
| from framework import framework_constants |
| from framework import monorailrequest |
| from framework import permissions |
| from framework import ratelimiter |
| from framework import template_helpers |
| from framework import xsrf |
| |
| from google.appengine.api import app_identity |
| from google.appengine.api import modules |
| from google.appengine.api import users |
| from tracker import tracker_views |
| from werkzeug import datastructures |
| |
| NONCE_LENGTH = 32 |
| |
| if not settings.unit_test_mode: |
| import MySQLdb |
| |
| class Servlet(object): |
| """Base class for all Monorail flask servlets. |
| |
| Defines a framework of methods that build up parts of the EZT page data. |
| |
| Subclasses should override GatherPageData and/or ProcessFormData to |
| handle requests. |
| """ |
| _MAIN_TAB_MODE = None # Normally overridden in subclasses to be one of these: |
| |
| MAIN_TAB_NONE = 't0' |
| MAIN_TAB_DASHBOARD = 't1' |
| MAIN_TAB_ISSUES = 't2' |
| MAIN_TAB_PEOPLE = 't3' |
| MAIN_TAB_PROCESS = 't4' |
| MAIN_TAB_UPDATES = 't5' |
| MAIN_TAB_ADMIN = 't6' |
| MAIN_TAB_DETAILS = 't7' |
| PROCESS_TAB_SUMMARY = 'st1' |
| PROCESS_TAB_STATUSES = 'st3' |
| PROCESS_TAB_LABELS = 'st4' |
| PROCESS_TAB_RULES = 'st5' |
| PROCESS_TAB_TEMPLATES = 'st6' |
| PROCESS_TAB_COMPONENTS = 'st7' |
| PROCESS_TAB_VIEWS = 'st8' |
| ADMIN_TAB_META = 'st1' |
| ADMIN_TAB_ADVANCED = 'st9' |
| HOTLIST_TAB_ISSUES = 'ht2' |
| HOTLIST_TAB_PEOPLE = 'ht3' |
| HOTLIST_TAB_DETAILS = 'ht4' |
| |
| # Most forms require a security token, however if a form is really |
| # just redirecting to a search GET request without writing any data, |
| # subclass can override this to allow anonymous use. |
| CHECK_SECURITY_TOKEN = True |
| |
| # Some pages might be posted to by clients outside of Monorail. |
| # ie: The issue entry page, by the issue filing wizard. In these cases, |
| # we can allow an xhr-scoped XSRF token to be used to post to the page. |
| ALLOW_XHR = False |
| |
| # This value should not typically be overridden. |
| _TEMPLATE_PATH = framework_constants.TEMPLATE_PATH |
| |
| _PAGE_TEMPLATE = None # Normally overridden in subclasses. |
| _ELIMINATE_BLANK_LINES = False |
| |
| _MISSING_PERMISSIONS_TEMPLATE = 'sitewide/403-page.ezt' |
| |
| def __init__(self, services=None, content_type='text/html; charset=UTF-8'): |
| """Load and parse the template, saving it for later use.""" |
| if self._PAGE_TEMPLATE: # specified in subclasses |
| template_path = self._TEMPLATE_PATH + self._PAGE_TEMPLATE |
| self.template = template_helpers.GetTemplate( |
| template_path, eliminate_blank_lines=self._ELIMINATE_BLANK_LINES) |
| else: |
| self.template = None |
| |
| self._missing_permissions_template = template_helpers.MonorailTemplate( |
| self._TEMPLATE_PATH + self._MISSING_PERMISSIONS_TEMPLATE) |
| self.services = services or flask.current_app.config['services'] |
| self.content_type = content_type |
| self.mr = None |
| # TODO: convert it to use self.request.path when we merge all flask together |
| self.request = flask.request |
| self.request_path = None |
| self.response = None |
| self.ratelimiter = ratelimiter.RateLimiter() |
| |
| # pylint: disable=unused-argument |
| def handler(self, **kwargs): |
| """Do common stuff then dispatch the request to get() or put() methods.""" |
| self.response = flask.make_response() |
| handler_start_time = time.time() |
| logging.info('\n\n\n Flask Request handler: %r', self) |
| |
| #TODO: add the ts_mon.NonCumulativeDistributionMetric |
| # count0, count1, count2 = gc.get_count() |
| # logging.info('gc counts: %d %d %d', count0, count1, count2) |
| # GC_COUNT.add(count0, {'generation': 0}) |
| # GC_COUNT.add(count1, {'generation': 1}) |
| # GC_COUNT.add(count2, {'generation': 2}) |
| |
| self.mr = monorailrequest.MonorailRequest(self.services) |
| # TODO: convert it to use self.request.path when we merge all flask together |
| self.request_path = self.request.base_url[len(self.request.host_url) - 1:] |
| self.response.headers.add( |
| 'Strict-Transport-Security', 'max-age=31536000; includeSubDomains') |
| |
| if 'X-Cloud-Trace-Context' in self.request.headers: |
| self.mr.profiler.trace_context = ( |
| self.request.headers.get('X-Cloud-Trace-Context')) |
| |
| if self.services.cache_manager: |
| try: |
| with self.mr.profiler.Phase('distributed invalidation'): |
| self.services.cache_manager.DoDistributedInvalidation(self.mr.cnxn) |
| |
| except MySQLdb.OperationalError as e: |
| logging.exception(e) |
| page_data = { |
| 'http_response_code': http_client.SERVICE_UNAVAILABLE, |
| 'requested_url': self.request.url, |
| } |
| self.template = template_helpers.GetTemplate( |
| 'templates/framework/database-maintenance.ezt', |
| eliminate_blank_lines=self._ELIMINATE_BLANK_LINES) |
| self.template.WriteResponse( |
| self.response, page_data, content_type='text/html') |
| return self.response |
| |
| try: |
| self.ratelimiter.CheckStart(self.request) |
| |
| with self.mr.profiler.Phase('parsing request and doing lookups'): |
| self.mr.ParseRequest(self.request, self.services) |
| |
| self.response.headers['X-Frame-Options'] = 'SAMEORIGIN' |
| |
| if self.request.method == 'POST': |
| self.post() |
| elif self.request.method == 'GET': |
| self.get() |
| |
| except exceptions.RedirectException as e: |
| return self.redirect(str(e)) |
| except exceptions.NoSuchUserException as e: |
| logging.info('Trapped NoSuchUserException %s', e) |
| flask.abort(404, 'user not found') |
| |
| except exceptions.NoSuchGroupException as e: |
| logging.warning('Trapped NoSuchGroupException %s', e) |
| flask.abort(404, 'user group not found') |
| |
| except exceptions.InputException as e: |
| logging.info('Rejecting invalid input: %r', e) |
| self.response.status_code = http_client.BAD_REQUEST |
| |
| except exceptions.NoSuchProjectException as e: |
| logging.info('Rejecting invalid request: %r', e) |
| self.response.status_code = http_client.NOT_FOUND |
| |
| except xsrf.TokenIncorrect as e: |
| logging.info('Bad XSRF token: %r', str(e)) |
| self.response.status_code = http_client.BAD_REQUEST |
| |
| except permissions.BannedUserException as e: |
| logging.warning('The user has been banned') |
| url = framework_helpers.FormatAbsoluteURL( |
| self.mr, urls.BANNED, include_project=False, copy_params=False) |
| self.redirect(url, abort=True) |
| |
| except ratelimiter.RateLimitExceeded as e: |
| logging.info('RateLimitExceeded Exception %s', e) |
| self.response.status_code = http_client.BAD_REQUEST |
| self.response.set_data('Slow your roll.') |
| |
| finally: |
| self.mr.CleanUp() |
| self.ratelimiter.CheckEnd(self.request, time.time(), handler_start_time) |
| |
| total_processing_time = time.time() - handler_start_time |
| logging.info( |
| 'Processed request in %d ms', int(total_processing_time * 1000)) |
| |
| end_count0, end_count1, end_count2 = gc.get_count() |
| logging.info('gc counts: %d %d %d', end_count0, end_count1, end_count2) |
| # TODO: get the GC event back |
| # if (end_count0 < count0) or (end_count1 < count1) or(end_count2 < count2): |
| # GC_EVENT_REQUEST.increment() |
| |
| if settings.enable_profiler_logging: |
| self.mr.profiler.LogStats() |
| |
| return self.response |
| |
| def get(self): |
| """Collect page-specific and generic info, then render the page.""" |
| page_data = {} |
| nonce = framework_helpers.MakeRandomKey(length=NONCE_LENGTH) |
| try: |
| csp_header = 'Content-Security-Policy' |
| csp_scheme = 'https:' |
| if settings.local_mode: |
| csp_header = 'Content-Security-Policy-Report-Only' |
| csp_scheme = 'http:' |
| user_agent_str = self.mr.request.headers.get('User-Agent', '') |
| ua = httpagentparser.detect(user_agent_str) |
| browser, browser_major_version = 'Unknown browser', 0 |
| if 'browser' in ua: |
| browser = ua['browser']['name'] |
| try: |
| browser_major_version = int(ua['browser']['version'].split('.')[0]) |
| except ValueError: |
| logging.warning( |
| 'Could not parse version: %r', ua['browser']['version']) |
| except KeyError: |
| logging.warning('No browser version defined in user agent.') |
| csp_supports_report_sample = ( |
| (browser == 'Chrome' and browser_major_version >= 59) or |
| (browser == 'Opera' and browser_major_version >= 46)) |
| version_base = servlet_helpers.VersionBaseURL(self.mr.request) |
| self.response.headers.add( |
| csp_header, |
| ( |
| "default-src %(scheme)s ; " |
| "script-src" |
| " %(rep_samp)s" # Report 40 chars of any inline violation. |
| " 'unsafe-inline'" # Only counts in browsers that lack CSP2. |
| " 'strict-dynamic'" # Allows <script nonce> to load more. |
| " %(version_base)s/static/dist/" |
| " 'self' 'nonce-%(nonce)s'; " |
| "child-src 'none'; " |
| "frame-src accounts.google.com" # All used by gapi.js auth. |
| " content-issuetracker.corp.googleapis.com" |
| " login.corp.google.com up.corp.googleapis.com" |
| # Used by Google Feedback |
| " feedback.googleusercontent.com" |
| " www.google.com; " |
| "img-src %(scheme)s data: blob: ; " |
| "style-src %(scheme)s 'unsafe-inline'; " |
| "object-src 'none'; " |
| "base-uri 'self'; " # Used by Google Feedback |
| "report-uri /csp.do" % { |
| 'nonce': |
| nonce, |
| 'scheme': |
| csp_scheme, |
| 'rep_samp': |
| "'report-sample'" if csp_supports_report_sample else '', |
| 'version_base': |
| version_base, |
| })) |
| |
| # add the function to get data and render page |
| page_data.update(self._GatherFlagData(self.mr)) |
| |
| # Page-specific work happens in this call. |
| page_data.update(self._DoPageProcessing(self.mr, nonce)) |
| |
| self._AddHelpDebugPageData(page_data) |
| |
| with self.mr.profiler.Phase('rendering template'): |
| self._RenderResponse(page_data) |
| |
| except (servlet_helpers.MethodNotSupportedError, NotImplementedError) as e: |
| # Instead of these pages throwing 500s display the 404 message and log. |
| # The motivation of this is to minimize 500s on the site to keep alerts |
| # meaningful during fuzzing. For more context see |
| # https://bugs.chromium.org/p/monorail/issues/detail?id=659 |
| logging.warning('Trapped NotImplementedError %s', e) |
| flask.abort(404, 'invalid page') |
| except query2ast.InvalidQueryError as e: |
| logging.warning('Trapped InvalidQueryError: %s', e) |
| logging.exception(e) |
| msg = str(e) if str(e) else 'invalid query' |
| flask.abort(400, msg) |
| except permissions.PermissionException as e: |
| logging.warning('Trapped PermissionException %s', e) |
| logging.warning('mr.auth.user_id is %s', self.mr.auth.user_id) |
| logging.warning('mr.auth.effective_ids is %s', self.mr.auth.effective_ids) |
| logging.warning('mr.perms is %s', self.mr.perms) |
| if not self.mr.auth.user_id: |
| # If not logged in, let them log in |
| login_url = servlet_helpers.SafeCreateLoginURL(self.mr) |
| raise exceptions.RedirectException(login_url) |
| else: |
| # Display the missing permissions template. |
| page_data = { |
| 'reason': str(e), |
| 'http_response_code': http_client.FORBIDDEN, |
| } |
| with self.mr.profiler.Phase('gather base data'): |
| page_data.update(self.GatherBaseData(self.mr, nonce)) |
| self._AddHelpDebugPageData(page_data) |
| self._missing_permissions_template.WriteResponse( |
| self.response, page_data, content_type=self.content_type) |
| |
| def post(self): |
| logging.info('process post request') |
| try: |
| # Page-specific work happens in this call. |
| self._DoFormProcessing(self.request, self.mr) |
| |
| except permissions.PermissionException as e: |
| logging.warning('Trapped permission-related exception "%s".', e) |
| self.response.status_code = http_client.BAD_REQUEST |
| |
| def _RenderResponse(self, page_data): |
| logging.info('rendering response len(page_data) is %r', len(page_data)) |
| self.template.WriteResponse( |
| self.response, page_data, content_type=self.content_type) |
| |
| def _GatherFlagData(self, mr): |
| page_data = { |
| 'project_stars_enabled': |
| ezt.boolean(settings.enable_project_stars), |
| 'user_stars_enabled': |
| ezt.boolean(settings.enable_user_stars), |
| 'can_create_project': |
| ezt.boolean(permissions.CanCreateProject(mr.perms)), |
| 'can_create_group': |
| ezt.boolean(permissions.CanCreateGroup(mr.perms)), |
| } |
| |
| return page_data |
| |
| def _DoCommonRequestProcessing(self, request, mr): |
| """Do common processing dependent on having the user and project pbs.""" |
| with mr.profiler.Phase('basic processing'): |
| self._CheckForMovedProject(mr, request) |
| self.AssertBasePermission(mr) |
| |
| # pylint: disable=unused-argument |
| def _DoPageProcessing(self, mr, nonce): |
| """Do user lookups and gather page-specific ezt data.""" |
| with mr.profiler.Phase('common request data'): |
| |
| self._DoCommonRequestProcessing(self.request, mr) |
| |
| self._MaybeRedirectToBrandedDomain(self.request, mr.project_name) |
| |
| page_data = self.GatherBaseData(mr, nonce) |
| |
| with mr.profiler.Phase('page processing'): |
| page_data.update(self.GatherPageData(mr)) |
| page_data.update(mr.form_overrides) |
| template_helpers.ExpandLabels(page_data) |
| self._RecordVisitTime(mr) |
| |
| return page_data |
| |
| def _DoFormProcessing(self, request, mr): |
| """Do user lookups and handle form data.""" |
| self._DoCommonRequestProcessing(request, mr) |
| |
| if self.CHECK_SECURITY_TOKEN: |
| try: |
| xsrf.ValidateToken( |
| request.values.get('token'), mr.auth.user_id, self.request_path) |
| except xsrf.TokenIncorrect as err: |
| if self.ALLOW_XHR: |
| xsrf.ValidateToken( |
| request.values.get('token'), mr.auth.user_id, 'xhr') |
| else: |
| raise err |
| |
| form_values = datastructures.MultiDict(request.values) |
| form_values.update(request.files) |
| redirect_url = self.ProcessFormData(mr, form_values) |
| |
| # Most forms redirect the user to a new URL on success. If no |
| # redirect_url was returned, the form handler must have already |
| # sent a response. E.g., bounced the user back to the form with |
| # invalid form fields highlighted. |
| if redirect_url: |
| raise exceptions.RedirectException(redirect_url) |
| else: |
| assert self.response.response |
| |
| def ProcessFormData(self, mr, post_data): |
| """Handle form data and redirect appropriately. |
| |
| Args: |
| mr: commonly used info parsed from the request. |
| post_data: HTML form data from the request. |
| |
| Returns: |
| String URL to redirect the user to, or None if response was already sent. |
| """ |
| raise servlet_helpers.MethodNotSupportedError() |
| |
| def _FormHandlerURL(self, path): |
| """Return the form handler for the main form on a page.""" |
| if path.endswith('/'): |
| return path + 'edit.do' |
| elif path.endswith('.do'): |
| return path # This happens as part of PleaseCorrect(). |
| else: |
| return path + '.do' |
| |
| # pylint: disable=unused-argument |
| def GatherPageData(self, mr): |
| """Return a dict of page-specific ezt data.""" |
| raise servlet_helpers.MethodNotSupportedError() |
| |
| def GatherBaseData(self, mr, nonce): |
| """Return a dict of info used on almost all pages.""" |
| project = mr.project |
| |
| project_summary = '' |
| project_alert = None |
| project_read_only = False |
| project_home_page = '' |
| project_thumbnail_url = '' |
| if project: |
| project_summary = project.summary |
| project_alert = servlet_helpers.CalcProjectAlert(project) |
| project_read_only = project.read_only_reason |
| project_home_page = project.home_page |
| project_thumbnail_url = tracker_views.LogoView(project).thumbnail_url |
| |
| with work_env.WorkEnv(mr, self.services) as we: |
| is_project_starred = False |
| project_view = None |
| if mr.project: |
| if permissions.UserCanViewProject(mr.auth.user_pb, |
| mr.auth.effective_ids, mr.project): |
| is_project_starred = we.IsProjectStarred(mr.project_id) |
| project_view = template_helpers.PBProxy(mr.project) |
| |
| grid_x_attr = None |
| grid_y_attr = None |
| hotlist_view = None |
| if mr.hotlist: |
| users_by_id = framework_views.MakeAllUserViews( |
| mr.cnxn, self.services.user, |
| features_bizobj.UsersInvolvedInHotlists([mr.hotlist])) |
| hotlist_view = hotlist_views.HotlistView( |
| mr.hotlist, mr.perms, mr.auth, mr.viewed_user_auth.user_id, |
| users_by_id, |
| self.services.hotlist_star.IsItemStarredBy( |
| mr.cnxn, mr.hotlist.hotlist_id, mr.auth.user_id)) |
| grid_x_attr = mr.x.lower() |
| grid_y_attr = mr.y.lower() |
| |
| app_version = os.environ.get('CURRENT_VERSION_ID') |
| |
| viewed_username = None |
| if mr.viewed_user_auth.user_view: |
| viewed_username = mr.viewed_user_auth.user_view.username |
| |
| config = None |
| if mr.project_id and self.services.config: |
| with mr.profiler.Phase('getting config'): |
| config = self.services.config.GetProjectConfig(mr.cnxn, mr.project_id) |
| grid_x_attr = (mr.x or config.default_x_attr).lower() |
| grid_y_attr = (mr.y or config.default_y_attr).lower() |
| |
| viewing_self = mr.auth.user_id == mr.viewed_user_auth.user_id |
| offer_saved_queries_subtab = ( |
| viewing_self or mr.auth.user_pb and mr.auth.user_pb.is_site_admin) |
| |
| login_url = servlet_helpers.SafeCreateLoginURL(mr) |
| logout_url = servlet_helpers.SafeCreateLogoutURL(mr) |
| logout_url_goto_home = users.create_logout_url('/') |
| version_base = servlet_helpers.VersionBaseURL(mr.request) |
| |
| base_data = { |
| # EZT does not have constants for True and False, so we pass them in. |
| 'True': |
| ezt.boolean(True), |
| 'False': |
| ezt.boolean(False), |
| 'local_mode': |
| ezt.boolean(settings.local_mode), |
| 'site_name': |
| settings.site_name, |
| 'show_search_metadata': |
| ezt.boolean(False), |
| 'page_template': |
| self._PAGE_TEMPLATE, |
| 'main_tab_mode': |
| self._MAIN_TAB_MODE, |
| 'project_summary': |
| project_summary, |
| 'project_home_page': |
| project_home_page, |
| 'project_thumbnail_url': |
| project_thumbnail_url, |
| 'hotlist_id': |
| mr.hotlist_id, |
| 'hotlist': |
| hotlist_view, |
| 'hostport': |
| mr.request.host, |
| 'absolute_base_url': |
| '%s://%s' % (mr.request.scheme, mr.request.host), |
| 'project_home_url': |
| None, |
| 'link_rel_canonical': |
| None, # For specifying <link rel="canonical"> |
| 'projectname': |
| mr.project_name, |
| 'project': |
| project_view, |
| 'project_is_restricted': |
| ezt.boolean(servlet_helpers.ProjectIsRestricted(mr)), |
| 'offer_contributor_list': |
| ezt.boolean(permissions.CanViewContributorList(mr, mr.project)), |
| 'logged_in_user': |
| mr.auth.user_view, |
| 'form_token': |
| None, # Set to a value below iff the user is logged in. |
| 'form_token_path': |
| None, |
| 'token_expires_sec': |
| None, |
| 'xhr_token': |
| None, # Set to a value below iff the user is logged in. |
| 'flag_spam_token': |
| None, |
| 'nonce': |
| nonce, |
| 'perms': |
| mr.perms, |
| 'warnings': |
| mr.warnings, |
| 'errors': |
| mr.errors, |
| 'viewed_username': |
| viewed_username, |
| 'viewed_user': |
| mr.viewed_user_auth.user_view, |
| 'viewed_user_pb': |
| template_helpers.PBProxy(mr.viewed_user_auth.user_pb), |
| 'viewing_self': |
| ezt.boolean(viewing_self), |
| 'viewed_user_id': |
| mr.viewed_user_auth.user_id, |
| 'offer_saved_queries_subtab': |
| ezt.boolean(offer_saved_queries_subtab), |
| 'currentPageURL': |
| mr.current_page_url, |
| 'currentPageURLEncoded': |
| mr.current_page_url_encoded, |
| 'login_url': |
| login_url, |
| 'logout_url': |
| logout_url, |
| 'logout_url_goto_home': |
| logout_url_goto_home, |
| 'continue_issue_id': |
| mr.continue_issue_id, |
| 'feedback_email': |
| settings.feedback_email, |
| 'category_css': |
| None, # Used to specify a category of stylesheet |
| 'category2_css': |
| None, # specify a 2nd category of stylesheet if needed. |
| 'page_css': |
| None, # Used to add a stylesheet to a specific page. |
| 'can': |
| mr.can, |
| 'query': |
| mr.query, |
| 'colspec': |
| None, |
| 'sortspec': |
| mr.sort_spec, |
| |
| # Options for issuelist display |
| 'grid_x_attr': |
| grid_x_attr, |
| 'grid_y_attr': |
| grid_y_attr, |
| 'grid_cell_mode': |
| mr.cells, |
| 'grid_mode': |
| None, |
| 'list_mode': |
| None, |
| 'chart_mode': |
| None, |
| 'is_cross_project': |
| ezt.boolean(False), |
| |
| # for project search (some also used in issue search) |
| 'start': |
| mr.start, |
| 'num': |
| mr.num, |
| 'groupby': |
| mr.group_by_spec, |
| 'q_field_size': |
| ( |
| min( |
| framework_constants.MAX_ARTIFACT_SEARCH_FIELD_SIZE, |
| max( |
| framework_constants.MIN_ARTIFACT_SEARCH_FIELD_SIZE, |
| len(mr.query) + framework_constants.AUTOSIZE_STEP))), |
| 'mode': |
| None, # Display mode, e.g., grid mode. |
| 'ajah': |
| mr.ajah, |
| 'table_title': |
| mr.table_title, |
| 'alerts': |
| alerts.AlertsView(mr), # For alert.ezt |
| 'project_alert': |
| project_alert, |
| 'title': |
| None, # First part of page title |
| 'title_summary': |
| None, # Appended to title on artifact detail pages |
| 'project_read_only': |
| ezt.boolean(project_read_only), |
| 'site_read_only': |
| ezt.boolean(settings.read_only), |
| 'banner_time': |
| servlet_helpers.GetBannerTime(settings.banner_time), |
| 'read_only': |
| ezt.boolean(settings.read_only or project_read_only), |
| 'site_banner_message': |
| settings.banner_message, |
| 'robots_no_index': |
| None, |
| 'analytics_id': |
| settings.analytics_id, |
| 'is_project_starred': |
| ezt.boolean(is_project_starred), |
| 'version_base': |
| version_base, |
| 'app_version': |
| app_version, |
| 'gapi_client_id': |
| settings.gapi_client_id, |
| 'viewing_user_page': |
| ezt.boolean(False), |
| 'old_ui_url': |
| None, |
| 'new_ui_url': |
| None, |
| 'is_member': |
| ezt.boolean(False), |
| } |
| |
| if mr.project: |
| base_data['project_home_url'] = '/p/%s' % mr.project_name |
| |
| # Always add xhr-xsrf token because even anon users need some |
| # pRPC methods, e.g., autocomplete, flipper, and charts. |
| base_data['token_expires_sec'] = xsrf.TokenExpiresSec() |
| base_data['xhr_token'] = xsrf.GenerateToken( |
| mr.auth.user_id, xsrf.XHR_SERVLET_PATH) |
| # Always add other anti-xsrf tokens when the user is logged in. |
| if mr.auth.user_id: |
| form_token_path = self._FormHandlerURL(mr.request_path) |
| base_data['form_token'] = xsrf.GenerateToken( |
| mr.auth.user_id, form_token_path) |
| base_data['form_token_path'] = form_token_path |
| |
| return base_data |
| |
| def _AddHelpDebugPageData(self, page_data): |
| with self.mr.profiler.Phase('help and debug data'): |
| page_data.update(self.GatherHelpData(self.mr, page_data)) |
| page_data.update(self.GatherDebugData(self.mr, page_data)) |
| |
| # pylint: disable=unused-argument |
| def GatherHelpData(self, mr, page_data): |
| """Return a dict of values to drive on-page user help. |
| Subclasses can override this function |
| Args: |
| mr: common information parsed from the HTTP request. |
| page_data: Dictionary of base and page template data. |
| |
| Returns: |
| A dict of values to drive on-page user help, to be added to page_data. |
| """ |
| help_data = { |
| 'cue': None, # for cues.ezt |
| 'account_cue': None, # for cues.ezt |
| } |
| dismissed = [] |
| if mr.auth.user_pb: |
| with work_env.WorkEnv(mr, self.services) as we: |
| userprefs = we.GetUserPrefs(mr.auth.user_id) |
| dismissed = [pv.name for pv in userprefs.prefs if pv.value == 'true'] |
| if (mr.auth.user_pb.vacation_message and |
| 'you_are_on_vacation' not in dismissed): |
| help_data['cue'] = 'you_are_on_vacation' |
| if (mr.auth.user_pb.email_bounce_timestamp and |
| 'your_email_bounced' not in dismissed): |
| help_data['cue'] = 'your_email_bounced' |
| if mr.auth.user_pb.linked_parent_id: |
| # This one is not dismissable. |
| help_data['account_cue'] = 'switch_to_parent_account' |
| parent_email = self.services.user.LookupUserEmail( |
| mr.cnxn, mr.auth.user_pb.linked_parent_id) |
| help_data['parent_email'] = parent_email |
| |
| return help_data |
| |
| def GatherDebugData(self, mr, page_data): |
| """Return debugging info for display at the very bottom of the page.""" |
| if mr.debug_enabled: |
| debug = [servlet_helpers.ContextDebugCollection('Page data', page_data)] |
| debug = [('none', 'recorded')] |
| return { |
| 'dbg': 'on', |
| 'debug': debug, |
| 'profiler': mr.profiler, |
| } |
| else: |
| if '?' in mr.current_page_url: |
| debug_url = mr.current_page_url + '&debug=1' |
| else: |
| debug_url = mr.current_page_url + '?debug=1' |
| |
| return { |
| 'debug_uri': debug_url, |
| 'dbg': 'off', |
| 'debug': [('none', 'recorded')], |
| } |
| |
| def _CheckForMovedProject(self, mr, request): |
| """If the project moved, redirect there or to an informational page.""" |
| if not mr.project: |
| return # We are on a site-wide or user page. |
| if not mr.project.moved_to: |
| return # This project has not moved. |
| admin_url = '/p/%s%s' % (mr.project_name, urls.ADMIN_META) |
| if self.request_path.startswith(admin_url): |
| return # It moved, but we are near the page that can un-move it. |
| |
| logging.info( |
| 'project %s has moved: %s', mr.project.project_name, |
| mr.project.moved_to) |
| |
| moved_to = mr.project.moved_to |
| if project_constants.RE_PROJECT_NAME.match(moved_to): |
| # Use the redir query parameter to avoid redirect loops. |
| if mr.redir is None: |
| url = framework_helpers.FormatMovedProjectURL(mr, moved_to) |
| if '?' in url: |
| url += '&redir=1' |
| else: |
| url += '?redir=1' |
| logging.info('trusted move to a new project on our site') |
| self.redirect(url, abort=True) |
| |
| logging.info('not a trusted move, will display link to user to click') |
| # Attach the project name as a url param instead of generating a /p/ |
| # link to the destination project. |
| url = framework_helpers.FormatAbsoluteURL( |
| mr, |
| urls.PROJECT_MOVED, |
| include_project=False, |
| copy_params=False, |
| project=mr.project_name) |
| self.redirect(url, abort=True) |
| |
| def _MaybeRedirectToBrandedDomain(self, request, project_name): |
| """If we are live and the project should be branded, check request host.""" |
| if request.values.get('redir'): |
| return # Avoid any chance of a redirect loop. |
| if not project_name: |
| return |
| needed_domain = framework_helpers.GetNeededDomain( |
| project_name, request.host) |
| if not needed_domain: |
| return |
| |
| url = 'https://%s%s' % (needed_domain, request.full_path) |
| if '?' in url: |
| url += '&redir=1' |
| else: |
| url += '?redir=1' |
| logging.info('branding redirect to url %r', url) |
| self.redirect(url, abort=True) |
| |
| def AssertBasePermission(self, mr): |
| """Make sure that the logged in user has permission to view this page. |
| |
| Subclasses should call super, then check additional permissions |
| and raise a PermissionException if the user is not authorized to |
| do something. |
| |
| Args: |
| mr: commonly used info parsed from the request. |
| |
| Raises: |
| PermissionException: If the user does not have permisssion to view |
| the current page. |
| """ |
| servlet_helpers.AssertBasePermission(mr) |
| |
| def CheckPerm(self, mr, perm, art=None, granted_perms=None): |
| """Return True if the user can use the requested permission.""" |
| return servlet_helpers.CheckPerm( |
| mr, perm, art=art, granted_perms=granted_perms) |
| |
| def MakePagePerms(self, mr, art, *perm_list, **kwargs): |
| """Make an EZTItem with a set of permissions needed in a given template. |
| |
| Args: |
| mr: commonly used info parsed from the request. |
| art: a project artifact, such as an issue. |
| *perm_list: any number of permission names that are referenced |
| in the EZT template. |
| **kwargs: dictionary that may include 'granted_perms' list of permissions |
| granted to the current user specifically on the current page. |
| |
| Returns: |
| An EZTItem with one attribute for each permission and the value |
| of each attribute being an ezt.boolean(). True if the user |
| is permitted to do that action on the given artifact, or |
| False if not. |
| """ |
| granted_perms = kwargs.get('granted_perms') |
| page_perms = template_helpers.EZTItem() |
| for perm in perm_list: |
| setattr( |
| page_perms, perm, |
| ezt.boolean( |
| self.CheckPerm(mr, perm, art=art, granted_perms=granted_perms))) |
| |
| return page_perms |
| |
| def redirect(self, url, abort=False): |
| if abort: |
| return flask.redirect(url, code=302) |
| else: |
| return flask.redirect(url) |
| |
| def PleaseCorrect(self, mr, **echo_data): |
| """Show the same form again so that the user can correct their input.""" |
| mr.PrepareForReentry(echo_data) |
| self.get() |
| |
| def _RecordVisitTime(self, mr, now=None): |
| """Record the signed in user's last visit time, if possible.""" |
| now = now or int(time.time()) |
| if not settings.read_only and mr.auth.user_id: |
| user_pb = mr.auth.user_pb |
| if (user_pb.last_visit_timestamp < |
| now - framework_constants.VISIT_RESOLUTION): |
| user_pb.last_visit_timestamp = now |
| self.services.user.UpdateUser(mr.cnxn, user_pb.user_id, user_pb) |
| |
| def abort(self, code, context=""): |
| return flask.abort(code, context) |