jwebmail-guide.html

Java编程 使用javamail 实现邮件管理系统

    </P>
<A NAME="install:mysql"></A><H2>4.1. Storage Methods</H2>
<P>
        By default, when you install the web application, a XML storage
        are will be set up under the servlet container owner's home
        directory.
        The location, and many other things can be changed, but data should
        not be written under the context root (appication deployment directory).
      </P>
<CENTER><TABLE WIDTH="80%" BGCOLOR="#eae723" BORDER="1"><TR><TD>
<B>Note:</B>
        A database storage option (JDBC) is planned, but implementation has not
        yet begun.
      </TD></TR></TABLE></CENTER>
<A HREF="#install:mysql">Top of section "Storage Methods"</A><HR>
<A NAME="config:admin"></A><H2>4.2. JWebMail Administrator Plugin</H2>
<A NAME="config:admin:connecting"></A><H3>4.2.1. Connecting</H3>
        <P>
          You can connect to the administration interface with your browser by simply entering
          the URL <CODE>http(s)://webmail_server:port/jwebmail/admin</CODE> in the address field of your browser.
          (set http/https and replace webmail_server and port with the correct values).
        </P>
        <P>
          You'll be presented the administrator's login screen then. Enter the password there
          (on first startup the password is "Secret") and click the login button. You should see
          the system settings form then.
        </P>
      <A HREF="#config:admin:connecting">Top of section "Connecting"</A><A NAME="config:admin:system"></A><H3>4.2.2. System Settings</H3>
        <P>
          The first page gives you a list of JWebMail system variables and their values. You can
          change any variables you like (there is a short description for each of them) and then
          hit the submit button on the bottom of the page.
        </P>
        <P>
          There are basically 4 kinds of input fields (although you will probably only recognize
          2 on first look):
          <UL>
            <LI>simple text input fields</LI>
            <LI>drop down selects</LI>
            <LI>integer input fields (look like text input fields)</LI>
            <LI>password input fields (look like text input fields and show the encrypted password!)</LI>
          </UL>
        </P>
        <P>
          All of these fields will check whether the value entered is (more or less) correct if you submit
          the form.
        </P>
        <P>
          <CENTER><TABLE WIDTH="80%" BGCOLOR="#eae723" BORDER="1"><TR><TD>
<B>Note:</B>Special note on password fields: The password is shown encrypted (Unix crypt()), but
            if you want to change your password, please enter it in plain text. It will then show
            up encrypted again, after you hit the submit button (but still be the password you just
            entered).</TD></TR></TABLE></CENTER>
        </P>
        
      <A HREF="#config:admin:system">Top of section "System Settings"</A><A NAME="config:admin:vdom"></A><H3>4.2.3. JWebMail Virtual Domain Support</H3>
        <P>
          Virtual Domains in JWebMail are a quite new concept (thanks to Oswaldo E. Aguirre M. for
          the idea).
        </P>
        <P>
          They basically provide the following features:
          <UL>
            <LI>users are associated to a domain (even if you only have one domain)</LI>
            <LI>each domain can have its own authentication host (if IMAP/POP authentication is used)</LI>
            <LI>the administrator of JWebMail can impose certain restrictions on users of a JWebMail
              domain. e.g. you can restrict the hosts where users may connect to here</LI>
            <LI>each domain has its own default host where the user's primary folder will be found</LI>
            <LI>the user's default email address will be set to
              "<CODE>user@domain</CODE>"</LI>
          </UL>
        </P>
        <P>
          Naturally, with this concept you will need to have at least one domain even if you don't
          plan to use virtual domains really.
        </P>
        <P>
          The JWebMail virtual domain setup form is quite simple and self explanatory, I think.
          There is one column where you have to enter the domain name, one where you have to
          enter this domain's default host (user's primary folder host), one for the authenti-
          cation host (not necessarily the same as the default host), and some fields that
          control the restrictions for users of this domain. With the checkbox, you can turn on/off
          host restriction completely, in the allowed hosts column, you can enter a comma-separated
          list of domains/hosts where users may access IMAP folders (e.g. "wastl.net" would allow
          them to use "mail.wastl.net" and "pop.wastl.net" while setting it to "mail.wastl.net"
          would just allow "mail.wastl.net" (and certainly "imap.mail.watl.net") and so on (suffix
          is matched to say it simple)).
        </P>
      <A HREF="#config:admin:vdom">Top of section "JWebMail Virtual Domain Support"</A><A NAME="config:admin:users"></A><H3>4.2.4. Editing Users</H3>
        <P>
          You can add, edit and delete users from the administration interface (Note that you don't
          have to create users before they may use JWebMail since they get default settings when they
          first log on authenticating against IMAP, POP or Unix).
        </P>
        <P>
          To create a user,
          <UL>
            <LI>enter the user name and the domain in the user field (in the form "<CODE>user@domain</CODE>")</LI>
            <LI>optionally change all the other fields from the default settings</LI>
            <LI>hit the create/edit button on the bottom of the page</LI>
          </UL>
        </P>
        <P>
          To edit a user,
          <UL>
            <LI>select the user in the drop down menu OR enter the user name (with domain) in the short
              text field</LI>
            <LI>edit the user settings</LI>
            <LI>hit the create/edit button on the bottom of the page</LI>
          </UL>
        </P>
        <P>
          To delete a user,
          <UL>
            <LI>select the user in the drop down menu OR enter the user name (with domain) in the short
              text field</LI>
            <LI>Hit the delete button</LI>
          </UL>
        </P>
      <A HREF="#config:admin:users">Top of section "Editing Users"</A><A NAME="config:admin:status"></A><H3>4.2.5. Viewing JWebMail Status</H3>
        <P>
          Last but not least you can get an overview of currently active sessions with
          the "view sessions" link. You will get some status information there as well as
          the possibility to explicitly kill an active session (whatever maybe the reason).
          Please be careful however with this feature, as you are very likely to kill a
          session that is currently in use and its user will probably not be very happy about
          that. The sessions will expire after a configured time anyway.
        </P>
        <P>
          The Administrator Interface is currently available in English only, but the
          templates are already prepared for translation The system's default language will then be
          used (determined by the LANG environment setting).
        </P>
        <P>
          I hope the rest is quite self explanatory at the moment, but I'll add some
          documentation later.
        </P>
      <A HREF="#config:admin:status">Top of section "Viewing JWebMail Status"</A><A HREF="#config:admin">Top of section "JWebMail Administrator Plugin"</A><HR>
