LicenseSpring C++ SDK
Easily add Software Licensing to your application
Loading...
Searching...
No Matches
LicenseManager.h
Go to the documentation of this file.
1#ifndef LS_LICENSE_MANAGER_H
2#define LS_LICENSE_MANAGER_H
3
4#ifdef _MSC_VER
5#pragma once
6#pragma warning(push)
7#pragma warning(disable : 4251)
8#endif
9
10#include "BaseManager.h"
11
12namespace LicenseSpring
13{
19{
20public:
21 using ptr_t = std::shared_ptr<LicenseManager>;
22
30 Configuration::ptr_t config, LicenseStorage::ptr_t storage = nullptr);
31
35
38 ~LicenseManager() override;
39
66 Customer::ptr_t user = nullptr, const std::string &licensePolicy = std::string());
67
85 LicenseID getTrialLicense(const std::string &userEmail);
86
103 std::string getSSOUrl(const std::string &accountCode = std::string(), bool useAuthCode = true);
104
110 const std::string &initializationCode, const std::string &licenseKey);
111
123 const License::ptr_t activateAirGapLicense(const std::string &confirmationCode,
124 const std::wstring &policyPath, const std::string &licenseKey, uint32_t policyId);
125
150 const License::ptr_t activateLicense(const LicenseID &licenseID);
151
177 const LicenseID &licenseID, const std::vector<DeviceVariable> &deviceVariables);
178
206 const License::ptr_t activateLicense(const std::string &authData,
207 const std::string &accountCode = std::string(), bool useAuthCode = true);
208
222 const std::wstring &activationResponseFile = std::wstring());
223
239 DeviceIDAlgorithm deviceIdAlgorithm, const std::string &userPassword = "");
240
256 const std::string &user, const std::string &password, const std::string &newPassword);
257
272 std::vector<std::string> getVersionList(
273 const LicenseID &licenseID, const InstallFileFilter &filter = InstallFileFilter());
274
293 const std::string &version = std::string(),
294 const InstallFileFilter &filter = InstallFileFilter());
295
303 const LicenseID &licenseID, const std::wstring &activationRequestFile = std::wstring());
304
313 std::wstring createOfflineActivationFile(const LicenseID &licenseID,
314 const std::vector<DeviceVariable> &deviceVariables,
315 const std::wstring &activationRequestFile = std::wstring());
316
325 bool isOnline(bool throwExceptions = false) const;
326
340 std::vector<LicenseUser::ptr_t> getLicenseUsers(const Customer &customer);
341
346 std::vector<LicenseUser::ptr_t> getLicenseUsers(const std::string &customerEmail);
347
354 std::vector<UserLicensesData::ptr_t> getUserLicenses(
355 const std::string &username, const std::string &password);
356};
357} // namespace LicenseSpring
358
359#ifdef _MSC_VER
360#pragma warning(pop)
361#endif
362
363#endif // LS_LICENSE_MANAGER_H
#define LS_API
Definition APIDef.h:23
DeviceIDAlgorithm
Type of Device ID algorithm used by the SDK.
Definition PODTypes.h:119
Base class for license management.
Definition BaseManager.h:25
std::shared_ptr< Configuration > ptr_t
Class that encapsulates information about a customer.
Definition Customer.h:18
std::shared_ptr< Customer > ptr_t
Definition Customer.h:20
std::shared_ptr< InstallationFile > ptr_t
std::shared_ptr< License > ptr_t
Definition License.h:37
Class that represents License identifier.
Definition LicenseID.h:21
Class for performing basic requests to LicenseSpring backend and managing licenses.
std::wstring createOfflineActivationFile(const LicenseID &licenseID, const std::vector< DeviceVariable > &deviceVariables, const std::wstring &activationRequestFile=std::wstring())
Creates offline activation file request.
std::shared_ptr< LicenseManager > ptr_t
std::string getSSOUrl(const std::string &accountCode=std::string(), bool useAuthCode=true)
Get URL for Single sign-on license activation.
std::string getAirGapActivationCode(const std::string &initializationCode, const std::string &licenseKey)
Get air gap Activation code.
std::vector< LicenseUser::ptr_t > getLicenseUsers(const std::string &customerEmail)
Overloaded method. See notes above. Get license users list by given customer email.
std::vector< UserLicensesData::ptr_t > getUserLicenses(const std::string &username, const std::string &password)
Retrieves all licenses for the provided username and password and the product this LicenseManager is ...
std::vector< std::string > getVersionList(const LicenseID &licenseID, const InstallFileFilter &filter=InstallFileFilter())
Get app version list available for given license.
const License::ptr_t activateLicenseOffline(const std::wstring &activationResponseFile=std::wstring())
Activate license offline with provided activation file.
bool isOnline(bool throwExceptions=false) const
Helper method, it checks connection to the LicenseSpring backend.
static LicenseManager::ptr_t create(Configuration::ptr_t config, LicenseStorage::ptr_t storage=nullptr)
Creates LicenseManager object and initialize it with given configuration.
const License::ptr_t relinkLicense(DeviceIDAlgorithm deviceIdAlgorithm, const std::string &userPassword="")
This method helps upgrade to new device id algorithm. It deactivates current license with old device ...
LicenseManager(Configuration::ptr_t config, LicenseStorage::ptr_t storage=nullptr)
Construct LicenseManager object and initialize it with given configuration.
LicenseID getTrialLicense(Customer::ptr_t user=nullptr, const std::string &licensePolicy=std::string())
Request trial license from LicenseSpring backend.
bool changePassword(const std::string &user, const std::string &password, const std::string &newPassword)
Change user password, meaningful only for user-based products.
const License::ptr_t activateLicense(const LicenseID &licenseID)
Activate license with given LicenseID.
LicenseID getTrialLicense(const std::string &userEmail)
Request trial license from LicenseSpring backend.
const License::ptr_t activateLicense(const LicenseID &licenseID, const std::vector< DeviceVariable > &deviceVariables)
Activate license with given LicenseID and device variables.
~LicenseManager() override
Destroy license manager and its configuration if there is no more references to the configuration.
std::wstring createOfflineActivationFile(const LicenseID &licenseID, const std::wstring &activationRequestFile=std::wstring())
Creates offline activation file request.
std::vector< LicenseUser::ptr_t > getLicenseUsers(const Customer &customer)
Get license users list by given customer (license owner).
InstallationFile::ptr_t getInstallationFile(const LicenseID &licenseID, const std::string &version=std::string(), const InstallFileFilter &filter=InstallFileFilter())
Get InstallationFile information for given license.
const License::ptr_t activateLicense(const std::string &authData, const std::string &accountCode=std::string(), bool useAuthCode=true)
Activate license using SSO.
const License::ptr_t activateAirGapLicense(const std::string &confirmationCode, const std::wstring &policyPath, const std::string &licenseKey, uint32_t policyId)
Verify Confirmation code and activate air gap license using given license policy or policies.
std::shared_ptr< LicenseStorage > ptr_t
Helper struct for filtering installation files by environment and channel.