mng.GetUserAttributes

This job delivers the properties of the specified user.

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Currently not supported — pass 0.

OutputUnicode

INT

Yes

Must be passed as 1.

User

STRING

Yes

Username (DB field benutzer.benutzer), not a GUID

User takes the username only (measured on two installations of enaio® 12.0 and on 10.10):

  • A user GUID in User returns -1040908085 (User not found. Requested user name: <value>), just like an unknown username.

  • The job has no UserGUID parameter. A call with UserGUID and without User is rejected with -1043332470 (A required parameter was not specified: User.).

  • If User is passed as INT, the parameter validation rejects the call with -1043332106 (tested on 12.0 only).

2. Output Parameters

Name Type Dependency Description

utfXmlInfo

BASE64

—

User information in XML format (see below).

3. Structure of utfXmlInfo

<AdmInfo>
  <Users>
    <User account_type="0" bemerkung="9f73fbbd-c994-4e94-9e8a-9c3da7ca9f19" benutzer="ROOT" changepwd="0" flags="1" geaendert="0" id="2" langid="0" locked="0" logincount="0" loginname="ROOT" loginstation="" logintime="1774479216" mfauthflag="0" name="Administrator" never_expire="0" osemail="admin@ecmind.ch" osguid="35100CD4D441420B90811DC90766D64F" profil="-1" pwd_changed="1" server_id="0" station="" supervisor="-1" validfrom="" validto=""/>
  </Users>
</AdmInfo>
Attribute Type Description

account_type

INT

Login type: 0 = user login; 1 = application server; 2 = ANONYMOUS; 3 = application server (e.g., Java server)

bemerkung

STRING

Comment from user configuration

benutzer

STRING

Username

changepwd

INT

1 = user must change password on next login, otherwise 0

loginname

STRING

Login name

flags

INT

0 = normal user; 1 = server or ANONYMOUS

geaendert

INT

0 = profile not changed; 1 = profile was changed

id

INT

ID of the user

langid

INT

ID of the language of the object definition (empty = German)

locked

INT

0 = not locked; 1 = locked by an administrator; 2 = locked by failed logins (see Lockout Behaviour)

logincount

INT

Number of consecutive failed login attempts — not of successful logins. A successful login resets the value to 0; once the threshold is reached it does not grow further.

loginstation

STRING

Name of the last login station

logintime

INT

Login timestamp

mfauthflag

INT

Multi-factor authentication flag

name

STRING

Full name of the user

osemail

STRING

User’s email

osguid

STRING

GUID of the user

passwort

STRING

Encrypted password of the user

never_expire

INT

1 = password never expires, otherwise 0

profil

INT

-1 = no profile; 0 = user profile; >0 = ID of assigned profile

pwd_changed

INT

Timestamp of the last password change (Unix timestamp); 0 = password has never been changed

server_id

INT

ID of the server

station

STRING

Name of the user’s workstation

supervisor

INT

-1 = supervisor, otherwise 0

validfrom

STRING

User account valid from. Format: YYYY/MM/DD HH:MM:SS. Empty = no restriction.

validto

STRING

User account valid to. Format: YYYY/MM/DD HH:MM:SS. Empty = no restriction.

4. Return Value

(INT): 0 = Job successful, otherwise error code.

5. See Also

mng.SetUserAttributes