ReadMe File for BizDB Password Retrieval Facility
##################################################################
#
# BizDB - Password Retrieval Facility
#
# IMPORTANT: This Password Retrieval Facility is an add-on feature
# of our BizDB software. You must not use this feature alone.
# Please make sure you have our BizDB software running on your server
# before installing this software.
#
##################################################################
#
# Demonstration Website: http://www.cnctek.com/bizdb-html/
# E-mail: cnctek@cnctek.com
#
# MINIMUM SERVER REQUIREMENTS:
#
# Runs on a Unix Operating System; Provides FTP;
# Supports Perl and cgi-bin; Allows creation of files and
# directories by cgi programs.
#
# *************************************************************
# ORDER OF THIS SOFTWARE IS NOT REFUNDABLE. WE ARE GLAD TO
# PROVIDE TECHNICAL ASSISTANCE AT REASONABLE COST.
# *************************************************************
#
# COPYRIGHT NOTICE
# The BizDB software is a product of CNC Technology. All rights reserved.
# Only the user with our permission can use and modify this software.
# Also permission is granted to execute this software on one domain name
# only. Without CNC Technology's permission, no part of this script can be
# reproduced ( other than the backup copy ), resold or redistributed to
# any other indivituals, companies and organizations.
#
# DISCLAIMER:
#
# These Scripts are provided on a "As Is" basis. CNC Technology
# will not be liable ( nor responsible ) whatsoever for any direct
# or indirect damages caused by the use of this Software
# ( or Scripts ).
#
##################################################################
Please read the following paragraphs carefully. This is essential
if you want to have a smooth and successful installation.
When you read this file, we know that you have successfully
decompressed our ZIP file using a 32 bits WinZip (or equivalent)
program.
##################################################################
TABLE OF CONTENTS:
A. Contents in our ZIP file
B. System Configuration Parameters
C. Webpage Interface
D. Installation Procedures
##################################################################
A. Contents in our ZIP file
You should have at least the following files for a standard version
of our system:
(1) lostpwd.cgi - CGI script used for retrieving the lost
Password for each Record ID.
(2) lostpwd.html - The sample Password Retrieval Webpage
interface.
(3) ReadMe.txt - It's this document.
If you have used our development assistance, we will include more files
to meet your specific needs. This will be mentioned in a separate document
or e-mails.
B. System Configuration Parameters:
You will have to modify a number of System Configurations Parameters
in the Scripts before you can upload them to your CGI-BIN directory.
These parameters are CGI script specific, therefore you should read
our following sections or the notes on our scripts very carefully.
Parameter Name Where Description
(1) $maxfields lostpwd.cgi Maximum number of DB Fields.
(2) $database_dir lostpwd.cgi Full pathname of the directory
in which your database is
stored.
(3) @dbname_fns lostpwd.cgi This array defines all the database
filenames used in your BizDB database
system. Ex1: @dbname=('file1');
Ex2: @dbname=('file1','file2','file3');
(4) $return_url lostpwd.cgi Return URL link used by OK and
error messages.
(5) @valid lostpwd.cgi These are the urls (separated
by comma) that are allowed to
execute this database system.
This prevents any of our
programs to be accessed by
unauthorized Websites.
(6) $mailprog lostpwd.cgi Location of "sendmail" program.
You need "sendmail" to send
"Password Notification" e-mail
back to the requestor.
(7) $webmaster lostpwd.cgi Webmaster e-mail address. This
be in the form of:
username\@domain.name
Note: There is a "\" character
before the "@".
(8) $company_name lostpwd.cgi A short text to identify yourself
or your Company. This text will
be displayed at the bottom of the
"Password Notification" e-mail.
(9) $delimitor lostpwd.cgi Field delimitor.
Your setting must match with that
used in your bizdb-aed.cgi.
(10) $uid_pwd_sep lostpwd.cgi Used in field-1 (f1) for
separating the UserID(RecordID)
and password.
Your setting must match with that
used in your bizdb-aed.cgi.
(11) $charset lostpwd.cgi Define the character set to
be used by your database software
and Html templates. This is required
for supporting foreign languages.
See BizDB documentation.
C. Webpage Interface:
"lostpwd.html" is the only Webpage interface used by the user to raise the
"Password Retrieval" request.
The "Password Retrieval" request form in "lostpwd.html" must contain the
following statements:
Example 1:
This allows the user to retrieve the password of a specified record id.
The retrieved password and the record id will be e-mailed to the e-mail
address registered in the retrieved record.
Example 2:
This allows the user to retrieve the password of a specified record id as
well as the passwords of all records registered by him if the "record_id"
field is left blank. In this example we have used a more secured approach
to ensure that the record ids and passwords are not e-mailed to
unauthorized users. The entered e-mail address (compulsory) is used to
check against the e-mail address registered in the retrieved record. If the
2 e-mail addresses do not match each other, the retrieval request is rejected.
NOTE: (1) You have to adjust the