From 701b161a5fb5356a32c765ea83202b003e9a99f1 Mon Sep 17 00:00:00 2001 From: ivan Date: Tue, 26 Oct 2004 12:33:39 +0000 Subject: slightly more up-to-date docs --- httemplate/docs/selfservice.html | 60 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 httemplate/docs/selfservice.html (limited to 'httemplate/docs/selfservice.html') diff --git a/httemplate/docs/selfservice.html b/httemplate/docs/selfservice.html new file mode 100644 index 000000000..a4dc6aa78 --- /dev/null +++ b/httemplate/docs/selfservice.html @@ -0,0 +1,60 @@ + + Signup, self-service and reseller interfaces + + +

Signup, self-service and reseller interfaces

+For security reasons, the self-service interface should run on a public +machine, not the backend Freeside server. On the public machine, install: +

A web server, such as Apache (mod_ssl or Apache-SSL highly recommended) + +
SSH +
Perl. +
Text::Template +
Storable +
Business-CreditCard +
HTTP::BrowserDetect + +
FS::SelfService (copy the fs_selfservice/FS-SelfService directory to the external machine, then: perl Makefile.PL; make; make install) +
FS::SignupClient (copy the fs_signup/FS-SignupClient directory to the external machine, then: perl Makefile.PL; make; make install) +

+Then: +

Set the signup_server-default_agentnum configuration value to a default agent number. +
Set the signup_server-default_refnum to a default advertising source. +
Add the user `freeside' to the the external machine. +
Copy or symlink the
```
fs_signup/FS-SelfService/cgi/
```
directory into the web server's document space, for customer self-service and reseller access. Optionally, customize the .html templates. +
Copy or symlink the
```
fs_signup/FS-SignupClient/cgi/
```
directory into the web server's document space, for signups. Optionally, customize the .html templates. +
When linking to signup.cgi, you can include a referring custnum in the URL as follows: http://public.web.server/path/signup.cgi?ref=1542 +
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, selfservice.cgi, agent.cgi and passwd.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 an instance of
```
freeside-selfservice-server user machine agentnum refnum
```
on the Freeside machine for each external machine. +
- user is a user from the mapsecrets file. +
- machine is the name of the external machine. + + +
+

+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 variables listed below available. + (an example file is included as fs_signup/ieak.template) See the section on internet settings files in the IEAK documentation for more information. + +
Variable substitutions available in ieak.template and success.html: +
- $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 +
- $pkg - package name +
+ + +

+ -- cgit v1.2.1