<A HREF="#config">Top of section "Configuration"</A><A NAME="auth"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>V. User Authentication</CENTER></H1></TD></TR></TABLE>
<P>
      JWebMail supports extended user authentication. At the moment, the
      following authentication methods are supported:
      <UL>
        <LI>
<STRONG>SIMPLE</STRONG>: Use JWebMail's former authentication method. Password is only
          checked against the user's configuration. The user may change his password from within JWebMail</LI>
        <LI>
<STRONG>IMAP</STRONG>: Check login/password on a remote IMAP host. JWebMail tries to
          login on a remote IMAP host with the given login and password.<BR>
          If login fails, JWebMail doesn't allow access.</LI>
        <LI>
<STRONG>POP</STRONG>: Same for a POP3 server</LI>
        <LI>
<STRONG>UNIX</STRONG>: Check login/password using Unix's login facility.
          login/password are checked against the Unix passwd/shadow files.<BR>
          Note: JWebMail must be run as user root to use Unix Authentication</LI>
      </UL>
    </P>
<P>
      Changing authentication method can be achieved using the Administration
      Interface and changing the <CODE>AUTH</CODE> variable.
      For IMAP authentication there is an extra configuration variable called
      <CODE>AUTHHOST</CODE>.
    </P>
<A HREF="#auth">Top of section "User Authentication"</A><A NAME="usage"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>VI. Usage</CENTER></H1></TD></TR></TABLE>
<A NAME="usage:general"></A><H2>6.1. General Usage</H2>
<P>
        The JWebMail daemon listens on whatever port you have configure.
        Just point your browser麓s URL to http://yourhost:yourport/jwebmail
        and see the login screen.
      </P>
<P>
        A user will get the password he logs in with the first time. Passwords
        may be changed by the user in the options dialog.
        JWebMail will try to establish a default connection to the configured
        default IMAP host with the user ID and password it was given, so it may
        be useful to use the same ID and password as on the IMAP host.
      </P>
<P>
        For further information, just click on the "?" at the navigation bar.
      </P>
<P>
        JWebMail should also work with Proxy Servers and other Clients than
        Netscape Communicator.
      </P>
<A HREF="#usage:general">Top of section "General Usage"</A><HR>
<A NAME="usage:folders"></A><H2>6.2. Folders</H2>
<P>
        JWebMail supports as many IMAP folders on as many different hosts you like.
      </P>
<P>
        JWebMail mailboxes are configured by each user, however the administrator can
        change the default mailbox for each virtual domain. The default mailbox is the
        mailbox the user gets on the first login. He can than choose to remove it at any time
        and also add other mailboxes (the administrator can restrict that in the virtual
        domain configuration).
      </P>
