www/connecting.xml

   1 <PAGE>
   2         <VAR match="VAR_ORIGIN" replace="" />
   3         <VAR match="VAR_CVSID" replace=""/>
   4         <INCLUDE file="inc/header.tmpl" />
   5
   6         <VAR match="VAR_SEL_STARTED" replace="selected" />
   7         <VAR match="VAR_SEL_CONNECTING" replace="selected" />
   8         <PARSE file="menu1.xml" />
   9         <PARSE file="menu2-started.xml" />
  10
  11         <INCLUDE file="inc/content.tmpl" />
  12
  13         <h1>Connecting to the VPN</h1>
  14
  15 <p>Once you have <a href="building.html">installed</a> OpenConnect and checked that you have a
  16 <a href="vpnc-script.html">vpnc-script</a> which will set up the routing and DNS for it, using OpenConnect
  17  is very simple. As root, run the following command:
  18  <ul>
  19    <li><tt>openconnect https://vpn.mycompany.com/</tt></li>
  20  </ul>
  21     </p>
  22
  23 <p>That should be it, if you have a password-based login. If you use
  24 certificates, you'll need to tell OpenConnect where to find the
  25 certificate with the <tt>-c</tt> option.</p>
  26
  27 <p>You can provide the certificate either as the file name of a PKCS#12 or PEM file,
  28 or if OpenConnect is built against a suitable version of GnuTLS you can provide the
  29 certificate in the form of a PKCS#11 URL:
  30 <ul>
  31   <li><tt>openconnect -c certificate.pem https://vpn.mycompany.com/</tt></li>
  32   <li><tt>openconnect -c pkcs11:id=X_%b04%c3%85%d4u%e7%0b%10v%08%c9%0dA%8f%3bl%df https://vpn.mycompany.com/</tt></li>
  33 </ul>
  34 </p>
  35
  36 <p>You might need to steal the
  37 certificate from your Windows certificate store using a tool like <a
  38 href="http://www.isecpartners.com/application-security-tools/jailbreak.html">Jailbreak</a>.</p>
  39 <p>
  40 To start with, you can ignore anything you see in the <a href="technical.html">technical</a>
  41 page about needing to patch OpenSSL or GnuTLS so that DTLS works &#8212; you
  42 can survive without it, although DTLS will make your connections much
  43 faster if you're experiencing packet loss between you and the VPN
  44 server. But you can worry about that later.
  45 </p>
  46
  47         <INCLUDE file="inc/footer.tmpl" />
  48 </PAGE>
  49
  50
  51