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