1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_ENTERPRISE_DATA_PROTECTION_PRINT_UTILS_H_
#define CHROME_BROWSER_ENTERPRISE_DATA_PROTECTION_PRINT_UTILS_H_
#include <optional>
#include "base/functional/callback_forward.h"
#include "base/memory/ref_counted_memory.h"
#include "base/memory/scoped_refptr.h"
#include "chrome/browser/enterprise/connectors/analysis/content_analysis_delegate.h"
namespace content {
class WebContents;
}
namespace enterprise_data_protection {
// Represents context for the kind of print workflow that needs to check if
// scanning should happen. This is to control the timing at which scanning
// occurs.
//
// +-------------------#3-----------------+
// | V
// +---------+ +--------+ +----------+ +-------+
// | Preview | --#2--> | System | ---------> | Print | --#4-> | Print |
// | dialog | | dialog | --+ | document | --#5-> | job |
// +---------+ +--------+ | +----------+ +-------+
// ^ |
// ------#0-----------------+ | +------------+
// | | Open in |
// +--#6--> | Preview |
// | (Mac only) |
// +------------+
enum class PrintScanningContext {
// Represents the moment the user presses ctrl-p/shift-ctrl-p or an equivalent
// action that would lead to a system print dialog showing, before any such
// dialog is shown.
kBeforeSystemDialog = 0,
// DEPRECATED
// Represents the moment the user presses ctrl-p or an equivalent action
// before any preview dialog is shown. This value is deprecated as policies no
// longer apply print checks at the timing it used to represent. Since this
// value was used in UMA, new code that hooks in a similar location should use
// a different value.
// kBeforePreview = 1,
// Represents the moment the user has clicked "Print using system dialog",
// before said dialog is shown and before the print job starts.
kSystemPrintAfterPreview = 2,
// Represents the moment the user has clicked "Print", before the print job
// starts.
kNormalPrintAfterPreview = 3,
// Represents the code paths after the user has picked all printing settings
// from either the print preview dialog or system dialog, right as the
// document is about to be printed with a real print job. Also indicates what
// kind of workflow was used to get those print settings.
kSystemPrintBeforePrintDocument = 4,
kNormalPrintBeforePrintDocument = 5,
#if BUILDFLAG(IS_MAC)
// Represents the code paths after the user has clicked "Open PDF in Preview"
// from the print preview dialog on Mac.
kOpenPdfInPreview = 6,
kMaxValue = kOpenPdfInPreview,
#else
kMaxValue = kNormalPrintBeforePrintDocument,
#endif // BUILDFLAG(IS_MAC)
};
// These functions take something to print (`print_data`) and scans it if the
// policy is enabled on a managed browser. It also passes on print metadata
// (e.g. `printer_name` or `scanning_data`) to content scans and `hides_preview`
// for the local ones. On receiving the verdict after the scan these functions
// calls `on_verdict` with true or false. In the non enterprise case where no
// scan is required, these functions directly calls `on_verdict` with true.
// These functions can return asynchronously.
void PrintIfAllowedByPolicy(scoped_refptr<base::RefCountedMemory> print_data,
content::WebContents* initiator,
std::string printer_name,
PrintScanningContext context,
base::OnceCallback<void(bool)> on_verdict,
base::OnceClosure hide_preview);
void PrintIfAllowedByPolicy(
scoped_refptr<base::RefCountedMemory> print_data,
content::WebContents* initiator,
enterprise_connectors::ContentAnalysisDelegate::Data scanning_data,
base::OnceCallback<void(bool)> on_verdict);
// Returns a `ContentAnalysisDelegate::Data` object with information about how
// content scanning should proceed, or nullopt if it shouldn't.
std::optional<enterprise_connectors::ContentAnalysisDelegate::Data>
GetPrintAnalysisData(content::WebContents* web_contents,
PrintScanningContext context);
} // namespace enterprise_data_protection
#endif // CHROME_BROWSER_ENTERPRISE_DATA_PROTECTION_PRINT_UTILS_H_
|
