It is not required to be XML, that was just used as an example of a format you might easily be able to parse. This file must exist in the surgemail web directory. The show field is used to select the output page.The new users name and password are supplied in the lusername and lpassword fields.The user_fields field specifies the names of the fields containing user information to add.The username and password fields, these should contain the username and password of a domain admin user.Set contents of a file in the users mdir folder ĭelete a file from the users mdir folder: įor responses you can setup an xml file, something like this: simple_msg.xml contains (this is placed in the surgemail/web folder) Fields normally set to type Hidden to tell it what to do. You may need to add the begin/end list to simple_msg.xml template e.g.Ī form to Modify/Save changes to a user: Įxample to create a domain (note this uses manager port): This can also be done using a simple http query with the same fields, form to ‘delete’ a user: įields normally set to type Hidden to tell it what to do. Fieldsd normally set to type Hidden to tell it what to do. The following mechanisms use modified versions of the manager templates/interface to perform manager operations, for these a domain manager username/password is used. POST /cgi/admin.cgi?cmd=ini_set&domain=.nz&setting=host_alias HTTP/1.1Ĭontent-Length: 54 host_alias "" POST /cgi/admin.cgi?cmd=ini_set&setting=SETTING_NAME&domain=DOMAIN.NAME HTTP/1.1Į.g. Use a request like this to get any setting, requests must be either to the local host or fully authenticated use basic html authentication. Surgemail.ini file API (7.3p29 and later) a_info could be set to: phone=”123456″įor ‘nwauth_mod’ The password will not be changed if the a_pass field is left blank, otherwise it will be changed. The nwauth_mod option requires 7.3d-14 allows you to set specific fields, and all other fields are automatically retained. This can be used to remove spam settings. The mdir_delete function is for deleting a single file from the users mdir folder, the additional paramter ‘fname’ should be passed. Here is a sample web page to test this with:Īction: or nwauth_set nwauth_mod nwauth_del nwauth_search or mdir_delete The field ‘a_info’ is formatted like the raw authent module data, field=”value” … quota=”20mb” The action can be any of: nwauth_lookup, nwauth_set, nwauth_search, nwauth_del and mdir_del While testing your web browser will prompt you for the user/password. For these functions you must have the web admin user/password and send it using the normal http basic authentication method. This group of forms provide simple access to the authent module functions directly, this can be used to add/del/modify/search user accounts. Many programming languages have a mechanism for easily sending web ‘forms’ from a program so will find this quite easy in some cases. To use from a program you need to send the form as an http POST using tcpip. To use the following examples to experiment with save them as htm files and open them in your browser. However you should also consider the other two methods available to interface with accounts, which method you choose will depend on your precise needs.ġ) the authent module can be talked to directly using the authent protocol h ttps:///authentĢ) if the authent module is using a back end database (ldap, sql, etc…) then the backend database can be used directly. For example here is a simple HTTP form which will add a user. If you want to provide some or all of these options elsewhere you can do so by interfacing with it using these HTTP commands. The user management system is an HTTP based system using GET and POST commands to perform actions. To remove accounts you will need to edit and manually remove entries from admin.dat Interfacing with the user management system, HTTP/API options. You can create additional system admin accounts for surgemail using the command: and have access to this users page for all the domains they manage. This will display a page that allows you to lookup, create, modify and search for users. Once you have looked up an existing user you can change a user’s password, edit any of the user’s information including forwarding or delete them.ĭomain administrators, configured by the manager_username setting, log in to the user self management interface: User administration is done via the “User accounts” option in the web admin contents. There are several different methods, the method being used is specified per domain using the domain setting create user. Users can optionally create or sign-up for accounts via the web interface on the user port ie: Account Creation – Web Interface Account Creation – User Self Creation
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |