2 * Copyright (c) 2014-2021 Samsung Electronics Co., Ltd. All rights reserved
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License
18 * @author Bartlomiej Grzelewski (b.grzelewski@samsung.com)
20 * @brief Sample service implementation.
22 #include <dpl/serialization.h>
23 #include <dpl/log/log.h>
24 #include <ckm/ckm-error.h>
25 #include <ckm/ckm-type.h>
26 #include <key-provider.h>
27 #include <file-system.h>
28 #include <ckm-logic.h>
30 #include <key-aes-impl.h>
31 #include <certificate-config.h>
32 #include <certificate-store.h>
34 #include <sw-backend/store.h>
35 #include <generic-backend/exception.h>
36 #include <ss-migrate.h>
39 const char *const CERT_SYSTEM_DIR = CA_CERTS_DIR;
40 const char *const DEFAULT_UNLOCK_STRING = "cAtRugU7";
42 bool isClientValid(const CKM::ClientId &client)
44 if (client.find(CKM::ALIAS_SEPARATOR) != CKM::ClientId::npos)
50 bool isNameValid(const CKM::Name &name)
52 if (name.find(CKM::ALIAS_SEPARATOR) != CKM::Name::npos)
58 // keypair data type, having private key data type and public key data type
59 // private is assumed to be .first, public .second
60 using DataTypePair = std::pair<CKM::DataType, CKM::DataType>;
62 const std::map<CKM::AlgoType, DataTypePair> ALGO_TYPE_TO_DATA_TYPE_PAIR_MAP = {
63 { CKM::AlgoType::RSA_GEN, { CKM::DataType(CKM::KeyType::KEY_RSA_PRIVATE), CKM::DataType(CKM::KeyType::KEY_RSA_PUBLIC) } },
64 { CKM::AlgoType::DSA_GEN, { CKM::DataType(CKM::KeyType::KEY_DSA_PRIVATE), CKM::DataType(CKM::KeyType::KEY_DSA_PUBLIC) } },
65 { CKM::AlgoType::ECDSA_GEN, { CKM::DataType(CKM::KeyType::KEY_ECDSA_PRIVATE), CKM::DataType(CKM::KeyType::KEY_ECDSA_PUBLIC) } },
68 } // anonymous namespace
74 template <int ERROR_ON_CKM_EXCEPTION = CKM_API_ERROR_SERVER_ERROR, class F>
78 static_assert(std::is_same_v<decltype(std::forward<F>(f)()), int>);
79 return std::forward<F>(f)();
80 } catch (const Exc::Exception &e) {
82 } catch (const CKM::Exception &e) {
83 LogError("CKM::Exception: " << e.GetMessage());
84 return ERROR_ON_CKM_EXCEPTION;
88 int toBinaryData(const Crypto::Data &input, Crypto::Data &output)
90 // verify the data integrity
91 if (input.type.isKey()) {
94 if (input.type.isSKey())
95 output_key = CKM::Key::createAES(input.data);
97 output_key = CKM::Key::create(input.data);
99 if (output_key.get() == NULL) {
100 LogDebug("provided binary data is not valid key data");
101 return CKM_API_ERROR_INPUT_PARAM;
104 output = Crypto::Data(input.type, output_key->getDER());
105 } else if (input.type.isCertificate() || input.type.isChainCert()) {
106 CertificateShPtr cert = CKM::Certificate::create(input.data,
107 DataFormat::FORM_DER);
109 if (cert.get() == NULL) {
110 LogDebug("provided binary data is not valid certificate data");
111 return CKM_API_ERROR_INPUT_PARAM;
114 output = Crypto::Data(input.type, cert->getDER());
119 // TODO: add here BINARY_DATA verification, i.e: max size etc.
120 return CKM_API_SUCCESS;
123 int verifyBinaryData(Crypto::Data &input)
126 return toBinaryData(input, dummy);
129 int readSingleRow(const Name &name,
130 const ClientId &owner,
132 DB::Crypto &database,
135 DB::Crypto::RowOptional row_optional;
137 if (dataType.isKey()) {
138 // read all key types
139 row_optional = database.getRow(name,
141 DataType::DB_KEY_FIRST,
142 DataType::DB_KEY_LAST);
144 // read anything else
145 row_optional = database.getRow(name,
151 LogDebug("No row for given name, owner and type");
152 return CKM_API_ERROR_DB_ALIAS_UNKNOWN;
157 return CKM_API_SUCCESS;
160 int readMultiRow(const Name &name,
161 const ClientId &owner,
163 DB::Crypto &database,
164 DB::RowVector &output)
166 if (dataType.isKey())
167 // read all key types
168 database.getRows(name,
170 DataType::DB_KEY_FIRST,
171 DataType::DB_KEY_LAST,
173 else if (dataType.isChainCert())
174 // read all key types
175 database.getRows(name,
177 DataType::DB_CHAIN_FIRST,
178 DataType::DB_CHAIN_LAST,
181 // read anything else
182 database.getRows(name,
187 if (!output.size()) {
188 LogDebug("No row for given name, owner and type");
189 return CKM_API_ERROR_DB_ALIAS_UNKNOWN;
192 return CKM_API_SUCCESS;
195 int loadAppKey(UserData &handle, const ClientId &owner)
197 if (!handle.crypto.haveKey(owner)) {
199 auto key_optional = handle.database.getKey(owner);
202 LogError("No key for given owner in database");
203 return CKM_API_ERROR_DB_ERROR;
207 key = handle.keyProvider.getPureDEK(key);
208 handle.crypto.pushKey(owner, key);
211 return CKM_API_SUCCESS;
216 const uid_t CKMLogic::SYSTEM_DB_UID = 0;
217 const uid_t CKMLogic::ADMIN_USER_DB_UID = 5001;
221 CertificateConfig::addSystemCertificateDir(CERT_SYSTEM_DIR);
223 m_accessControl.updateCCMode();
226 CKMLogic::~CKMLogic() {}
228 void CKMLogic::loadDKEKFile(uid_t user, const Password &password)
230 auto &handle = m_userDataMap[user];
234 auto wrappedDKEK = fs.getDKEK();
236 if (wrappedDKEK.empty()) {
237 wrappedDKEK = KeyProvider::generateDomainKEK(std::to_string(user), password);
238 fs.saveDKEK(wrappedDKEK);
241 handle.keyProvider = KeyProvider(wrappedDKEK, password);
242 if (!handle.keyProvider.isInitialized()) {
243 handle.keyProvider.migrateDomainKEK(wrappedDKEK, password);
244 fs.saveDKEK(handle.keyProvider.getWrappedDomainKEK(password));
245 LogInfo("DKEK migrated");
249 void CKMLogic::saveDKEKFile(uid_t user, const Password &password)
251 auto &handle = m_userDataMap[user];
254 fs.saveDKEK(handle.keyProvider.getWrappedDomainKEK(password));
257 void CKMLogic::migrateSecureStorageData(bool isAdminUser)
259 SsMigration::migrate(isAdminUser, [this](const std::string &name,
260 const Crypto::Data &data,
261 bool adminUserFlag) {
262 LogInfo("Migrate data called with name: " << name);
263 auto ownerId = adminUserFlag ? CLIENT_ID_ADMIN_USER : CLIENT_ID_SYSTEM;
264 auto uid = adminUserFlag ? ADMIN_USER_DB_UID : SYSTEM_DB_UID;
266 int ret = verifyAndSaveDataHelper(Credentials(uid, ownerId), name, ownerId, data,
267 PolicySerializable());
269 if (ret == CKM_API_ERROR_DB_ALIAS_EXISTS)
270 LogWarning("Alias already exist for migrated name: " << name);
271 else if (ret != CKM_API_SUCCESS)
272 LogError("Failed to migrate secure-storage data. name: " << name <<
277 int CKMLogic::unlockDatabase(uid_t user, const Password &password)
279 if (0 < m_userDataMap.count(user) &&
280 m_userDataMap[user].keyProvider.isInitialized())
281 return CKM_API_SUCCESS;
283 int retCode = tryRet([&] {
284 auto &handle = m_userDataMap[user];
287 loadDKEKFile(user, password);
289 auto wrappedDatabaseDEK = fs.getDBDEK();
291 if (wrappedDatabaseDEK.empty()) {
292 wrappedDatabaseDEK = handle.keyProvider.generateDEK(std::to_string(user));
293 fs.saveDBDEK(wrappedDatabaseDEK);
296 RawBuffer key = handle.keyProvider.getPureDEK(wrappedDatabaseDEK);
298 handle.database = DB::Crypto(fs.getLegacyDBPath(), fs.getDBPath(), key);
299 handle.crypto = CryptoLogic();
301 if (!m_accessControl.isSystemService(user)) {
302 // remove data of removed apps during locked state
303 ClientIdVector removedApps = fs.clearRemovedsApps();
305 for (auto &app : removedApps) {
306 handle.crypto.removeKey(app);
307 handle.database.deleteKey(app);
311 if (user == SYSTEM_DB_UID && SsMigration::hasData())
312 migrateSecureStorageData(false);
313 else if (user == ADMIN_USER_DB_UID && SsMigration::hasData())
314 migrateSecureStorageData(true);
316 return CKM_API_SUCCESS;
319 if (CKM_API_SUCCESS != retCode)
320 m_userDataMap.erase(user);
325 int CKMLogic::unlockSystemDB()
327 return unlockDatabase(SYSTEM_DB_UID, DEFAULT_UNLOCK_STRING);
330 UserData &CKMLogic::selectDatabase(const Credentials &cred,
331 const ClientId &owner)
333 // if user trying to access system service - check:
334 // * if user database is unlocked [mandatory]
335 // * if not - proceed with regular user database
336 // * if explicit system database owner given -> switch to system DB
337 if (!m_accessControl.isSystemService(cred)) {
338 if (0 == m_userDataMap.count(cred.clientUid))
339 ThrowErr(Exc::DatabaseLocked, "database with UID: ", cred.clientUid, " locked");
341 if (0 != owner.compare(CLIENT_ID_SYSTEM))
342 return m_userDataMap[cred.clientUid];
345 // system database selected, modify the owner id
346 if (CKM_API_SUCCESS != unlockSystemDB())
347 ThrowErr(Exc::DatabaseLocked, "can not unlock system database");
349 return m_userDataMap[SYSTEM_DB_UID];
352 RawBuffer CKMLogic::unlockUserKey(uid_t user, const Password &password)
354 int retCode = CKM_API_SUCCESS;
356 if (!m_accessControl.isSystemService(user))
357 retCode = unlockDatabase(user, password);
358 else // do not allow lock/unlock operations for system users
359 retCode = CKM_API_ERROR_INPUT_PARAM;
361 return SerializeMessage(retCode);
364 RawBuffer CKMLogic::updateCCMode()
366 m_accessControl.updateCCMode();
367 return SerializeMessage(CKM_API_SUCCESS);
370 RawBuffer CKMLogic::lockUserKey(uid_t user)
372 int retCode = CKM_API_SUCCESS;
374 if (!m_accessControl.isSystemService(user))
375 m_userDataMap.erase(user);
376 else // do not allow lock/unlock operations for system users
377 retCode = CKM_API_ERROR_INPUT_PARAM;
379 return SerializeMessage(retCode);
382 RawBuffer CKMLogic::removeUserData(uid_t user)
384 if (m_accessControl.isSystemService(user))
385 user = SYSTEM_DB_UID;
387 m_userDataMap.erase(user);
389 const int retCode = FileSystem(user).removeUserData()
390 ? CKM_API_ERROR_FILE_SYSTEM
393 return SerializeMessage(retCode);
396 int CKMLogic::changeUserPasswordHelper(uid_t user,
397 const Password &oldPassword,
398 const Password &newPassword)
400 // do not allow to change system database password
401 if (m_accessControl.isSystemService(user))
402 return CKM_API_ERROR_INPUT_PARAM;
404 loadDKEKFile(user, oldPassword);
405 saveDKEKFile(user, newPassword);
407 return CKM_API_SUCCESS;
410 RawBuffer CKMLogic::changeUserPassword(
412 const Password &oldPassword,
413 const Password &newPassword)
415 return SerializeMessage(tryRet([&] {
416 return changeUserPasswordHelper(user, oldPassword, newPassword);
420 int CKMLogic::resetUserPasswordHelper(
422 const Password &newPassword)
424 // do not allow to reset system database password
425 if (m_accessControl.isSystemService(user))
426 return CKM_API_ERROR_INPUT_PARAM;
428 int retCode = CKM_API_SUCCESS;
430 if (0 == m_userDataMap.count(user)) {
431 // Check if key exists. If exists we must return error
433 auto wrappedDKEKMain = fs.getDKEK();
435 if (!wrappedDKEKMain.empty())
436 retCode = CKM_API_ERROR_BAD_REQUEST;
438 saveDKEKFile(user, newPassword);
444 RawBuffer CKMLogic::resetUserPassword(
446 const Password &newPassword)
448 return SerializeMessage(tryRet([&] {
449 return resetUserPasswordHelper(user, newPassword);
453 RawBuffer CKMLogic::removeApplicationData(const ClientId &owner)
455 return SerializeMessage(tryRet([&] {
457 return CKM_API_ERROR_INPUT_PARAM;
459 UidVector uids = FileSystem::getUIDsFromDBFile();
461 for (auto userId : uids) {
462 if (0 == m_userDataMap.count(userId)) {
463 FileSystem fs(userId);
464 fs.addRemovedApp(owner);
466 auto &handle = m_userDataMap[userId];
467 handle.crypto.removeKey(owner);
468 handle.database.deleteKey(owner);
472 return CKM_API_SUCCESS;
476 int CKMLogic::checkSaveConditions(
477 const Credentials &accessorCred,
480 const ClientId &owner)
482 // verify name and client are correct
483 if (!isNameValid(name) || !isClientValid(owner)) {
484 LogDebug("Invalid parameter passed to key-manager");
485 return CKM_API_ERROR_INPUT_PARAM;
488 // check if accessor is allowed to save owner's items
489 int access_ec = m_accessControl.canSave(accessorCred, owner);
491 if (access_ec != CKM_API_SUCCESS) {
492 LogDebug("accessor " << accessorCred.client << " can not save rows owned by " <<
497 // check if not a duplicate
498 if (handler.database.isNameOwnerPresent(name, owner))
499 return CKM_API_ERROR_DB_ALIAS_EXISTS;
501 // encryption section
502 if (!handler.crypto.haveKey(owner)) {
504 auto key_optional = handler.database.getKey(owner);
507 LogDebug("No Key in database found. Generating new one for client: " <<
509 got_key = handler.keyProvider.generateDEK(owner);
510 handler.database.saveKey(owner, got_key);
512 LogDebug("Key from DB");
513 got_key = *key_optional;
516 got_key = handler.keyProvider.getPureDEK(got_key);
517 handler.crypto.pushKey(owner, got_key);
520 return CKM_API_SUCCESS;
523 DB::Row CKMLogic::createEncryptedRow(
526 const ClientId &owner,
527 const Crypto::Data &data,
528 const Policy &policy,
529 const RawBuffer &hash)
531 Crypto::GStore &store = m_decider.getStore(data.type, policy);
533 // do not encrypt data with password during cc_mode on
534 Token token = store.import(data,
535 m_accessControl.isCCMode() ? "" : policy.password,
536 Crypto::EncryptionParams(), hash);
537 DB::Row row(std::move(token), name, owner,
538 static_cast<int>(policy.extractable));
539 crypto.encryptRow(row);
543 int CKMLogic::verifyAndSaveDataHelper(
544 const Credentials &cred,
546 const ClientId &owner,
547 const Crypto::Data &data,
548 const PolicySerializable &policy)
551 // check if data is correct
552 Crypto::Data binaryData;
553 int retCode = toBinaryData(data, binaryData);
555 return retCode != CKM_API_SUCCESS
557 : saveDataHelper(cred, name, owner, binaryData, policy);
561 int CKMLogic::getKeyForService(
562 const Credentials &cred,
564 const ClientId &owner,
565 const Password &pass,
566 Crypto::GObjShPtr &key)
569 // Key is for internal service use. It won't be exported to the client
570 Crypto::GObjUPtr obj;
571 int retCode = readDataHelper(false, cred, DataType::DB_KEY_FIRST, name, owner,
574 if (retCode == CKM_API_SUCCESS)
575 key = std::move(obj);
581 RawBuffer CKMLogic::saveData(
582 const Credentials &cred,
585 const ClientId &owner,
586 const Crypto::Data &data,
587 const PolicySerializable &policy)
589 int retCode = verifyAndSaveDataHelper(cred, name, owner, data, policy);
590 return SerializeMessage(msgId, retCode, data.type);
593 int CKMLogic::extractPKCS12Data(
596 const ClientId &owner,
597 const PKCS12Serializable &pkcs,
598 const PolicySerializable &keyPolicy,
599 const PolicySerializable &certPolicy,
600 DB::RowVector &output,
601 const Credentials &cred)
603 // private key is mandatory
604 auto key = pkcs.getKey();
607 LogError("Failed to get private key from pkcs");
608 return CKM_API_ERROR_INVALID_FORMAT;
611 auto digest = CryptoLogic::makeHash(name, owner, cred.clientUid);
613 return CKM_API_ERROR_HASH_ERROR;
615 Crypto::Data keyData(DataType(key->getType()), key->getDER());
616 int retCode = verifyBinaryData(keyData);
618 if (retCode != CKM_API_SUCCESS)
621 output.push_back(createEncryptedRow(crypto, name, owner, keyData,
624 // certificate is mandatory
625 auto cert = pkcs.getCertificate();
628 LogError("Failed to get certificate from pkcs");
629 return CKM_API_ERROR_INVALID_FORMAT;
632 Crypto::Data certData(DataType::CERTIFICATE, cert->getDER());
633 retCode = verifyBinaryData(certData);
635 if (retCode != CKM_API_SUCCESS)
638 output.push_back(createEncryptedRow(crypto, name, owner, certData,
639 certPolicy, digest));
642 unsigned int cert_index = 0;
644 for (const auto &ca : pkcs.getCaCertificateShPtrVector()) {
645 Crypto::Data caCertData(DataType::getChainDatatype(cert_index ++),
647 int retCode = verifyBinaryData(caCertData);
649 if (retCode != CKM_API_SUCCESS)
652 output.push_back(createEncryptedRow(crypto, name, owner, caCertData,
653 certPolicy, digest));
656 return CKM_API_SUCCESS;
659 RawBuffer CKMLogic::savePKCS12(
660 const Credentials &cred,
663 const ClientId &owner,
664 const PKCS12Serializable &pkcs,
665 const PolicySerializable &keyPolicy,
666 const PolicySerializable &certPolicy)
668 return SerializeMessage(msgId, tryRet([&] {
669 return saveDataHelper(cred, name, owner, pkcs, keyPolicy, certPolicy);
674 int CKMLogic::removeDataHelper(
675 const Credentials &cred,
677 const ClientId &owner)
679 auto &handler = selectDatabase(cred, owner);
681 if (!isNameValid(name) || !isClientValid(owner)) {
682 LogDebug("Invalid owner or name format");
683 return CKM_API_ERROR_INPUT_PARAM;
686 DB::Crypto::Transaction transaction(&handler.database);
688 // read and check permissions
689 PermissionMaskOptional permissionRowOpt =
690 handler.database.getPermissionRow(name, owner, cred.client);
691 int retCode = m_accessControl.canDelete(cred,
692 toPermissionMask(permissionRowOpt));
694 if (retCode != CKM_API_SUCCESS) {
695 LogWarning("access control check result: " << retCode);
699 // get all matching rows
701 handler.database.getRows(name, owner, DataType::DB_FIRST,
702 DataType::DB_LAST, rows);
705 LogDebug("No row for given name and owner");
706 return CKM_API_ERROR_DB_ALIAS_UNKNOWN;
709 // load app key if needed
710 retCode = loadAppKey(handler, rows.front().owner);
712 if (CKM_API_SUCCESS != retCode)
715 // destroy it in store
716 for (auto &r : rows) {
718 handler.crypto.decryptRow(Password(), r);
719 m_decider.getStore(r).destroy(r);
720 } catch (const Exc::AuthenticationFailed &) {
721 LogDebug("Authentication failed when removing data. Ignored.");
726 handler.database.deleteRow(name, owner);
727 transaction.commit();
729 return CKM_API_SUCCESS;
732 RawBuffer CKMLogic::removeData(
733 const Credentials &cred,
736 const ClientId &owner)
738 return SerializeMessage(msgId, tryRet([&] {
739 return removeDataHelper(cred, name, owner);
744 int CKMLogic::checkDataPermissionsHelper(const Credentials &accessorCred,
746 const ClientId &owner,
749 DB::Crypto &database)
751 PermissionMaskOptional permissionRowOpt =
752 database.getPermissionRow(name, owner, accessorCred.client);
755 return m_accessControl.canExport(accessorCred,
757 toPermissionMask(permissionRowOpt));
759 return m_accessControl.canRead(accessorCred,
760 toPermissionMask(permissionRowOpt));
763 Crypto::GObjUPtr CKMLogic::rowToObject(
766 const Password &password,
767 const RawBuffer &hash)
769 Crypto::GStore &store = m_decider.getStore(row);
771 Password pass = m_accessControl.isCCMode() ? "" : password;
774 Crypto::GObjUPtr obj;
776 if (CryptoLogic::getSchemeVersion(row.encryptionScheme) ==
777 CryptoLogic::ENCRYPTION_V2) {
778 handler.crypto.decryptRow(Password(), row);
780 obj = store.getObject(row, pass);
782 // decrypt entirely with old scheme: b64(pass(appkey(data))) -> data
783 handler.crypto.decryptRow(pass, row);
784 // destroy it in store
787 // import it to store with new scheme: data -> pass(data)
788 Token token = store.import(Crypto::Data(row.dataType, row.data), pass, Crypto::EncryptionParams(), hash);
790 // get it from the store (it can be different than the data we imported into store)
791 obj = store.getObject(token, pass);
793 // update row with new token
794 *static_cast<Token *>(&row) = std::move(token);
796 // encrypt it with app key: pass(data) -> b64(appkey(pass(data))
797 handler.crypto.encryptRow(row);
800 handler.database.updateRow(row);
806 int CKMLogic::readDataHelper(
808 const Credentials &cred,
811 const ClientId &owner,
812 const Password &password,
813 Crypto::GObjUPtrVector &objs)
815 auto &handler = selectDatabase(cred, owner);
817 if (!isNameValid(name) || !isClientValid(owner))
818 return CKM_API_ERROR_INPUT_PARAM;
821 DB::Crypto::Transaction transaction(&handler.database);
823 int retCode = readMultiRow(name, owner, dataType, handler.database, rows);
825 if (CKM_API_SUCCESS != retCode)
828 // all read rows belong to the same owner
829 DB::Row &firstRow = rows.at(0);
831 // check access rights
832 retCode = checkDataPermissionsHelper(cred, name, owner, firstRow,
833 exportFlag, handler.database);
835 if (CKM_API_SUCCESS != retCode)
838 // load app key if needed
839 retCode = loadAppKey(handler, firstRow.owner);
841 if (CKM_API_SUCCESS != retCode)
844 auto digest = CryptoLogic::makeHash(name, owner, cred.clientUid);
846 return CKM_API_ERROR_HASH_ERROR;
849 for (auto &row : rows)
850 objs.push_back(rowToObject(handler, std::move(row), password, digest));
852 // rowToObject may modify db
853 transaction.commit();
855 return CKM_API_SUCCESS;
858 int CKMLogic::readDataHelper(
860 const Credentials &cred,
863 const ClientId &owner,
864 const Password &password,
865 Crypto::GObjUPtr &obj)
867 DataType objDataType;
868 return readDataHelper(exportFlag, cred, dataType, name, owner,
869 password, obj, objDataType);
872 int CKMLogic::readDataHelper(
874 const Credentials &cred,
877 const ClientId &owner,
878 const Password &password,
879 Crypto::GObjUPtr &obj,
880 DataType &objDataType)
882 auto &handler = selectDatabase(cred, owner);
884 if (!isNameValid(name) || !isClientValid(owner))
885 return CKM_API_ERROR_INPUT_PARAM;
888 DB::Crypto::Transaction transaction(&handler.database);
890 int retCode = readSingleRow(name, owner, dataType, handler.database, row);
892 if (CKM_API_SUCCESS != retCode)
895 objDataType = row.dataType;
897 // check access rights
898 retCode = checkDataPermissionsHelper(cred, name, owner, row, exportFlag,
901 if (CKM_API_SUCCESS != retCode)
904 // load app key if needed
905 retCode = loadAppKey(handler, row.owner);
907 if (CKM_API_SUCCESS != retCode)
910 auto digest = CryptoLogic::makeHash(name, owner, cred.clientUid);
912 return CKM_API_ERROR_HASH_ERROR;
914 obj = rowToObject(handler, std::move(row), password, digest);
915 // rowToObject may modify db
916 transaction.commit();
918 return CKM_API_SUCCESS;
921 RawBuffer CKMLogic::getData(
922 const Credentials &cred,
926 const ClientId &owner,
927 const Password &password)
930 DataType objDataType;
932 int retCode = tryRet([&] {
933 Crypto::GObjUPtr obj;
934 int retCode = readDataHelper(true, cred, dataType, name, owner,
935 password, obj, objDataType);
937 if (retCode == CKM_API_SUCCESS)
938 rowData = obj->getBinary();
943 if (CKM_API_SUCCESS != retCode)
946 return SerializeMessage(msgId, retCode, objDataType, rowData);
949 RawBuffer CKMLogic::getDataProtectionStatus(
950 const Credentials &cred,
954 const ClientId &owner)
957 DataType objDataType;
960 int retCode = tryRet([&] {
961 Crypto::GObjUPtr obj;
962 return readDataHelper(false, cred, dataType, name, owner, password, obj, objDataType);
965 if (retCode == CKM_API_ERROR_AUTHENTICATION_FAILED) {
967 retCode = CKM_API_SUCCESS;
970 return SerializeMessage(msgId, retCode, objDataType, status);
973 int CKMLogic::getPKCS12Helper(
974 const Credentials &cred,
976 const ClientId &owner,
977 const Password &keyPassword,
978 const Password &certPassword,
980 CertificateShPtr &cert,
981 CertificateShPtrVector &caChain)
985 // read private key (mandatory)
986 Crypto::GObjUPtr keyObj;
987 retCode = readDataHelper(true, cred, DataType::DB_KEY_FIRST, name, owner,
988 keyPassword, keyObj);
990 if (retCode != CKM_API_SUCCESS) {
991 if (retCode != CKM_API_ERROR_NOT_EXPORTABLE)
994 privKey = CKM::Key::create(keyObj->getBinary());
997 // read certificate (mandatory)
998 Crypto::GObjUPtr certObj;
999 retCode = readDataHelper(true, cred, DataType::CERTIFICATE, name, owner,
1000 certPassword, certObj);
1002 if (retCode != CKM_API_SUCCESS) {
1003 if (retCode != CKM_API_ERROR_NOT_EXPORTABLE)
1006 cert = CKM::Certificate::create(certObj->getBinary(), DataFormat::FORM_DER);
1009 // read CA cert chain (optional)
1010 Crypto::GObjUPtrVector caChainObjs;
1011 retCode = readDataHelper(true, cred, DataType::DB_CHAIN_FIRST, name, owner,
1012 certPassword, caChainObjs);
1014 if (retCode != CKM_API_SUCCESS && retCode != CKM_API_ERROR_DB_ALIAS_UNKNOWN) {
1015 if (retCode != CKM_API_ERROR_NOT_EXPORTABLE)
1018 for (auto &caCertObj : caChainObjs)
1019 caChain.push_back(CKM::Certificate::create(caCertObj->getBinary(),
1020 DataFormat::FORM_DER));
1023 // if anything found, return it
1024 if (privKey || cert || caChain.size() > 0)
1025 retCode = CKM_API_SUCCESS;
1030 RawBuffer CKMLogic::getPKCS12(
1031 const Credentials &cred,
1034 const ClientId &owner,
1035 const Password &keyPassword,
1036 const Password &certPassword)
1038 PKCS12Serializable output;
1040 int retCode = tryRet([&] {
1042 CertificateShPtr cert;
1043 CertificateShPtrVector caChain;
1044 int retCode = getPKCS12Helper(cred, name, owner, keyPassword,
1045 certPassword, privKey, cert, caChain);
1048 if (retCode == CKM_API_SUCCESS)
1049 output = PKCS12Serializable(std::move(privKey), std::move(cert), std::move(caChain));
1054 return SerializeMessage(msgId, retCode, output);
1057 int CKMLogic::getDataListHelper(const Credentials &cred,
1058 const DataType dataType,
1059 OwnerNameVector &ownerNameVector)
1061 int retCode = CKM_API_ERROR_DB_LOCKED;
1063 if (0 < m_userDataMap.count(cred.clientUid)) {
1064 auto &database = m_userDataMap[cred.clientUid].database;
1066 retCode = tryRet<CKM_API_ERROR_DB_ERROR>([&] {
1067 OwnerNameVector tmpVector;
1069 if (dataType.isKey()) {
1070 // list all key types
1071 database.listNames(cred.client,
1073 DataType::DB_KEY_FIRST,
1074 DataType::DB_KEY_LAST);
1076 // list anything else
1077 database.listNames(cred.client,
1082 ownerNameVector.insert(ownerNameVector.end(), tmpVector.begin(),
1084 return CKM_API_SUCCESS;
1091 RawBuffer CKMLogic::getDataList(
1092 const Credentials &cred,
1096 OwnerNameVector systemVector;
1097 OwnerNameVector userVector;
1098 OwnerNameVector ownerNameVector;
1100 int retCode = unlockSystemDB();
1102 if (CKM_API_SUCCESS == retCode) {
1104 if (m_accessControl.isSystemService(cred)) {
1106 retCode = getDataListHelper(Credentials(SYSTEM_DB_UID,
1111 // user - lookup system, then client DB
1112 retCode = getDataListHelper(Credentials(SYSTEM_DB_UID,
1118 if (retCode == CKM_API_SUCCESS) {
1119 retCode = getDataListHelper(cred,
1126 if (retCode == CKM_API_SUCCESS) {
1127 ownerNameVector.insert(ownerNameVector.end(), systemVector.begin(),
1128 systemVector.end());
1129 ownerNameVector.insert(ownerNameVector.end(), userVector.begin(),
1133 return SerializeMessage(msgId, retCode, dataType, ownerNameVector);
1136 int CKMLogic::importInitialData(
1138 const Crypto::Data &data,
1139 const Crypto::EncryptionParams &encParams,
1140 const Policy &policy)
1144 if (encParams.iv.empty() != encParams.tag.empty()) {
1145 LogError("Both iv and tag must be empty or set");
1146 return CKM_API_ERROR_INPUT_PARAM;
1149 // Inital values are always imported with root credentials. Client id is not important.
1150 Credentials rootCred(0, "");
1151 ClientId owner(CLIENT_ID_SYSTEM);
1152 auto &handler = selectDatabase(rootCred, CLIENT_ID_SYSTEM);
1154 // check if save is possible
1155 DB::Crypto::Transaction transaction(&handler.database);
1156 int retCode = checkSaveConditions(rootCred, handler, name, CLIENT_ID_SYSTEM);
1157 if (retCode != CKM_API_SUCCESS)
1160 Crypto::GStore &store = m_decider.getStore(data.type,
1162 !encParams.iv.empty());
1166 auto digest = CryptoLogic::makeHash(name, owner, rootCred.clientUid);
1168 return CKM_API_ERROR_HASH_ERROR;
1170 if (encParams.iv.empty()) {
1171 // Data are not encrypted, let's try to verify them
1172 Crypto::Data binaryData;
1174 if (CKM_API_SUCCESS != (retCode = toBinaryData(data, binaryData)))
1177 token = store.import(binaryData,
1178 m_accessControl.isCCMode() ? "" : policy.password,
1181 token = store.import(data,
1182 m_accessControl.isCCMode() ? "" : policy.password,
1186 DB::Row row(std::move(token), name, CLIENT_ID_SYSTEM,
1187 static_cast<int>(policy.extractable));
1188 handler.crypto.encryptRow(row);
1190 handler.database.saveRow(row);
1191 transaction.commit();
1193 return CKM_API_SUCCESS;
1195 } catch (const std::exception &e) {
1196 LogError("Std::exception: " << e.what());
1197 return CKM_API_ERROR_SERVER_ERROR;
1201 int CKMLogic::saveDataHelper(
1202 const Credentials &cred,
1204 const ClientId &owner,
1205 const Crypto::Data &data,
1206 const PolicySerializable &policy)
1208 auto &handler = selectDatabase(cred, owner);
1210 // check if save is possible
1211 DB::Crypto::Transaction transaction(&handler.database);
1212 int retCode = checkSaveConditions(cred, handler, name, owner);
1213 if (retCode != CKM_API_SUCCESS)
1216 auto digest = CryptoLogic::makeHash(name, owner, cred.clientUid);
1218 return CKM_API_ERROR_HASH_ERROR;
1221 DB::Row encryptedRow = createEncryptedRow(handler.crypto, name, owner,
1222 data, policy, digest);
1223 handler.database.saveRow(encryptedRow);
1225 transaction.commit();
1226 return CKM_API_SUCCESS;
1229 int CKMLogic::saveDataHelper(
1230 const Credentials &cred,
1232 const ClientId &owner,
1233 const PKCS12Serializable &pkcs,
1234 const PolicySerializable &keyPolicy,
1235 const PolicySerializable &certPolicy)
1237 auto &handler = selectDatabase(cred, owner);
1239 // check if save is possible
1240 DB::Crypto::Transaction transaction(&handler.database);
1241 int retCode = checkSaveConditions(cred, handler, name, owner);
1242 if (retCode != CKM_API_SUCCESS)
1245 // extract and encrypt the data
1246 DB::RowVector encryptedRows;
1247 retCode = extractPKCS12Data(handler.crypto, name, owner, pkcs, keyPolicy,
1248 certPolicy, encryptedRows, cred);
1250 if (retCode != CKM_API_SUCCESS)
1254 handler.database.saveRows(name, owner, encryptedRows);
1255 transaction.commit();
1257 return CKM_API_SUCCESS;
1261 int CKMLogic::createKeyAESHelper(
1262 const Credentials &cred,
1265 const ClientId &owner,
1266 const PolicySerializable &policy)
1268 auto &handler = selectDatabase(cred, owner);
1270 // check if save is possible
1271 DB::Crypto::Transaction transaction(&handler.database);
1272 int retCode = checkSaveConditions(cred, handler, name, owner);
1273 if (retCode != CKM_API_SUCCESS)
1276 auto digest = CryptoLogic::makeHash(name, owner, cred.clientUid);
1278 return CKM_API_ERROR_HASH_ERROR;
1280 // create key in store
1281 CryptoAlgorithm keyGenAlgorithm;
1282 keyGenAlgorithm.setParam(ParamName::ALGO_TYPE, AlgoType::AES_GEN);
1283 keyGenAlgorithm.setParam(ParamName::GEN_KEY_LEN, size);
1284 Token key = m_decider.getStore(DataType::KEY_AES,
1285 policy).generateSKey(keyGenAlgorithm, policy.password, digest);
1288 DB::Row row(std::move(key), name, owner,
1289 static_cast<int>(policy.extractable));
1290 handler.crypto.encryptRow(row);
1292 handler.database.saveRow(row);
1294 transaction.commit();
1295 return CKM_API_SUCCESS;
1298 int CKMLogic::createKeyPairHelper(
1299 const Credentials &cred,
1300 const CryptoAlgorithmSerializable &keyGenParams,
1301 const Name &namePrivate,
1302 const ClientId &ownerPrivate,
1303 const Name &namePublic,
1304 const ClientId &ownerPublic,
1305 const PolicySerializable &policyPrivate,
1306 const PolicySerializable &policyPublic)
1308 auto &handlerPriv = selectDatabase(cred, ownerPrivate);
1309 auto &handlerPub = selectDatabase(cred, ownerPublic);
1311 AlgoType keyType = AlgoType::RSA_GEN;
1313 if (!keyGenParams.getParam(ParamName::ALGO_TYPE, keyType))
1314 ThrowErr(Exc::InputParam, "Error, parameter ALGO_TYPE not found.");
1316 const auto dtIt = ALGO_TYPE_TO_DATA_TYPE_PAIR_MAP.find(keyType);
1317 if (dtIt == ALGO_TYPE_TO_DATA_TYPE_PAIR_MAP.end())
1318 ThrowErr(Exc::InputParam, "Error, parameter ALGO_TYPE with wrong value.");
1319 const DataTypePair& dt = dtIt->second;
1321 if (policyPrivate.backend != policyPublic.backend)
1322 ThrowErr(Exc::InputParam, "Error, key pair must be supported with the same backend.");
1324 bool exportable = policyPrivate.extractable || policyPublic.extractable;
1325 Policy lessRestricted(Password(), exportable, policyPrivate.backend);
1327 auto digestPriv = CryptoLogic::makeHash(namePrivate, ownerPrivate, cred.clientUid);
1328 if (digestPriv.empty())
1329 return CKM_API_ERROR_HASH_ERROR;
1331 auto digestPub = CryptoLogic::makeHash(namePublic, ownerPublic, cred.clientUid);
1332 if (digestPub.empty())
1333 return CKM_API_ERROR_HASH_ERROR;
1335 TokenPair keys = m_decider.getStore(policyPrivate, dt.first, dt.second).generateAKey(keyGenParams,
1336 policyPrivate.password,
1337 policyPublic.password,
1338 digestPriv, digestPub);
1340 DB::Crypto::Transaction transactionPriv(&handlerPriv.database);
1341 // in case the same database is used for private and public - the second
1342 // transaction will not be executed
1343 DB::Crypto::Transaction transactionPub(&handlerPub.database);
1346 retCode = checkSaveConditions(cred, handlerPriv, namePrivate, ownerPrivate);
1347 if (CKM_API_SUCCESS != retCode)
1350 retCode = checkSaveConditions(cred, handlerPub, namePublic, ownerPublic);
1351 if (CKM_API_SUCCESS != retCode)
1355 DB::Row rowPrv(std::move(keys.first), namePrivate, ownerPrivate,
1356 static_cast<int>(policyPrivate.extractable));
1357 handlerPriv.crypto.encryptRow(rowPrv);
1358 handlerPriv.database.saveRow(rowPrv);
1360 DB::Row rowPub(std::move(keys.second), namePublic, ownerPublic,
1361 static_cast<int>(policyPublic.extractable));
1362 handlerPub.crypto.encryptRow(rowPub);
1363 handlerPub.database.saveRow(rowPub);
1365 transactionPub.commit();
1366 transactionPriv.commit();
1367 return CKM_API_SUCCESS;
1370 RawBuffer CKMLogic::createKeyPair(
1371 const Credentials &cred,
1373 const CryptoAlgorithmSerializable &keyGenParams,
1374 const Name &namePrivate,
1375 const ClientId &ownerPrivate,
1376 const Name &namePublic,
1377 const ClientId &ownerPublic,
1378 const PolicySerializable &policyPrivate,
1379 const PolicySerializable &policyPublic)
1381 return SerializeMessage(msgId, tryRet([&] {
1382 return createKeyPairHelper(cred, keyGenParams, namePrivate, ownerPrivate,
1383 namePublic, ownerPublic, policyPrivate, policyPublic);
1387 RawBuffer CKMLogic::createKeyAES(
1388 const Credentials &cred,
1392 const ClientId &owner,
1393 const PolicySerializable &policy)
1395 int retCode = CKM_API_SUCCESS;
1398 retCode = tryRet([&] {
1399 return createKeyAESHelper(cred, size, name, owner, policy);
1401 } catch (std::invalid_argument &e) {
1402 LogDebug("invalid argument error: " << e.what());
1403 retCode = CKM_API_ERROR_INPUT_PARAM;
1406 return SerializeMessage(msgId, retCode);
1409 int CKMLogic::readCertificateHelper(
1410 const Credentials &cred,
1411 const OwnerNameVector &ownerNameVector,
1412 CertificateImplVector &certVector)
1414 for (auto &i : ownerNameVector) {
1415 // certificates can't be protected with custom user password
1416 Crypto::GObjUPtr obj;
1418 ec = readDataHelper(true,
1420 DataType::CERTIFICATE,
1422 cred.effectiveOwner(i.first),
1426 if (ec != CKM_API_SUCCESS)
1429 certVector.emplace_back(obj->getBinary(), DataFormat::FORM_DER);
1431 // try to read chain certificates (if present)
1432 Crypto::GObjUPtrVector caChainObjs;
1433 ec = readDataHelper(true,
1435 DataType::DB_CHAIN_FIRST,
1437 cred.effectiveOwner(i.first),
1441 if (ec != CKM_API_SUCCESS && ec != CKM_API_ERROR_DB_ALIAS_UNKNOWN)
1444 for (auto &caCertObj : caChainObjs)
1445 certVector.emplace_back(caCertObj->getBinary(), DataFormat::FORM_DER);
1448 return CKM_API_SUCCESS;
1451 int CKMLogic::getCertificateChainHelper(
1452 const CertificateImpl &cert,
1453 const RawBufferVector &untrustedCertificates,
1454 const RawBufferVector &trustedCertificates,
1455 bool useTrustedSystemCertificates,
1456 RawBufferVector &chainRawVector)
1458 CertificateImplVector untrustedCertVector;
1459 CertificateImplVector trustedCertVector;
1460 CertificateImplVector chainVector;
1463 return CKM_API_ERROR_INPUT_PARAM;
1465 for (auto &e : untrustedCertificates) {
1466 CertificateImpl c(e, DataFormat::FORM_DER);
1469 return CKM_API_ERROR_INPUT_PARAM;
1471 untrustedCertVector.push_back(std::move(c));
1474 for (auto &e : trustedCertificates) {
1475 CertificateImpl c(e, DataFormat::FORM_DER);
1478 return CKM_API_ERROR_INPUT_PARAM;
1480 trustedCertVector.push_back(std::move(c));
1483 CertificateStore store;
1484 int retCode = store.verifyCertificate(cert,
1485 untrustedCertVector,
1487 useTrustedSystemCertificates,
1488 m_accessControl.isCCMode(),
1491 if (retCode != CKM_API_SUCCESS)
1494 for (auto &e : chainVector)
1495 chainRawVector.push_back(e.getDER());
1497 return CKM_API_SUCCESS;
1500 int CKMLogic::getCertificateChainHelper(
1501 const Credentials &cred,
1502 const CertificateImpl &cert,
1503 const OwnerNameVector &untrusted,
1504 const OwnerNameVector &trusted,
1505 bool useTrustedSystemCertificates,
1506 RawBufferVector &chainRawVector)
1508 CertificateImplVector untrustedCertVector;
1509 CertificateImplVector trustedCertVector;
1510 CertificateImplVector chainVector;
1513 return CKM_API_ERROR_INPUT_PARAM;
1515 int retCode = readCertificateHelper(cred, untrusted, untrustedCertVector);
1517 if (retCode != CKM_API_SUCCESS)
1520 retCode = readCertificateHelper(cred, trusted, trustedCertVector);
1522 if (retCode != CKM_API_SUCCESS)
1525 CertificateStore store;
1526 retCode = store.verifyCertificate(cert,
1527 untrustedCertVector,
1529 useTrustedSystemCertificates,
1530 m_accessControl.isCCMode(),
1533 if (retCode != CKM_API_SUCCESS)
1536 for (auto &i : chainVector)
1537 chainRawVector.push_back(i.getDER());
1539 return CKM_API_SUCCESS;
1542 RawBuffer CKMLogic::getCertificateChain(
1543 const Credentials & /*cred*/,
1545 const RawBuffer &certificate,
1546 const RawBufferVector &untrustedCertificates,
1547 const RawBufferVector &trustedCertificates,
1548 bool useTrustedSystemCertificates)
1550 CertificateImpl cert(certificate, DataFormat::FORM_DER);
1551 RawBufferVector chainRawVector;
1552 int retCode = CKM_API_ERROR_UNKNOWN;
1555 retCode = getCertificateChainHelper(cert,
1556 untrustedCertificates,
1557 trustedCertificates,
1558 useTrustedSystemCertificates,
1560 } catch (const Exc::Exception &e) {
1561 retCode = e.error();
1562 } catch (const std::exception &e) {
1563 LogError("STD exception " << e.what());
1564 retCode = CKM_API_ERROR_SERVER_ERROR;
1566 LogError("Unknown error.");
1569 return SerializeMessage(msgId, retCode, chainRawVector);
1572 RawBuffer CKMLogic::getCertificateChain(
1573 const Credentials &cred,
1575 const RawBuffer &certificate,
1576 const OwnerNameVector &untrustedCertificates,
1577 const OwnerNameVector &trustedCertificates,
1578 bool useTrustedSystemCertificates)
1580 int retCode = CKM_API_ERROR_UNKNOWN;
1581 CertificateImpl cert(certificate, DataFormat::FORM_DER);
1582 RawBufferVector chainRawVector;
1585 retCode = getCertificateChainHelper(cred,
1587 untrustedCertificates,
1588 trustedCertificates,
1589 useTrustedSystemCertificates,
1591 } catch (const Exc::Exception &e) {
1592 retCode = e.error();
1593 } catch (const std::exception &e) {
1594 LogError("STD exception " << e.what());
1595 retCode = CKM_API_ERROR_SERVER_ERROR;
1597 LogError("Unknown error.");
1600 return SerializeMessage(msgId, retCode, chainRawVector);
1603 RawBuffer CKMLogic::createSignature(
1604 const Credentials &cred,
1606 const Name &privateKeyName,
1607 const ClientId &owner,
1608 const Password &password, // password for private_key
1609 const RawBuffer &message,
1610 const CryptoAlgorithm &cryptoAlg)
1612 RawBuffer signature;
1614 int retCode = CKM_API_SUCCESS;
1617 retCode = tryRet([&] {
1618 Crypto::GObjUPtr obj;
1619 int retCode = readDataHelper(false, cred, DataType::DB_KEY_FIRST, privateKeyName,
1620 owner, password, obj);
1622 if (retCode == CKM_API_SUCCESS)
1623 signature = obj->sign(cryptoAlg, message);
1627 } catch (const std::exception &e) {
1628 LogError("STD exception " << e.what());
1629 retCode = CKM_API_ERROR_SERVER_ERROR;
1632 return SerializeMessage(msgId, retCode, signature);
1635 RawBuffer CKMLogic::verifySignature(
1636 const Credentials &cred,
1638 const Name &publicKeyOrCertName,
1639 const ClientId &owner,
1640 const Password &password, // password for public_key (optional)
1641 const RawBuffer &message,
1642 const RawBuffer &signature,
1643 const CryptoAlgorithm ¶ms)
1645 return SerializeMessage(msgId, tryRet([&] {
1646 // try certificate first - looking for a public key.
1647 // in case of PKCS, pub key from certificate will be found first
1648 // rather than private key from the same PKCS.
1649 Crypto::GObjUPtr obj;
1650 int retCode = readDataHelper(false, cred, DataType::CERTIFICATE,
1651 publicKeyOrCertName, owner, password, obj);
1653 if (retCode == CKM_API_ERROR_DB_ALIAS_UNKNOWN)
1654 retCode = readDataHelper(false, cred, DataType::DB_KEY_FIRST,
1655 publicKeyOrCertName, owner, password, obj);
1657 if (retCode == CKM_API_SUCCESS)
1658 retCode = obj->verify(params, message, signature);
1664 int CKMLogic::setPermissionHelper(
1665 const Credentials &cred, // who's the client
1667 const ClientId &owner, // who's the owner
1668 const ClientId &accessor, // who will get the access
1669 const PermissionMask permissionMask)
1671 auto &handler = selectDatabase(cred, owner);
1673 // we don't know the client
1674 if (cred.client.empty() || !isClientValid(cred.client))
1675 return CKM_API_ERROR_INPUT_PARAM;
1677 // verify name and owner are correct
1678 if (!isNameValid(name) || !isClientValid(owner) ||
1679 !isClientValid(accessor))
1680 return CKM_API_ERROR_INPUT_PARAM;
1682 // currently we don't support modification of owner's permissions to his own rows
1683 if (owner == accessor)
1684 return CKM_API_ERROR_INPUT_PARAM;
1686 // system database does not support write/remove permissions
1687 if ((0 == owner.compare(CLIENT_ID_SYSTEM)) &&
1688 (permissionMask & Permission::REMOVE))
1689 return CKM_API_ERROR_INPUT_PARAM;
1691 // can the client modify permissions to owner's row?
1692 int retCode = m_accessControl.canModify(cred, owner);
1694 if (retCode != CKM_API_SUCCESS)
1697 DB::Crypto::Transaction transaction(&handler.database);
1699 if (!handler.database.isNameOwnerPresent(name, owner))
1700 return CKM_API_ERROR_DB_ALIAS_UNKNOWN;
1702 // set permissions to the row owned by owner for accessor
1703 handler.database.setPermission(name, owner, accessor, permissionMask);
1704 transaction.commit();
1706 return CKM_API_SUCCESS;
1709 RawBuffer CKMLogic::setPermission(
1710 const Credentials &cred,
1713 const ClientId &owner,
1714 const ClientId &accessor,
1715 const PermissionMask permissionMask)
1717 return SerializeMessage(msgID, tryRet([&] {
1718 return setPermissionHelper(cred, name, owner, accessor, permissionMask);