update pkgsrc example to actually reflect pkgsrc. wikistyle
authorPatrickGeorgi <PatrickGeorgi@web>
Wed, 21 Jan 2009 19:09:16 +0000 (11:09 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Wed, 21 Jan 2009 19:09:16 +0000 (11:09 -0800)
docs/handbook/handbook-smtp-auth.mdwn

index c7aea3a..f9a7237 100644 (file)
-\r
-\r
-## 20.10 SMTP Authentication \r
-\r
-***Written by James Gorham. ***\r
-\r
-Having SMTP Authentication in place on your mail server has a number of benefits. SMTP Authentication can add another layer of security to  **sendmail** , and has the benefit of giving mobile users who switch hosts the ability to use the same mail server without the need to reconfigure their mail client settings each time.\r
-\r
-  1. Install [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl) from the ports. You can find this port in [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl). [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl) has a number of compile time options to choose from and, for the method we will be using here, make sure to select the `pwcheck` option.\r
-  1. After installing [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl), edit `/usr/local/lib/sasl/Sendmail.conf` (or create it if it does not exist) and add the following line:\r
-      \r
-      pwcheck_method: passwd\r
-  \r
-  This method will enable  **sendmail**  to authenticate against your DragonFly `passwd` database. This saves the trouble of creating a new set of usernames and passwords for each user that needs to use SMTP authentication, and keeps the login and mail password the same.\r
-  1. Now edit `/etc/make.conf` and add the following lines:\r
-      \r
-      SENDMAIL_CFLAGS=-I/usr/local/include/sasl1 -DSASL\r
-      SENDMAIL_LDFLAGS=-L/usr/local/lib\r
-      SENDMAIL_LDADD=-lsasl\r
-  \r
-  These lines will give  **sendmail**  the proper configuration options for linking to [`cyrus-sasl`](http://pkgsrc.se/cyrus-sasl) at compile time. Make sure that [`cyrus-sasl`](http://pkgsrc.se/cyrus-sasl) has been installed before recompiling  **sendmail** .\r
-  1. Recompile  **sendmail**  by executing the following commands:\r
-      \r
-      # cd /usr/src/usr.sbin/sendmail\r
-      # make cleandir\r
-      # make obj\r
-      # make\r
-      # make install\r
-  \r
-  The compile of  **sendmail**  should not have any problems if `/usr/src` has not been changed extensively and the shared libraries it needs are available.\r
-  1. After  **sendmail**  has been compiled and reinstalled, edit your `/etc/mail/freebsd.mc` file (or whichever file you use as your `.mc` file. Many administrators choose to use the output from [hostname(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#hostname&section1) as the `.mc` file for uniqueness). Add these lines to it:\r
-      \r
-      dnl set SASL options\r
-      TRUST_AUTH_MECH(`GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl\r
-      define(`confAUTH_MECHANISMS', `GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl\r
-      define(`confDEF_AUTH_INFO', `/etc/mail/auth-info')dnl\r
-  \r
-  These options configure the different methods available to  **sendmail**  for authenticating users. If you would like to use a method other than  **pwcheck** , please see the included documentation.\r
-  1. Finally, run [make(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#make&section1) while in `/etc/mail`. That will run your new `.mc` file and create a `.cf` file named `freebsd.cf` (or whatever name you have used for your `.mc` file). Then use the command `make install restart`, which will copy the file to `sendmail.cf`, and will properly restart  **sendmail** . For more information about this process, you should refer to `/etc/mail/Makefile`.\r
-\r
-If all has gone correctly, you should be able to enter your login information into the mail client and send a test message. For further investigation, set the `LogLevel` of  **sendmail**  to 13 and watch `/var/log/maillog` for any errors.\r
-\r
-You may wish to add the following lines to `/etc/rc.conf` so this service will be available after every system boot:\r
-\r
-    \r
-    sasl_pwcheck_enable="YES"\r
-    sasl_pwcheck_program="/usr/local/sbin/pwcheck"\r
-\r
-\r
-This will ensure the initialization of SMTP_AUTH upon system boot.\r
-\r
-For more information, please see the  **sendmail**  page regarding [SMTP authentication](http://www.sendmail.org/~ca/email/auth.html).\r
-\r
-\r
-\r
-CategoryHandbook\r
-CategoryHandbook-email\r
+## 20.10 SMTP Authentication 
+
+
+
+***Written by James Gorham. ***
+
+
+
+Having SMTP Authentication in place on your mail server has a number of benefits. SMTP Authentication can add another layer of security to  **sendmail** , and has the benefit of giving mobile users who switch hosts the ability to use the same mail server without the need to reconfigure their mail client settings each time.
+
+
+
+  1. Install [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl) from the ports. You can find this port in [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl). [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl) has a number of compile time options to choose from and, for the method we will be using here, make sure to select the `pwcheck` option.
+
+  1. After installing [`security/cyrus-sasl`](http://pkgsrc.se/security/cyrus-sasl), edit `/usr/local/lib/sasl/Sendmail.conf` (or create it if it does not exist) and add the following line:
+
+      
+
+      pwcheck_method: passwd
+
+  
+
+  This method will enable  **sendmail**  to authenticate against your DragonFly `passwd` database. This saves the trouble of creating a new set of usernames and passwords for each user that needs to use SMTP authentication, and keeps the login and mail password the same.
+
+  1. Now edit `/etc/make.conf` and add the following lines:
+
+       SENDMAIL_CFLAGS=-I/usr/pkg/include/sasl -DSASL
+       SENDMAIL_LDFLAGS=-L/usr/pkg/lib
+       SENDMAIL_LDADD=-lsasl2
+
+  These lines will give  **sendmail**  the proper configuration options for linking to [`cyrus-sasl`](http://pkgsrc.se/cyrus-sasl) at compile time. Make sure that [`cyrus-sasl`](http://pkgsrc.se/cyrus-sasl) has been installed before recompiling  **sendmail** .
+
+  1. Recompile  **sendmail**  by executing the following commands:
+
+      
+
+       # cd /usr/src/usr.sbin/sendmail
+       # make cleandir
+       # make obj
+       # make
+       # make install
+
+  
+
+  The compile of  **sendmail**  should not have any problems if `/usr/src` has not been changed extensively and the shared libraries it needs are available.
+
+  1. After  **sendmail**  has been compiled and reinstalled, edit your `/etc/mail/freebsd.mc` file (or whichever file you use as your `.mc` file. Many administrators choose to use the output from [hostname(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#hostname&section1) as the `.mc` file for uniqueness). Add these lines to it:
+
+      
+
+      dnl set SASL options
+
+      TRUST_AUTH_MECH(`GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl
+
+      define(`confAUTH_MECHANISMS', `GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl
+
+      define(`confDEF_AUTH_INFO', `/etc/mail/auth-info')dnl
+
+  
+
+  These options configure the different methods available to  **sendmail**  for authenticating users. If you would like to use a method other than  **pwcheck** , please see the included documentation.
+
+  1. Finally, run [make(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#make&section1) while in `/etc/mail`. That will run your new `.mc` file and create a `.cf` file named `freebsd.cf` (or whatever name you have used for your `.mc` file). Then use the command `make install restart`, which will copy the file to `sendmail.cf`, and will properly restart  **sendmail** . For more information about this process, you should refer to `/etc/mail/Makefile`.
+
+
+
+If all has gone correctly, you should be able to enter your login information into the mail client and send a test message. For further investigation, set the `LogLevel` of  **sendmail**  to 13 and watch `/var/log/maillog` for any errors.
+
+
+
+You may wish to add the following lines to `/etc/rc.conf` so this service will be available after every system boot:
+
+
+
+    
+
+    sasl_pwcheck_enable="YES"
+
+    sasl_pwcheck_program="/usr/local/sbin/pwcheck"
+
+
+
+
+
+This will ensure the initialization of SMTP_AUTH upon system boot.
+
+
+
+For more information, please see the  **sendmail**  page regarding [SMTP authentication](http://www.sendmail.org/~ca/email/auth.html).
+
+
+
+
+
+
+
+CategoryHandbook
+
+CategoryHandbook-email
+