<A HREF="#usage:folders">Top of section "Folders"</A><HR>
<A HREF="#usage">Top of section "Usage"</A><A NAME="lang"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>VII. Different Languages, Translating JWebMail</CENTER></H1></TD></TR></TABLE>
<P>
      JWebMail supports the usage of different languages on a per user basis.
      Since v0.6.0 JWebMail scans for available languages automatically and adds
      the corresponding locales to the user's setup dialog ("de" will add the
      locales "de_DE", "de_AT", "de_CH", ...).<BR>
      To translate JWebMail to a new language, please read the file "Translating"
      in the developers' documentation (source only).
    </P>
<A HREF="#lang">Top of section "Different Languages, Translating JWebMail"</A><A NAME="notes"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>VIII. Notes</CENTER></H1></TD></TR></TABLE>
<A NAME="notes:status"></A><H2>8.1. JWebMail Status</H2>
<P>
        JWebMail Pre-1.0.1 is BETA.
      </P>
<P>
        Some features on the wish-list are
        <UL>
          <LI>Captcha</LI> to prevent robots, trojans, and miners from
            sapping our servers.
          <LI>JDBC Integration</LI>
          <LI>Refactor and modernize the authentication methods</LI>
          <LI>Different XSL stylesheets to convert the JWebMail UI to other
            formats than HTML (perhaps WML for mobile phones)</LI>
          <LI>PGP</LI>
          <LI>
<I>Extras</I> like calendar and so on
            (will be realized as JWebMail Plugins)</LI>
        </UL>
      </P>
<A HREF="#notes:status">Top of section "JWebMail Status"</A><HR>
<A NAME="notes:changes"></A><H2>8.2. Changes</H2>
<P>
        See the file <CODE>changes.txt</CODE> for a list of changes in the different
        JWebMail releases.
      </P>
<A HREF="#notes:changes">Top of section "Changes"</A><HR>
<A HREF="#notes">Top of section "Notes"</A><A NAME="license"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>IX. License</CENTER></H1></TD></TR></TABLE>
<P>
      JWebMail is copyright 2008 by the JWebMail Development Team and Sebastian Schaffert.
    </P>
<P>
      The base JWebMail product
      is distributed under the terms of the Apache 2.0 license.
      You can find a copy in the file <A HREF="">LICENSE.txt</A>,
      or at <A HREF="">
      http://www.apache.org/licenses/LICENSE-2.0</A>.
    </P>
<P>
      The Bibop theme is copyrighted under the supplied GPL 2 license.
    </P>
<A HREF="#license">Top of section "License"</A><A NAME="doc_contrib"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>X. Contributed Documentation</CENTER></H1></TD></TR></TABLE>
<P>
      <I>Contributed Documentation</I> is documentation that has been provided by people that are not
      core JWebMail developers but have managed to run JWebMail on different platforms/systems and taken the
      effort to provide you with some sort of extra documentation (thanks a lot, BTW). I (Sebastian
      Schaffert) have not tested what you will find here.
    </P>
<A HREF="#doc_contrib">Top of section "Contributed Documentation"</A><A NAME="credits"></A><TABLE WIDTH="100%" BGCOLOR="#a0d895" CELLSPACING="0" BORDER="0"><TR><TD><H1><CENTER>XI. Credits</CENTER></H1></TD></TR></TABLE>
<P>
      Appreciation to all who reported bugs and made suggestions to
      improve JWebMail.
    </P>
<P>
      Some, however, I want to mention explicitly:
      <UL>
        <LI>Sebastian Schaffert, [e-mail],
        who was the project lead before me.</LI>
        <LI>Devin Kowatch, [e-mail], for contributing challenge/response authentication</LI>
        <LI>Homero Borgo, [e-mail], for testing JWebMail under rough conditions
          and helping much to find bugs in the product.</LI>
        <LI>Sebastian's girlfriend for her patience and the cool icons for JWebMail 0.5 and 0.6</LI>
        <LI>The people at Bibop in Italy, especially Gianugo Rabellino and Ricardo Rocha for
          doing the Bibop Theme and lots of inspirations</LI>
        <LI>Sacha Berger, [e-mail], for some very interesting
        discussions about how to do things right.:-)</LI>
      </UL>
    </P>
<P>
      <STRONG>Blaine Simpson, [e-mail]</STRONG>
    </P>
<A HREF="#credits">Top of section "Credits"</A>
</BODY>
</HTML>