From c2e9ca0ddbdcd3588f94c8c550120c73c0844bb1 Mon Sep 17 00:00:00 2001 From: ivan Date: Fri, 28 Jan 2000 22:51:17 +0000 Subject: add signup server documentation, track full phone number --- htdocs/docs/signup.html | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 htdocs/docs/signup.html (limited to 'htdocs/docs/signup.html') diff --git a/htdocs/docs/signup.html b/htdocs/docs/signup.html new file mode 100644 index 000000000..a00995994 --- /dev/null +++ b/htdocs/docs/signup.html @@ -0,0 +1,46 @@ + + 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) +

+ -- cgit v1.2.1