Skip to content

Commit

Permalink
Add new version of web pages
Browse files Browse the repository at this point in the history
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
  • Loading branch information
David Woodhouse authored and David Woodhouse committed Sep 27, 2011
1 parent 8819208 commit 2fdf095
Show file tree
Hide file tree
Showing 37 changed files with 3,130 additions and 0 deletions.
2 changes: 2 additions & 0 deletions www/.gitignore
@@ -0,0 +1,2 @@
*.html
openconnect.8.inc
23 changes: 23 additions & 0 deletions www/Makefile
@@ -0,0 +1,23 @@
#
CONV = "./html.py"

FTR_PAGES := csd.html features.html gui.html nonroot.html
START_PAGES := building.html connecting.html manual.html started.html vpnc-script.html
MAIN_PAGES := changelog.html download.html index.html packages.html platforms.html
TARGETS = $(FTR_PAGES) $(START_PAGES) $(MAIN_PAGES)

all: $(TARGETS)

$(TARGETS): %.html: %.xml inc/*.tmpl menu1.xml
$(CONV) -f $< || (rm $@; exit 1)

clean:
rm -f $(TARGETS) openconnect.8.inc

$(FTR_PAGES): menu2-features.xml
$(START_PAGES): menu2-started.xml
$(MAIN_PAGES): menu2.xml

manual.html: openconnect.8.inc
openconnect.8.inc: ../openconnect.8
groff -t -K UTF-8 -mandoc -Txhtml $^ | sed -e '1,/<body>/d' -e '/<\/body>/,$$d' > $@
67 changes: 67 additions & 0 deletions www/building.xml
@@ -0,0 +1,67 @@
<PAGE>
<VAR match="VAR_ORIGIN" replace="" />
<VAR match="VAR_CVSID" replace=""/>
<INCLUDE file="inc/header.tmpl" />

<VAR match="VAR_SEL_STARTED" replace="selected" />
<VAR match="VAR_SEL_BUILDING" replace="selected" />
<PARSE file="menu1.xml" />
<PARSE file="menu2-started.xml" />

<INCLUDE file="inc/content.tmpl" />

<h1>Building OpenConnect</h1>

<p>Unless you need to test the very latest version, you should not
need to build OpenConnect for yourself. Your operating system should
have a <a href="packages.html">prepackaged</a> version which you can
install; if it does not then file a bug or enhancement request asking for
one.</p>

<h2>Requirements</h2>
<p>To build OpenConnect from its source code, you will need the following
libraries and tools installed:</p>

<ul>
<li><b><tt>libxml2</tt></b></li>
<li><b><tt>zlib</tt></b></li>
<li><b><tt>OpenSSL</tt></b></li>
<li><b><tt>pkg-config</tt></b></li>
</ul>
And <em>optionally</em> also:
<ul>
<li><b><a href="http://code.google.com/p/libproxy/">libproxy</a></b></li>
</ul>
<p>OpenConnect supports the use of HTTP and SOCKS proxies to connect to the
AnyConnect service, even without using libproxy. You may wish to use libproxy
if you want OpenConnect to automatically use the appropriate proxies for your
environment, without having to manually give it the <tt>--proxy</tt> argument
on the command line.</p>

<h2>Building OpenConnect</h2>

<p>If you checked the source code out from git rather from a release tarball
then run this command first to prepare the build system:</p>
<ul>
<li><tt>./autogen.sh</tt></li>
</ul>
<p>Then to build it, run the following commands:</p>
<ul>
<li><tt>./configure</tt></li>
<li><tt>make</tt></li>
<li><tt>make install</tt> <i>(If you want to install it)</i></li>
</ul>

<p>If compilation fails, please make sure you have a working compiler and the
<b>development</b> packages for all the required libraries mentioned above. If
it still doesn't build, please send the full output in a plain-text mail to the
<a href="mail.html">mailing list</a>.</p>

<h2>TUN/TAP driver</h2>

<p>Mac OS X users will also need to install the
<a href="http://tuntaposx.sourceforge.net/">Mac OS X tun/tap driver</a>, and Solaris users will need the <a href="http://www.whiteboard.ne.jp/~admin2/tuntap/">Solaris one</a>. Note that for IPv6 support, the Solaris tun/tap driver from 16th Nov 2009 or newer is required.</p>

<INCLUDE file="inc/footer.tmpl" />
</PAGE>

232 changes: 232 additions & 0 deletions www/changelog.xml
@@ -0,0 +1,232 @@
<PAGE>
<VAR match="VAR_ORIGIN" replace="" />
<VAR match="VAR_CVSID" replace=""/>
<INCLUDE file="inc/header.tmpl" />

<VAR match="VAR_SEL_INDEX" replace="selected" />
<VAR match="VAR_SEL_CHANGELOG" replace="selected" />
<PARSE file="menu1.xml" />
<PARSE file="menu2.xml" />

<INCLUDE file="inc/content.tmpl" />

<h1>Changelog</h1>

<p>For full changelog entries including the latest development, see
<a href="http://git.infradead.org/users/dwmw2/openconnect.git">gitweb</a>.</p>
<ul>
<li><b>OpenConnect HEAD</b>
<ul>
<li>Add localisation support.</li>
<li>Fix build on Debian systems where <tt>dtls1_stop_timer()</tt> is not available.</li>
<li>Fix libproxy detection.</li>
<li>Enable a useful set of compiler warnings by default.</li>
<li>Fix various minor compiler warnings.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-3.12.tar.gz">OpenConnect v3.12</a></b> &#8212; 2011-09-12
<ul>
<li>Fix DTLS compatibility with ASA firmware 8.4.1(11) and above.</li>
<li>Fix build failures on GNU Hurd, on systems with ancient OpenSSL,
and on Debian.</li>
<li>Add <tt>--pid-file</tt> option.</li>
<li>Print SHA1 fingerprint with server certificate details.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-3.11.tar.gz">OpenConnect v3.11</a></b> &#8212; 2011-07-20
<ul>
<li>Add <tt>Android.mk</tt> file for Android build support</li>
<li>Add logging support for Android, in place of standard <tt>syslog()</tt>.</li>
<li>Switch back to using TLSv1, but without extensions.</li>
<li>Make TPM support optional, dependent on OpenSSL ENGINE support.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-3.10.tar.gz">OpenConnect v3.10</a></b> &#8212; 2011-06-30
<ul>
<li>Switch to using GNU autoconf/automake/libtool.</li>
<li>Produce shared library for authentication.</li>
<li>Improve library API to make life easier for C++ users.</li>
<li>Be more explicit about requiring <tt>pkg-config</tt>.</li>
<li>Invoke script with <tt>reason=reconnect</tt> on CSTP reconnect.</li>
<li>Add <tt>--non-inter</tt> option to avoid all user input.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-3.02.tar.gz">OpenConnect v3.02</a></b> &#8212; 2011-04-19
<ul>
<li>Install man page in <tt>make install</tt> target.</li>
<li>Add <tt>openconnect_vpninfo_free()</tt> to libopenconnect.</li>
<li>Clear cached <tt>peer_addr</tt> to avoid reconnecting to wrong host.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-3.01.tar.gz">OpenConnect v3.01</a></b> &#8212; 2011-03-09
<ul>
<li>Add libxml2 to pkg-config requirements.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-3.00.tar.gz">OpenConnect v3.00</a></b> &#8212; 2011-03-09
<ul>
<li>Create libopenconnect.a for GUI authentication dialog to use.</li>
<li>Remove auth-dialog, which now lives in the <a href="http://git.gnome.org/browse/network-manager-openconnect/">network-manager-openconnect</a> package.</li>
<li>Cope with more entries in authentication forms.</li>
<li>Add <tt>--csd-wrapper</tt> option to wrap CSD trojan.</li>
<li>Report error and abort if CA file cannot be opened.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.26.tar.gz">OpenConnect v2.26</a></b> &#8212; 2010-09-22
<ul>
<li>Fix potential crash on relative HTTP redirect.</li>
<li>Use correct TUN/TAP device node on Android.</li>
<li>Check client certificate expiry date.</li>
<li>Implement CSTP and DTLS rekeying <i>(both by reconnecting CSTP)</i>.</li>
<li>Add <tt>--force-dpd</tt> option to set minimum DPD interval.</li>
<li>Don't print <tt>webvpn</tt> cookie in debug output.</li>
<li>Fix host selection in NetworkManager auth dialog.</li>
<li>Use SSLv3 instead of TLSv1; some servers <i>(or their firewalls)</i>
don't accept any <tt>ClientHello</tt> options.</li>
<li>Never include address family prefix on <tt>script-tun</tt> connections.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.25.tar.gz">OpenConnect v2.25</a></b> &#8212; 2010-05-15
<ul>
<li>Always validate server certificate, even when no extra <tt>--cafile</tt> is provided.</li>
<li>Add <tt>--no-cert-check</tt> option to avoid certificate validation.</li>
<li>Check server hostname against its certificate.</li>
<li>Provide text-mode function for reviewing and accepting "invalid" certificates.</li>
<li>Fix libproxy detection on NetBSD.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.24.tar.gz">OpenConnect v2.24</a></b> &#8212; 2010-05-07
<ul>
<li>Forget preconfigured password after a single attempt; don't retry infinitely if it's failing.</li>
<li>Set <tt>$CISCO_BANNER</tt> environment variable when running script.</li>
<li>Better handling of passphrase failure on certificate files.</li>
<li>Fix NetBSD build (thanks to Pouya D. Tafti).</li>
<li>Fix DragonFly BSD build.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.23.tar.gz">OpenConnect v2.23</a></b> &#8212; 2010-04-09
<ul>
<li>Support "Cisco Secure Desktop" trojan in NetworkManager auth-dialog.</li>
<li>Support proxy in NetworkManager auth-dialog.</li>
<li>Add <tt>--no-http-keepalive</tt> option to work around Cisco's incompetence.</li>
<li>Fix build on Debian/kFreeBSD.</li>
<li>Fix crash on receiving HTTP 404 error.</li>
<li>Improve workaround for server certificates lacking SSL_SERVER purpose, so that it also works with OpenSSL older than 0.9.8k.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.22.tar.gz">OpenConnect v2.22</a></b> &#8212; 2010-03-07
<ul>
<li>Fix bug handling port numbers above 9999.</li>
<li>Ignore "<tt>Connection: Keep-Alive</tt>" in HTTP/1.0 to work around server bug with certificate authentication.</li>
<li>Handle non-standard port (and full URLs) when used with NetworkManager.</li>
<li>Cope with relative redirect and form URLs.</li>
<li>Allocate HTTP receive buffer dynamically, to cope with arbitrary size of content.</li>
<li>Fix server cert SHA1 comparison to be case-insensitive.</li>
<li>Fix build on Solaris and OSX <i>(<tt>strndup()</tt>, <tt>AI_NUMERICSERV</tt>).</i></li>
<li>Fix exit code with <tt>--background</tt> option.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.21.tar.gz">OpenConnect v2.21</a></b> &#8212; 2010-01-10
<ul>
<li>Fix handling of HTTP 1.0 responses with keepalive <a href="https://bugzilla.redhat.com/show_bug.cgi?id=553817"><i>(RH#553817)</i></a>.</li>
<li>Fix case sensitivity in HTTP headers and hostname comparison on redirect.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.20.tar.gz">OpenConnect v2.20</a></b> &#8212; 2010-01-04
<ul>
<li>Fix use-after-free bug in NetworkManager authentication dialog <a href="https://bugzilla.redhat.com/show_bug.cgi?id=551665"><i>(RH#551665)</i></a>.</li>
<li>Allow server to be specified with <tt>https://</tt> URL, including port and pathname (which Cisco calls 'UserGroup')</li>
<li>Support connection through HTTP and SOCKS proxies.</li>
<li>Handle HTTP redirection with port numbers.</li>
<li>Handle HTTP redirection with IPv6 literal addresses.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.12.tar.gz">OpenConnect v2.12</a></b> &#8212; 2009-12-07
<ul>
<li>Fix buffer overflow when generating useragent string.</li>
<li>Cope with idiotic schizoDNS configurations by not repeating DNS lookup for VPN server on reconnects.</li>
<li>Support DragonFlyBSD. Probably.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.11.tar.gz">OpenConnect v2.11</a></b> &#8212; 2009-11-17
<ul>
<li>Add IPv6 support for FreeBSD.</li>
<li>Support "split tunnel" mode for IPv6 routing.</li>
<li>Fix bug where client certificate's MD5 was only given to the
CSD trojan if a PKCS#12 certificate was used.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.10.tar.gz">OpenConnect v2.10</a></b> &#8212; 2009-11-04
<ul>
<li>OpenSolaris support.</li>
<li>Preliminary support for IPv6 connectivity.</li>
<li>Fix session shutdown on exit.</li>
<li>Fix reconnection when TCP connection is closed.</li>
<li>Support for "Cisco Secure Desktop" idiocy.</li>
<li>Allow <tt>User-Agent:</tt> to be specified on command line.</li>
<li>Fix session termination on disconnect.</li>
<li>Fix recognition of certificates from OpenSSL 1.0.0.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.01.tar.gz">OpenConnect v2.01</a></b> &#8212; 2009-06-24
<ul>
<li>Fix bug causing loss of DTLS (and lots of syslog spam about it)
after a CSTP reconnection.</li>
<li>Don't apply OpenSSL certificate chain workaround if we already
have "extra" certificates loaded (e.g. from a PKCS#12 file).</li>
<li>Load "extra" certificates from <tt>.pem</tt> files too.</li>
<li>Fix SEGV caused by freeing certificates after processing cert
chain.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-2.00.tar.gz">OpenConnect v2.00</a></b> &#8212; 2009-06-03
<ul>
<li>Add OpenBSD and FreeBSD support.</li>
<li>Build with OpenSSL-0.9.7 (Mac OS X, OpenBSD, etc.)</li>
<li>Support PKCS#12 certificates.</li>
<li>Automatic detection of certificate type (PKCS#12, PEM, TPM).</li>
<li>Work around OpenSSL trust chain issues (<a href="http://rt.openssl.org/Ticket/Display.html?id=1942&amp;amp;user=guest&amp;amp;pass=guest">RT#1942</a>).</li>
<li>Allow PEM passphrase to be specified on command line.</li>
<li>Allow PEM passphrase automatically generated from the <tt>fsid</tt> of the file system on which the certificate is stored.</li>
<li>Fix certificate comparisons (in NM auth-dialog and <tt>--servercert</tt> option) to use SHA1 fingerprint, not signature.</li>
<li>Fix segfault in NM auth-dialog when changing hosts.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-1.40.tar.gz">OpenConnect v1.40</a></b> &#8212; 2009-05-27
<ul>
<li>Fix validation of server's SSL certificate when NetworkManager runs openconnect as an unprivileged user (which can't read the real user's trust chain file).</li>
<li>Fix double-free of DTLS Cipher option on reconnect.</li>
<li>Reconnect on SSL write errors</li>
<li>Fix reporting of SSL errors through syslog/UI.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-1.30.tar.gz">OpenConnect v1.30</a></b> &#8212; 2009-05-13
<ul>
<li>NetworkManager auth-dialog will now cache authentication form options.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-1.20.tar.gz">OpenConnect v1.20</a></b> &#8212; 2009-05-08
<ul>
<li>DTLS cipher choice fixes.</li>
<li>Improve handling of authentication group selection.</li>
<li>Export more information to connection script.</li>
<li>Add <tt>--background</tt> option to dæmonize after connection.</li>
<li>Detect TCP connection closure.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-1.10.tar.gz">OpenConnect v1.10</a></b> &#8212; 2009-04-01
<ul>
<li>NetworkManager UI rewrite with many improvements.</li>
<li>Support for "UserGroups" where a single server offers multiple
configurations according to the URL used to connect.</li>
</ul><br/>
</li>
<li><b><a href="ftp://ftp.infradead.org/pub/openconnect/openconnect-1.00.tar.gz">OpenConnect v1.00</a></b> &#8212; 2009-03-18
<ul>
<li>First non-beta release.</li>
</ul>
</li>
</ul>
<INCLUDE file="inc/footer.tmpl" />
</PAGE>

38 changes: 38 additions & 0 deletions www/connecting.xml
@@ -0,0 +1,38 @@
<PAGE>
<VAR match="VAR_ORIGIN" replace="" />
<VAR match="VAR_CVSID" replace=""/>
<INCLUDE file="inc/header.tmpl" />

<VAR match="VAR_SEL_STARTED" replace="selected" />
<VAR match="VAR_SEL_CONNECTING" replace="selected" />
<PARSE file="menu1.xml" />
<PARSE file="menu2-started.xml" />

<INCLUDE file="inc/content.tmpl" />

<h1>Getting Started</h1>

<p>Once you have <a href="building.html">installed</a> OpenConnect and checked that you have a
<a href="vpnc-script.html">vpnc-script</a> which will set up the routing and DNS for it, using OpenConnect
is very simple. As root, run the following command:<br/>
<tt>openconnect --script /etc/vpnc/vpnc-script https://vpn.mycompany.com/</tt>
</p>

That should be it, if you have a password-based login. If you use
certificates, you'll need to tell OpenConnect where to find the
certificate with the <tt>-c</tt> option. You might need to steal the
certificate from your Windows certificate store using a tool like <a
href="http://www.isecpartners.com/application-security-tools/jailbreak.html">Jailbreak</a>.
<p>
To start with, you can ignore anything you see in the <a href="compatibility.html">compatibility</a>
page about needing to patch OpenSSL so that DTLS works &#8212; you
don't really need it, although it will make your connections much
faster if you're experiencing packet loss between you and the VPN
server. But you can worry about that later.
</p>

<INCLUDE file="inc/footer.tmpl" />
</PAGE>



0 comments on commit 2fdf095

Please sign in to comment.