Provide HTTP(s) Integration with Apache: Difference between revisions
No edit summary |
|||
Line 31: | Line 31: | ||
Please feel free to use the [http://www.zimbra.com/forums/ Zimbra Forums] to request more specific help, follow the article closely and do not rush - it will only take longer !! | Please feel free to use the [http://www.zimbra.com/forums/ Zimbra Forums] to request more specific help, follow the article closely and do not rush - it will only take longer !! | ||
[[#Setting up HTTP and HTTPS support through Apache VirtualHosts|Top]] | |||
=Laying the foundations= | =Laying the foundations= | ||
Line 48: | Line 50: | ||
<code> | <code> | ||
<pre>sudo su - zimbra</pre></code> | <pre>sudo su - zimbra</pre></code> | ||
[[#Setting up HTTP and HTTPS support through Apache VirtualHosts|Top]] | |||
===Step 1=== | ===Step 1=== | ||
Line 62: | Line 66: | ||
n.b. [http://www.zimbra.com/forums/administrators/7986-change-zimbra-webmail-port-number.html a more detailed thread here] | n.b. [http://www.zimbra.com/forums/administrators/7986-change-zimbra-webmail-port-number.html a more detailed thread here] | ||
[[#Setting up HTTP and HTTPS support through Apache VirtualHosts|Top]] | |||
===Step 2=== | ===Step 2=== | ||
Line 77: | Line 83: | ||
The Zimbra server was then restarted using the 'zmcontrol' command. | The Zimbra server was then restarted using the 'zmcontrol' command. | ||
[[#Setting up HTTP and HTTPS support through Apache VirtualHosts|Top]] | |||
===Step 3=== | ===Step 3=== |
Revision as of 02:31, 18 February 2008
Setting up HTTP and HTTPS support through Apache VirtualHosts
Scenario
Single production server, with public IP address running apache web server hosting multiple virtual domains, and Zimbra Groupware server to providing email and webmail access to users in multiple virtual domains.
The example domain used in this article is 'server.com' - replace with your own domain.
Aims
- You want to provide both http (insecure) and https (secure) access to clients through the webmail interface.
- On 'server.com' you want to provide webmail access when users visit 'http://webmail.server.com' and secure acces when they visit 'https://webmail.server.com'.
- The Apache server listens on default ports 80 and 443, the Zimbra server listens on port 81 and uses the insecure login authentication method (zmtlsctl http).
System Requirements
- Installed Apache webserver
- Familiarity with Apache VirtualHost configurations
- Working Zimbra installation
Time To Implement
Outside of meeting the system requirements, and reading this article through - the actual coding will take between 5-15 minutes depending on how familiar you are with the Linux command-line and the Zimbra server.
Advice
The article has been written by community members, Zimbra administrators and experienced coders - the proof reading may not be perfect and aims to provide ideas and an exampe of a successful working practice.
Please feel free to use the Zimbra Forums to request more specific help, follow the article closely and do not rush - it will only take longer !!
Laying the foundations
Plan of Action
- Configure Zimbra to run on port 81.
- Configure Zimbra to use simple http authentication.
- Install a new virtual host to catch all webmail.server.com requests.
- Install a new virtual host to catch all secure webmail.server.com requests.
All following commands are issued whilst logged in with the 'zimbra' user.
sudo su - zimbra
Step 1
- Ensure Zimbra is running on port 81
Using the syntax : zmprov ms <your-server> zimbraMailPort <your-port-number>
zmprov ms server.com zimbraMailPort 81
Breakdown
We logged in as the 'zimbra' user, then using the zmprov command to manipulate server name pair values, tell Zimbra to use the mail port number 81.
n.b. a more detailed thread here
Step 2
- Tell Zimbra to use the http authentication method - this does not redirect logins to SSL basically.
zmtlsctl http
zmcontrol stop;zmcontrol start
Breakdown
We issued the 'zmtlsctl' command and passed the http value (other options include https,both,mixed,redirect but they do not apply to this article)
The Zimbra server was then restarted using the 'zmcontrol' command.
Step 3
- Create a new apache configuration file to contain our virtualhosts