Mixed Licenses Enrollment

chrome/browser/chromeos/login/enrollment/enterprise_enrollment_helper.h

 // Copyright 2014 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_LOGIN_ENROLLMENT_ENTERPRISE_ENROLLMENT_HELPER_H_
 #define CHROME_BROWSER_CHROMEOS_LOGIN_ENROLLMENT_ENTERPRISE_ENROLLMENT_HELPER_H_
 
 #include <memory>
 #include <string>
 
 #include "base/callback_forward.h"
 #include "base/macros.h"
 #include "chrome/browser/chromeos/policy/device_cloud_policy_initializer.h"
+#include "components/policy/core/common/cloud/cloud_policy_constants.h"
 
 class GoogleServiceAuthError;
 
 namespace policy {
 struct EnrollmentConfig;
 class EnrollmentStatus;
 }
 
 namespace chromeos {
 
+// Maps a license type to number of available licenses.
+using EnrollmentLicenseMap = std::map<policy::LicenseType, int>;

[emaxx, 2017/07/21 12:57:29]

nit: #include <map>

[Denis Kuznetsov (DE-MUC), 2017/07/25 21:51:05]

Done.

+
 class ActiveDirectoryJoinDelegate;
 
 // This class is capable to enroll the device into enterprise domain, using
 // either a profile containing authentication data or OAuth token.
 // It can also clear an authentication data from the profile and revoke tokens
 // that are not longer needed.
 class EnterpriseEnrollmentHelper {
  public:
   typedef policy::DeviceCloudPolicyInitializer::EnrollmentCallback
       EnrollmentCallback;
 
   // Enumeration of the possible errors that can occur during enrollment which
   // are not covered by GoogleServiceAuthError or EnrollmentStatus.
   enum OtherError {
     // Existing enrollment domain doesn't match authentication user.
     OTHER_ERROR_DOMAIN_MISMATCH,
     // Unexpected error condition, indicates a bug in the code.
     OTHER_ERROR_FATAL
   };
 
   class EnrollmentStatusConsumer {
    public:
     // Called when an error happens on attempt to receive authentication tokens.
     virtual void OnAuthError(const GoogleServiceAuthError& error) = 0;
 
+    // Called when there are multiple license types available for enrollment,
+    // and admin allowed customer to choose license type to assign.

[emaxx, 2017/07/21 12:57:29]

nit: s/customer/user/? (IIUC)

[Denis Kuznetsov (DE-MUC), 2017/07/25 21:51:05]

Done.

+    // Enrollment is paused, and will resume once UseLicenseType() is called.
+    virtual void OnMultipleLicensesAvailable(
+        const EnrollmentLicenseMap& licenses) = 0;
+
     // Called when an error happens during enrollment.
     virtual void OnEnrollmentError(policy::EnrollmentStatus status) = 0;
 
     // Called when some other error happens.
     virtual void OnOtherError(OtherError error) = 0;
 
     // Called when enrollment finishes successfully. |additional_token| keeps
     // the additional access token, if it was requested by setting the
     // |fetch_additional_token| param of EnrollUsingProfile() to true.
     // Otherwise, |additional_token| is empty.
@@ skipping 40 matching lines @@
   // Starts enterprise enrollment using |token|.
   // EnrollUsingToken can be called only once during this object's lifetime, and
   // only if none of the EnrollUsing* was called before.
   virtual void EnrollUsingToken(const std::string& token) = 0;
 
   // Starts enterprise enrollment using PCA attestation.
   // EnrollUsingAttestation can be called only once during the object's
   // lifetime, and only if none of the EnrollUsing* was called before.
   virtual void EnrollUsingAttestation() = 0;
 
+  // Continue enrollment using license |type|.
+  virtual void UseLicenseType(policy::LicenseType type) = 0;
+
   // Starts device attribute update process. First tries to get
   // permission to update device attributes for current user
   // using stored during enrollment oauth token.
   virtual void GetDeviceAttributeUpdatePermission() = 0;
 
   // Uploads device attributes on DM server. |asset_id| - Asset Identifier
   // and |location| - Assigned Location, these attributes were typed by
   // current user on the device attribute prompt screen after successful
   // enrollment.
   virtual void UpdateDeviceAttributes(const std::string& asset_id,
@@ skipping 20 matching lines @@
   // If this is not nullptr, then it will be used to create the enrollment
   // helper. |create_mock_enrollment_helper_| needs to outlive this class.
   static CreateMockEnrollmentHelper create_mock_enrollment_helper_;
 
   DISALLOW_COPY_AND_ASSIGN(EnterpriseEnrollmentHelper);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_CHROMEOS_LOGIN_ENROLLMENT_ENTERPRISE_ENROLLMENT_HELPER_H_