components/user_manager/user.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef COMPONENTS_USER_MANAGER_USER_H_
   6 #define COMPONENTS_USER_MANAGER_USER_H_
   7
   8 #include <string>
   9 #include <vector>
  10
  11 #include "base/basictypes.h"
  12 #include "base/strings/string16.h"
  13 #include "components/user_manager/user_id.h"
  14 #include "components/user_manager/user_image/user_image.h"
  15 #include "components/user_manager/user_info.h"
  16 #include "components/user_manager/user_manager_export.h"
  17 #include "components/user_manager/user_type.h"
  18 #include "third_party/skia/include/core/SkBitmap.h"
  19 #include "ui/gfx/image/image_skia.h"
  20
  21 namespace chromeos {
  22 class ChromeUserManagerImpl;
  23 class FakeChromeUserManager;
  24 class MockUserManager;
  25 class SupervisedUserManagerImpl;
  26 class UserAddingScreenTest;
  27 class UserImageManagerImpl;
  28 class UserSessionManager;
  29 }
  30
  31 namespace user_manager {
  32
  33 class UserManagerBase;
  34 class FakeUserManager;
  35
  36 // A class representing information about a previously logged in user.
  37 // Each user has a canonical email (username), returned by |email()| and
  38 // may have a different displayed email (in the raw form as entered by user),
  39 // returned by |displayed_email()|.
  40 // Displayed emails are for use in UI only, anywhere else users must be referred
  41 // to by |email()|.
  42 class USER_MANAGER_EXPORT User : public UserInfo {
  43  public:
  44   // User OAuth token status according to the last check.
  45   // Please note that enum values 1 and 2 were used for OAuth1 status and are
  46   // deprecated now.
  47   typedef enum {
  48     OAUTH_TOKEN_STATUS_UNKNOWN = 0,
  49     OAUTH2_TOKEN_STATUS_INVALID = 3,
  50     OAUTH2_TOKEN_STATUS_VALID = 4,
  51   } OAuthTokenStatus;
  52
  53   // These special values are used instead of actual default image indices.
  54   typedef enum {
  55     USER_IMAGE_INVALID = -3,
  56
  57     // Returned as |image_index| when user profile image is used as user image.
  58     USER_IMAGE_PROFILE = -2,
  59
  60     // Returned as |image_index| when user-selected file or photo is used as
  61     // user image.
  62     USER_IMAGE_EXTERNAL = -1,
  63   } UserImageType;
  64
  65   // This enum is used to define the buckets for an enumerated UMA histogram.
  66   // Hence,
  67   //   (a) existing enumerated constants should never be deleted or reordered,
  68   //   (b) new constants should only be appended at the end of the enumeration.
  69   enum WallpaperType {
  70     /* DAILY = 0 */    // Removed.
  71     CUSTOMIZED = 1,    // Selected by user.
  72     DEFAULT = 2,       // Default.
  73     /* UNKNOWN = 3 */  // Removed.
  74     ONLINE = 4,        // WallpaperInfo.location denotes an URL.
  75     POLICY = 5,        // Controlled by policy, can't be changed by the user.
  76     WALLPAPER_TYPE_COUNT = 6
  77   };
  78
  79   // Returns true if user type has gaia account.
  80   static bool TypeHasGaiaAccount(UserType user_type);
  81
  82   // Returns the user type.
  83   virtual UserType GetType() const = 0;
  84
  85   // The email the user used to log in.
  86   const std::string& email() const { return email_; }
  87
  88   // The displayed user name.
  89   base::string16 display_name() const { return display_name_; }
  90
  91   // If the user has to use SAML to log in.
  92   bool using_saml() const { return using_saml_; }
  93
  94   // UserInfo
  95   std::string GetEmail() const override;
  96   base::string16 GetDisplayName() const override;
  97   base::string16 GetGivenName() const override;
  98   const gfx::ImageSkia& GetImage() const override;
  99   UserID GetUserID() const override;
 100
 101   // Allows managing child status of the user. Used for RegularUser.
 102   virtual void SetIsChild(bool is_child);
 103
 104   // Returns true if user has gaia account. True for users of types
 105   // USER_TYPE_REGULAR and USER_TYPE_CHILD.
 106   virtual bool HasGaiaAccount() const;
 107
 108   // Returns true if user is supervised.
 109   virtual bool IsSupervised() const;
 110
 111   // Returns the account name part of the email. Use the display form of the
 112   // email if available and use_display_name == true. Otherwise use canonical.
 113   std::string GetAccountName(bool use_display_email) const;
 114
 115   // Whether the user has a default image.
 116   bool HasDefaultImage() const;
 117
 118   // True if user image can be synced.
 119   virtual bool CanSyncImage() const;
 120
 121   int image_index() const { return image_index_; }
 122   bool has_raw_image() const { return user_image_.has_raw_image(); }
 123   // Returns raw representation of static user image.
 124   const UserImage::RawImage& raw_image() const {
 125     return user_image_.raw_image();
 126   }
 127
 128   // Whether |raw_image| contains data in format that is considered safe to
 129   // decode in sensitive environment (on Login screen).
 130   bool image_is_safe_format() const { return user_image_.is_safe_format(); }
 131
 132   // Returns the URL of user image, if there is any. Currently only the profile
 133   // image has a URL, for other images empty URL is returned.
 134   GURL image_url() const { return user_image_.url(); }
 135
 136   // True if user image is a stub (while real image is being loaded from file).
 137   bool image_is_stub() const { return image_is_stub_; }
 138
 139   // True if image is being loaded from file.
 140   bool image_is_loading() const { return image_is_loading_; }
 141
 142   // The displayed (non-canonical) user email.
 143   virtual std::string display_email() const;
 144
 145   // OAuth token status for this user.
 146   OAuthTokenStatus oauth_token_status() const { return oauth_token_status_; }
 147
 148   // Whether online authentication against GAIA should be enforced during the
 149   // user's next sign-in.
 150   bool force_online_signin() const { return force_online_signin_; }
 151
 152   // True if the user's session can be locked (i.e. the user has a password with
 153   // which to unlock the session).
 154   bool can_lock() const;
 155
 156   // Returns empty string when home dir hasn't been mounted yet.
 157   std::string username_hash() const;
 158
 159   // True if current user is logged in.
 160   bool is_logged_in() const;
 161
 162   // True if current user is active within the current session.
 163   bool is_active() const;
 164
 165   // True if the user Profile is created.
 166   bool is_profile_created() const { return profile_is_created_; }
 167
 168  protected:
 169   friend class UserManagerBase;
 170   friend class chromeos::ChromeUserManagerImpl;
 171   friend class chromeos::SupervisedUserManagerImpl;
 172   friend class chromeos::UserImageManagerImpl;
 173   friend class chromeos::UserSessionManager;
 174
 175   // For testing:
 176   friend class FakeUserManager;
 177   friend class chromeos::FakeChromeUserManager;
 178   friend class chromeos::MockUserManager;
 179   friend class chromeos::UserAddingScreenTest;
 180
 181   // Do not allow anyone else to create new User instances.
 182   static User* CreateRegularUser(const UserID& email);
 183   static User* CreateGuestUser();
 184   static User* CreateKioskAppUser(const UserID& kiosk_app_username);
 185   static User* CreateSupervisedUser(const UserID& username);
 186   static User* CreatePublicAccountUser(const UserID& email);
 187
 188   explicit User(const std::string& email);
 189   ~User() override;
 190
 191   const std::string* GetAccountLocale() const { return account_locale_.get(); }
 192
 193   // Setters are private so only UserManager can call them.
 194   void SetAccountLocale(const std::string& resolved_account_locale);
 195
 196   void SetImage(const UserImage& user_image, int image_index);
 197
 198   void SetImageURL(const GURL& image_url);
 199
 200   // Sets a stub image until the next |SetImage| call. |image_index| may be
 201   // one of |USER_IMAGE_EXTERNAL| or |USER_IMAGE_PROFILE|.
 202   // If |is_loading| is |true|, that means user image is being loaded from file.
 203   void SetStubImage(const UserImage& stub_user_image,
 204                     int image_index,
 205                     bool is_loading);
 206
 207   void set_display_name(const base::string16& display_name) {
 208     display_name_ = display_name;
 209   }
 210
 211   void set_given_name(const base::string16& given_name) {
 212     given_name_ = given_name;
 213   }
 214
 215   void set_display_email(const std::string& display_email) {
 216     display_email_ = display_email;
 217   }
 218
 219   void set_using_saml(const bool using_saml) { using_saml_ = using_saml; }
 220
 221   const UserImage& user_image() const { return user_image_; }
 222
 223   void set_oauth_token_status(OAuthTokenStatus status) {
 224     oauth_token_status_ = status;
 225   }
 226
 227   void set_force_online_signin(bool force_online_signin) {
 228     force_online_signin_ = force_online_signin;
 229   }
 230
 231   void set_username_hash(const std::string& username_hash) {
 232     username_hash_ = username_hash;
 233   }
 234
 235   void set_is_logged_in(bool is_logged_in) { is_logged_in_ = is_logged_in; }
 236
 237   void set_can_lock(bool can_lock) { can_lock_ = can_lock; }
 238
 239   void set_is_active(bool is_active) { is_active_ = is_active; }
 240
 241   void set_profile_is_created() { profile_is_created_ = true; }
 242
 243   // True if user has google account (not a guest or managed user).
 244   bool has_gaia_account() const;
 245
 246  private:
 247   std::string email_;
 248   base::string16 display_name_;
 249   base::string16 given_name_;
 250   // The displayed user email, defaults to |email_|.
 251   std::string display_email_;
 252   bool using_saml_;
 253   UserImage user_image_;
 254   OAuthTokenStatus oauth_token_status_;
 255   bool force_online_signin_;
 256
 257   // This is set to chromeos locale if account data has been downloaded.
 258   // (Or failed to download, but at least one download attempt finished).
 259   // An empty string indicates error in data load, or in
 260   // translation of Account locale to chromeos locale.
 261   scoped_ptr<std::string> account_locale_;
 262
 263   // Used to identify homedir mount point.
 264   std::string username_hash_;
 265
 266   // Either index of a default image for the user, |USER_IMAGE_EXTERNAL| or
 267   // |USER_IMAGE_PROFILE|.
 268   int image_index_;
 269
 270   // True if current user image is a stub set by a |SetStubImage| call.
 271   bool image_is_stub_;
 272
 273   // True if current user image is being loaded from file.
 274   bool image_is_loading_;
 275
 276   // True if user is able to lock screen.
 277   bool can_lock_;
 278
 279   // True if user is currently logged in in current session.
 280   bool is_logged_in_;
 281
 282   // True if user is currently logged in and active in current session.
 283   bool is_active_;
 284
 285   // True if user Profile is created
 286   bool profile_is_created_;
 287
 288   DISALLOW_COPY_AND_ASSIGN(User);
 289 };
 290
 291 // List of known users.
 292 typedef std::vector<User*> UserList;
 293
 294 }  // namespace user_manager
 295
 296 #endif  // COMPONENTS_USER_MANAGER_USER_H_