X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=htdocs%2Fdocs%2Fsignup.html;fp=htdocs%2Fdocs%2Fsignup.html;h=0000000000000000000000000000000000000000;hp=a40b1f9631868d3cb271a08b9030a620595a3183;hb=1d758388ce3b17b8de1ae1d3a8ec39c1026baefc;hpb=e6cf4af2b9d3ffefebe1a3e358f0674f566b56bc diff --git a/htdocs/docs/signup.html b/htdocs/docs/signup.html deleted file mode 100644 index a40b1f963..000000000 --- a/htdocs/docs/signup.html +++ /dev/null @@ -1,57 +0,0 @@ - - Signup server - - -

Signup server

-For security reasons, the signup server should run on an external public -webserver. On this machine, install: -

A web server, such as Apache-SSL or Apache -
SSH -
Perl (at least 5.004_05 for the 5.004 series or 5.005_03 for the 5.005 series. Don't enable experimental features like threads or the PerlIO abstraction layer.) -
Text::Template -
HTTP::Headers::UserAgent (version 2.0 or higher; not yet indexed correctly on CPAN) - -
FS::SignupClient (copy the fs_signup/FS-SignupClient directory to the external machine, then: perl Makefile.PL; make; make install) -

-Then: -

Add the user `freeside' to the the external machine. -
Copy or symlink fs_signup/FS-SignupClient/cgi/signup.cgi into the web server's document space. -
Enable CGI execution for files with the `.cgi' extension. (with Apache) -
Create the /usr/local/freeside directory on the external machine (owned by the freeside user). -
touch /usr/local/freeside/fs_signupd_socket; chown freeside /usr/local/freeside/fs_signupd_socket; chmod 600 /usr/local/freeside/fs_signupd_socket -
Use suEXEC or setuid (see install.html for details) to run signup.cgi as the freeside user. -
Append the identity.pub from the freeside user on your freeside machine to the authorized_keys file of the newly created freeside user on the external machine(s). -
Run
```
fs_signup_server user machine agentnum refnum
```
on the Freeside machine. -
- user is a user from the mapsecrets file. -
- machine is the name of the external machine. -
- agentnum and refnum are the agent and referral, respectively, to use for customers who sign up via this signup server. -
-

-Optional: -

If you create a /usr/local/freeside/ieak.template file on the external machine, it will be sent to IE users with MIME type application/x-Internet-signup. This file will be processed with Text::Template with the following variables available: -
- $ac - area code of selected POP -
- $exch - exchange of selected POP -
- $loc - local part of selected POP -
- $username -
- $password -
- $email_name - first and last name -
- (an example file is included as fs_signup/ieak.template) -
If you create a /usr/local/freeside/cck.template file on the external machine, the variables defined will be sent to Netscape users with MIME type application/x-netscape-autoconfigure-dialer-v2. This file will be processed with Text::Template with the following variables available: -
- $ac - area code of selected POP -
- $exch - exchange of selected POP -
- $loc - local part of selected POP -
- $username -
- $password -
- $email_name - first and last name -
- (an example file is included as fs_signup/cck.template). See the Netscape documentation for more information. -
If there are any entries in the prepay_credit table, a user can enter a string matching the identifier column to receive the credit specified in the amount column, and/or the time specified in the seconds column (for use with the session monitor), after which that identifier is no longer valid. This can be used to implement pre-paid "calling card" type signups. The bin/generate-prepay script can be used to populate the prepay_credit table. -