View source

=== Can I use different SSL certificates for each virtual host? ===

<p>''We have two domains on one server.  Is there an example config file showing how to have multiple ssl certificates, one for each virtual host?''</p>

<p>This is not possible if you are using Resin's virtual hosting capability to
serve to multiple domain names using a single IP address.</p>

<p>The SSL connection (and certificate) are handled before the HTTP request is
sent.  Unless the domain name is mapped to a unique ip address, the server
cannot know which domain name the user is using until after SSL is set up.
There is no way for Resin to determine which domain name the user has specified
in the request until after the SSL decryption has occurred.</p>

<p>It is possible if you have separate IP addresses for the hosts.  You need
unique http port listeners that only bind on that ip
address.  Each of these http ports can have it's own ssl
configurations.</p>

<code><pre>
&lt;resin xmlns="http://caucho.com/ns/resin">
&lt;cluster id="">

  &lt;server id="">
    &lt;http address="*" port="80"/&gt;

    &lt;http address="199.199.0.10" port="443" virtual-host="gryffindor.com"&gt;
      &lt;openssl&gt;
        &lt;certificate-file&gt;keys/gryffindor.crt&lt;/certificate-file&gt;
        &lt;certificate-key-file&gt;keys/gryffindor.key&lt;/certificate-key-file&gt;
        &lt;password&gt;test123&lt;/password&gt;
      &lt;/openssl&gt;
    &lt;/http&gt;

    &lt;http address="199.199.0.11" port="443" virtual-host="slytherin.com"&gt;
      &lt;openssl&gt;
        &lt;certificate-file&gt;keys/slytherin.crt&lt;/certificate-file&gt;
        &lt;certificate-key-file&gt;keys/slytherin.key&lt;/certificate-key-file&gt;
        &lt;password&gt;test123&lt;/password&gt;
      &lt;/openssl&gt;
    &lt;/http&gt;

  ...
  &lt;/server>

  &lt;host id="gryffindor.com"&gt;
     &lt;host-alias&gt;www.gryffindor.com&lt;/host-alias&gt;

    ...

  &lt;/host&gt;

  &lt;host id="slytherin.com"&gt;
    &lt;host-alias&gt;www.slytherin.com&lt;/host-alias&gt;

    ...
  &lt;/host&gt;

  ...
&lt;/cluster>
&lt;/resin>
</pre></code>

=== Why does Resin say I need OPENSSL_THREADS when I try to use OpenSSL? ===

<p>''Resin dies with an error on startup  "Resin requires a threaded version of OpenSSL.  OpenSSL must be compiled with OPENSSL_THREADS for Resin to use it."''</p>

Resin requires a threaded version of the OpenSSL libraries.  Usually a threaded
version is the default for OpenSSL, however on some systems it is necessary to
explicitly request a thread version.

<p>
To recompile the openssl libraries with threading enabled:
</p>

<code><pre>
$ cd openssl-0.9.7c
$ ./config threads
$ make
$ make install
</pre></code>

<p>The INSTALL document from the OpenSSL package contains more
information on the <code>threads</code> option.
</p>

=== What is the sequence of handshakes for an SSL connection? ===

<code><pre>
ClientHello-&gt;
&lt;-ServerHello
&lt;-CertificateChain
&lt;-ServerHelloDone
ClientKeyExchange-&gt;
ChangeCipherSpec-&gt;
Finished-&gt;
&lt;-ChangeCipherSpec
&lt;-Finished
</pre></code>

=== How do I handle port 80 and root issues on Linux? ===

Use Resin 3.1 Professional with the <user-name> tag.  The Resin [watchdog] will start as root and bind to port 80 as root.  Before the watchdog launches the Resin instance, it will change to the <user-name>.

=== Where can I learn more about SSL? ===

* [http://httpd.apache.org/docs-2.0/ssl/ssl_intro.html Apache documentation]

=== Converting a JSSE Keystore to OpenSSL ===

* [http://www.thauvin.net/blog/stories.jsp?id=42 Erik's Weblog - Converting a JSSE Keystore to OpenSSL]