CRecordUserDbChangePassword
Change the password of a user in the user database.
This message belongs to the session manager API.
{ "id": "806fcf09-e60c-462f-ba50-3e99c579e74f", "name": "USER_DB_CHANGE_PASSWORD", "description": "Change a password.", "slots": [ { "key": "user", "name": "USER_ID", "direction": "REQUEST", "mandatory": "true", "type": "STRING", "description": "The id of the user." }, { "key": "currPw", "name": "CURRENT_PASSWORD", "direction": "REQUEST", "mandatory": "true", "type": "STRING", "description": "The hashed (SHA384) and base64 encoded current password." }, { "key": "newPw", "name": "NEW_PASSWORD", "direction": "REQUEST", "mandatory": "true", "type": "STRING", "description": "The hashed (SHA384) and base64 encoded new password." } ] }
Example of use of the class CRecordUserDbChangePassword (after generating)
You need the microservice ID of the session manager:
public static final IId SESSION_MICROSERVICE_ID = CIdFactory.fromObject("ccf168c1-f18b-4229-85f9-24461a19ee6a");
In addition to the user ID, the hash of the current password and that of the new password are required. Both SHA384 hashes must be base64 encoded. You can use a utility method of the kernel: CUtilPassword.hashPassword().
private void changePassword(@NotNull final String aUserId, final char[] aCurrentPassword, final char[] aNewPassword) throws CException { final String currentPasswordHash = CUtilPassword.hashPassword(aCurrentPassword); final String newPasswordHash = CUtilPassword.hashPassword(aNewPassword); final CEnvelope env = CEnvelope.forMicroService(SESSION_MICROSERVICE_ID); final CRecord record = CRecordUserDbChangePassword.create(); CRecordUserDbChangePassword.setUserId(record, aUserId); CRecordUserDbChangePassword.setCurrentPassword(record, currentPasswordHash); CRecordUserDbChangePassword.setNewPassword(record, newPasswordHash); sendRequest(env, record); }
To catch the response of the request, we need a message handler. We add it in the constructor of the message handler registry.
// constructor: addMessageHandler(CRecordUserDbChangePassword.ID, this::asyncChangePassword);
private boolean asyncChangePassword(@NotNull final CEnvelope aEnvelope, @NotNull final CRecord aRecord) { if (aEnvelope.isAnswer()) { final int resultCode = aEnvelope.getResultCode(); if (resultCode == CResultCode.SUCCESS) { // ... } return true; } return false; }