This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,7 @@
# Change to "yes" to run the service.
RUN_DAEMON="no"
# Uncomment this to log potentially sensitive information from your users.
# This may be useful for debugging or diagnosing functional problems, but
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,11 @@
# Change to "yes" to run the service.
RUN_DAEMON="no"
# Uncomment this to log potentially sensitive information from your users.
# This may be useful for debugging or diagnosing functional problems, but
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -1,31 +1,33 @@
These are instructions for how to set up a Google App Engine application
to run at appspot.com.
for the appspot rendezvous method (flashproxy-reg-appspot). It requires
the HTTP rendezvous to be available, so you should set that up first and
ensure it is working correctly, or find someone else's to use. If you
choose the latter, note that it is *their* reg-daemon.pub that your users
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -1,6 +1,21 @@
These are instructions for setting up a Gmail account for use with the
email-based rendezvous and flashproxy-reg-email. These instructions were
current as of May 2013.
These are instructions for setting up an email account for use with the
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,44 @@
The main facilitator program is a backend server that is essentially a
dynamic database of client addresses, as well as helper programs that
receive client registrations from the Internet over various means and
pass them to the backend. There are three supported helper rendezvous
methods: HTTP, email, and appspot.
facilitator-reg is a simple program that forwards its standard input to
a locally running facilitator-reg-daemon process. It is not used by the
other components, but is useful for debugging and test purposes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,49 @@
These are instructions for how to set up an Apache Web Server for
handling the HTTP client registration method (facilitator.cgi /
flashproxy-reg-http / flashproxy-reg-url), as well as for browser
proxies to poll and receive a client to serve.
Unfortunately we only had time to give commands specific to the Debian
distribution of Apache; other distributions may need to tweak some
things, e.g. a2enmod, a2ensite only exist on Debian.
== HTTP server setup
Apache is the web server that runs the CGI program.
# apt-get install apache2 libapache2-mod-evasive
# a2enmod ssl headers
Edit /etc/apache2/ports.conf and comment out the port 80 configuration.
# NameVirtualHost *:80
# Listen 80
Copy examples/fp-facilitator.conf to /etc/apache2/sites-available/ or
wherever is appropriate for your Apache2 installation, then edit it as
per the instructions given in that file itself.
Link the configured site into sites-enabled.
# a2ensite fp-facilitator
=== HTTPS setup
The HTTP server should serve only over HTTPS and not unencrypted HTTP.
You will need a certificate and private key from a certificate
authority. An article on making a certificate signing request and
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,55 @@
This document describes how to configure a server running the facilitator on
Debian 7. It is not necessary to make things work, but gives you some added
security, and is a good reference if you want to create a dedicated VM for a
facilitator from scratch.
We will use the domain name fp-facilitator.example.com.
== Basic and security setup
Install some essential packages and configure a firewall.
# cat >/etc/apt/apt.conf.d/90suggests<<EOF
APT::Install-Recommends "0";
APT::Install-Suggests "0";
EOF
# apt-get remove portmap
# apt-get update
# apt-get upgrade
# apt-get install shorewall shorewall6
Away from the facilitator, generate an SSH key for authentication:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,28 @@
# This is an example apache2 config for serving the facilitator.
#
# For instructions on how to install it, see doc/http-howto.txt. You
# should also edit the contents according to the instructions below.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
@@ -0,0 +1,10 @@
# This file should contain "[<imap_host>] <email> <password>" on a single line,
# separated by whitespace. If <imap_host> is omitted, it defaults to
# imap.(<email> domain):993.
#
# If your email provider supports it, we advise you to use an app-specific
# password rather than your account password; see email-howto.txt in this
# package's documentation for details on how to do this.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters