CreateUser
Synopsis
[Actions] CreateUser:Name=UserName,PasswordHash="PasswordHashDetails",Roles="RolesList"[,Additional Properties]
Description
CreateUser defines a user account. InterSystems IRIS® creates that user account when processing the [Actions] section during a configuration merge.
The CreateUser action accepts any of the user account properties which are listed as parameters in the class reference for the Security.Users.Create()Opens in a new tab method, except Password. Instead, CreateUser accepts a comma-delimited PasswordHash string which contains the hashed password, a salt, and (optionally) the hash function’s work factor and algorithm.
Because generating hash values manually is time-consuming and error-prone, InterSystems recommends using the passwordhash nanocontainer to generate the PasswordHash string. InterSystems provides this nanocontainer through the InterSystems Container RegistryOpens in a new tab.
The configuration merge documentation’s section about creating, modifying and deleting security objects provides an example of how to use the CreateUser action.
Changing This Operation
This operation is designed to be used during a configuration merge. You can change CreateUser by editing the merge file in a text editor (as described in Editing the Active CPF).
For information about creating user accounts from the Management Portal, see Create a New User Account.
