M1. Administrators

Administrator logged in

Called when administrator successfully authenticated in the Security Control Center.

Database

Parameters

Returned value

available

•login — login name of administrator

•address — network address from which administrator is logged in

•subsys — Dr.Web Server subsystem (see the adm-subsys.ds file

•id — administrator’s ID

•authorizer — authorization module name (database, LDAP, AD)

•language — language code of administrative account

•date_format — date format of administrative account

ignored

Procedure text:

--[[

Called:

 when Administrator authorize successfully

 

Database:

 available

 

Parameters:

 login              Administrator`s login name

 address            Administrator`s network address

 subsys             Server subsystem (see adm-subsys.ds)

 id                 Administrator`s ID

 authorizer         Authorizer name (database, LDAP, AD)

 language           Administrator`s language code

 date_format        Administrator`s date format

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.login, args.address, args.subsys, args.error, args.id, args.authorizer,

                -- args.language, args.date_format

Administrator logged in using Microsoft Active Directory Service

Called when external administrator successfully authorized using Microsoft Active Directory Service.

Database

Parameters

Returned value

available

•login — login name of administrator

•address — network address administrator used to log in from

•is_secure — administrator uses HTTPS connection (true | false)

•name — administrator's LDAP name

•DN — administrator's LDAP distinguished name

•SID — administrator's Windows security identifier

•GUID — administrator's GUID

•primary_group — administrator's primary group name

•primary_group_DN — administrator's primary group LDAP distinguished name

•primary_group_SID — administrator's primary group SID

•primary_group_GUID — administrator's primary group GUID

•groups — table containing administrator's group names (member of MSAD attribute)

•groups_DN — table containing administrator's group distinguished names (in the same order as groups)

•groups_SID — table containing administrator's group SIDs (in the same order as groups)

•groups_GUID — table containing administrator's group GUIDs (in the same order as groups)

•nil — do nothing

•string empty — do nothing

•not-empty — set administrator group to this string (group ID)

Procedure text:

--[[

Called:

 when the external administrator was authorized successfully using Microsoft Active Directory Service

 

Database:

 available

 

Parameters:

 login              Administrator's login name

 address            Administrator's network address

 is_secure          Is true if administrator uses HTTPS connection

 name               Administrator's LDAP name

 DN                 Administrator's LDAP distinguished name

 SID                Administrator's Windows security identifier

 GUID               Administrator's GUID

 primary_group      Administrator's primary group name

 primary_group_DN   Administrator's primary group LDAP distinguished name

 primary_group_SID  Administrator's primary group SID

 primary_group_GUID Administrator's primary group GUID

 groups             Table containg Administrator's group names (memberOf MSAD attribute)

 groups_DN          Table containg Administrator's group distinguished names (in the same order as groups)

 groups_SID         Table containg Administrator's group SIDs (in the same order as groups)

 groups_GUID        Table containg Administrator's group GUIDs (in the same order as groups)

 

Returned value:

            nil        do nothing

 string     empty      do nothing

            not-empty  set administrator group to this string (group ID)

 

]]

 

local args = ... -- args.is_secure, args.login, args.address,

                -- args.name, args.DN, args.SID, args.GUID,

                -- args.primary_group, args.primary_group_DN, args.primary_group_SID, args.primary_group_GUID,

                -- args.groups, args.groups_DN, args.groups_SID, args.groups_GUID

Administrator not logged in

Called when administrator failed to authenticate in the Security Control Center.

Database

Parameters

Returned value

available

•login — login name of administrator

•address — administrator’s network address

•subsys — Dr.Web Server subsystem (see the adm-subsys.ds file)

•error — error code (see the auth-error.ds file)

ignored

Procedure text:

--[[

Called:

 when Administrator authorization failed

 

Database:

 available

 

Parameters:

 login              Administrator`s login name

 address            Administrator`s network address

 subsys             Server subsystem (see adm-subsys.ds)

 error              Error code (see auth-error.ds)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.login, args.address, args.subsys, args.error