From 51984ac3d3da3006809c6866fdecd4ad83610731 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 30 Jul 2001 07:36:04 +0000 Subject: templates!!! --- httemplate/docs/signup.html | 57 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 httemplate/docs/signup.html (limited to 'httemplate/docs/signup.html') diff --git a/httemplate/docs/signup.html b/httemplate/docs/signup.html new file mode 100644 index 000000000..a40b1f963 --- /dev/null +++ b/httemplate/docs/signup.html @@ -0,0 +1,57 @@ + + 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. +

+ -- cgit v1.2.1