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
|
// Copyright (c) 2010 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_CHROMEOS_CROS_CRYPTOHOME_LIBRARY_H_
#define CHROME_BROWSER_CHROMEOS_CROS_CRYPTOHOME_LIBRARY_H_
#pragma once
#include <string>
#include "base/singleton.h"
#include "chrome/browser/chromeos/cros/cros_library.h"
#include "cros/chromeos_cryptohome.h"
namespace chromeos {
// This interface defines the interaction with the ChromeOS cryptohome library
// APIs.
class CryptohomeLibrary {
public:
class Delegate {
public:
// This will be called back on the UI thread. Consult |return_code| for
// further information beyond mere success or failure.
virtual void OnComplete(bool success, int return_code) = 0;
};
virtual ~CryptohomeLibrary() {}
// Asks cryptohomed to try to find the cryptohome for |user_email| and then
// use |passhash| to unlock the key.
virtual bool CheckKey(const std::string& user_email,
const std::string& passhash) = 0;
// Asks cryptohomed to asynchronously try to find the cryptohome for
// |user_email| and then use |passhash| to unlock the key.
// Returns true if the attempt is successfully initiated.
// d->OnComplete() will be called with status info on completion.
virtual bool AsyncCheckKey(const std::string& user_email,
const std::string& passhash,
Delegate* callback) = 0;
// Asks cryptohomed to try to find the cryptohome for |user_email| and then
// change from using |old_hash| to lock the key to using |new_hash|.
virtual bool MigrateKey(const std::string& user_email,
const std::string& old_hash,
const std::string& new_hash) = 0;
// Asks cryptohomed to asynchronously try to find the cryptohome for
// |user_email| and then change from using |old_hash| to lock the
// key to using |new_hash|.
// Returns true if the attempt is successfully initiated.
// d->OnComplete() will be called with status info on completion.
virtual bool AsyncMigrateKey(const std::string& user_email,
const std::string& old_hash,
const std::string& new_hash,
Delegate* callback) = 0;
// Asks cryptohomed to try to find the cryptohome for |user_email| and then
// mount it using |passhash| to unlock the key.
virtual bool Mount(const std::string& user_email,
const std::string& passhash,
int* error_code) = 0;
// Asks cryptohomed to asynchronously try to find the cryptohome for
// |user_email| and then mount it using |passhash| to unlock the key.
// Returns true if the attempt is successfully initiated.
// d->OnComplete() will be called with status info on completion.
virtual bool AsyncMount(const std::string& user_email,
const std::string& passhash,
Delegate* callback) = 0;
// Asks cryptohomed to mount a tmpfs for BWSI mode.
virtual bool MountForBwsi(int* error_code) = 0;
// Asks cryptohomed to asynchronously to mount a tmpfs for BWSI mode.
// Returns true if the attempt is successfully initiated.
// d->OnComplete() will be called with status info on completion.
virtual bool AsyncMountForBwsi(Delegate* callback) = 0;
// Asks cryptohomed to try to find the cryptohome for |user_email| and then
// nuke it.
virtual bool Remove(const std::string& user_email) = 0;
// Asks cryptohomed to asynchronously try to find the cryptohome for
// |user_email| and then nuke it.
virtual bool AsyncRemove(const std::string& user_email,
Delegate* callback) = 0;
// Asks cryptohomed if a drive is currently mounted.
virtual bool IsMounted() = 0;
// Asks cryptohomed for the system salt.
virtual CryptohomeBlob GetSystemSalt() = 0;
// Factory function, creates a new instance and returns ownership.
// For normal usage, access the singleton via CrosLibrary::Get().
static CryptohomeLibrary* GetImpl(bool stub);
};
} // namespace chromeos
#endif // CHROME_BROWSER_CHROMEOS_CROS_CRYPTOHOME_LIBRARY_H_
|
