Creating a User (CreateUser and CreateUserEx)

Use the ICISite interface CreateUser method or the CreateUserEx method to create a new user on a site. The CreateUser method creates users with the default values. The CreateUserEx method allows you to set values for all parameters.

Signature:

HRESULT CreateUser(

[in] BSTR bstrLogin,

[in] BSTR bstrPwd,

[in] int nPwdType,

[in] BSTR bstrDescription);

 

HRESULT CreateUserEx(

[in] BSTR bstrLogin,

[in] BSTR bstrPwd,

[in] int nPwdType,

[in] BSTR bstrDescription,

[in] BSTR bstrFullName,

[in] VARIANT_BOOL bCreateHomeFolder,

[in] VARIANT_BOOL bFullPermissionsForHomeFolder,

[in, optional] BSTR bstrSettingsLevel);

The CreateUser[Ex] method will fail if a simple password is provided and enforce complex passwords is enabled in EFT Server. For example, the following will fail if enforce complex passwords is enabled in EFT Server:

oSite.CreateUser "tuser1", "testpassword", 0 "New User"

For the method to work, you must do one of the following:

  • Disable enforcement of complex passwords.

  • Provide a complex password. For example:

oSite.CreateUser "test", "$1$Bn3YdWKv$.BS3Qb2UQTV4SmV1JNN.w/", 0, "New User"

  • Call the CreateComplexPassword method and use the resulting string in the CreateUser[Ex] method. For example (in pseudo code):

strUserPass = oUserSettings.CreateComplexPassword()

oSite.CreateUser "test", strUserPass, 0, "New User"

Parameters Table

Parameter

Input

bstrLogin

User name

bstrPwd

User password

nPwdType

Password type (see Password Table)

bstrDescription

Description of user

bstrFullName

User's full name

bCreateHomeFolder

TRUE if user home folder should be created and assigned

bFullPermissionsForHomeFolder

TRUE if the user should have administrator rights for their home folder

bstrSettingsLevel

User's settings level name or ID.

Password Table

Value

Password type

0

Regular (hashed)

1

Anonymous (regular with empty password)

2

Anonymous (require email as password)

3

OTP-MD4

4

OTP-MD5

5

Literal (no hash) -  For use when importing shadow passwords from a *nix password file. The format must follow: $1$*$*
For example, user: test, password: test would be:

site.ChangeUserPassword "test", "$1$Bn3YdWKv$.BS3Qb2UQTV4SmV1JNN.w/", 5

 

DES-format passwords are not supported. These are password formats without the salt defined, that is, without the $1$.