diff options
author | Jelmer Vernooij <jelmer@samba.org> | 2003-02-18 22:14:04 +0000 |
---|---|---|
committer | Jelmer Vernooij <jelmer@samba.org> | 2003-02-18 22:14:04 +0000 |
commit | ff78c3bf5c3a73cf90f6517d9b2d6b8c12d22d68 (patch) | |
tree | deda0311c634bd433278a352e1a9daece40ff0f6 /docs/htmldocs/winbind.html | |
parent | 4668623d62b3a7b133e26dd1397b956c4ddac335 (diff) | |
download | samba-ff78c3bf5c3a73cf90f6517d9b2d6b8c12d22d68.tar.gz samba-ff78c3bf5c3a73cf90f6517d9b2d6b8c12d22d68.tar.bz2 samba-ff78c3bf5c3a73cf90f6517d9b2d6b8c12d22d68.zip |
Regenerate
(This used to be commit 1ab5a3b17feb677425bb1071357c3dbabcc46c7e)
Diffstat (limited to 'docs/htmldocs/winbind.html')
-rw-r--r-- | docs/htmldocs/winbind.html | 169 |
1 files changed, 123 insertions, 46 deletions
diff --git a/docs/htmldocs/winbind.html b/docs/htmldocs/winbind.html index 1558512a61..d587696817 100644 --- a/docs/htmldocs/winbind.html +++ b/docs/htmldocs/winbind.html @@ -5,8 +5,7 @@ >Unified Logons between Windows NT and UNIX using Winbind</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.77+"><LINK REL="HOME" TITLE="SAMBA Project Documentation" HREF="samba-howto-collection.html"><LINK @@ -17,8 +16,8 @@ REL="PREVIOUS" TITLE="Printing Support" HREF="printing.html"><LINK REL="NEXT" -TITLE="Passdb MySQL plugin" -HREF="pdb-mysql.html"></HEAD +TITLE="Improved browsing in samba" +HREF="improved-browsing.html"></HEAD ><BODY CLASS="CHAPTER" BGCOLOR="#FFFFFF" @@ -60,7 +59,7 @@ WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A -HREF="pdb-mysql.html" +HREF="improved-browsing.html" ACCESSKEY="N" >Next</A ></TD @@ -73,13 +72,17 @@ WIDTH="100%"></DIV CLASS="CHAPTER" ><H1 ><A -NAME="WINBIND">Chapter 15. Unified Logons between Windows NT and UNIX using Winbind</H1 +NAME="WINBIND" +></A +>Chapter 14. Unified Logons between Windows NT and UNIX using Winbind</H1 ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2225">15.1. Abstract</H1 +NAME="AEN2360" +></A +>14.1. Abstract</H1 ><P >Integration of UNIX and Microsoft Windows NT through a unified logon has been considered a "holy grail" in heterogeneous @@ -104,7 +107,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2229">15.2. Introduction</H1 +NAME="AEN2364" +></A +>14.2. Introduction</H1 ><P >It is well known that UNIX and Microsoft Windows NT have different models for representing user and group information and @@ -156,7 +161,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2242">15.3. What Winbind Provides</H1 +NAME="AEN2377" +></A +>14.3. What Winbind Provides</H1 ><P >Winbind unifies UNIX and Windows NT account management by allowing a UNIX box to become a full member of a NT domain. Once @@ -196,7 +203,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2249">15.3.1. Target Uses</H2 +NAME="AEN2384" +></A +>14.3.1. Target Uses</H2 ><P >Winbind is targeted at organizations that have an existing NT based domain infrastructure into which they wish @@ -218,7 +227,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2253">15.4. How Winbind Works</H1 +NAME="AEN2388" +></A +>14.4. How Winbind Works</H1 ><P >The winbind system is designed around a client/server architecture. A long running <B @@ -236,9 +247,11 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2258">15.4.1. Microsoft Remote Procedure Calls</H2 +NAME="AEN2393" +></A +>14.4.1. Microsoft Remote Procedure Calls</H2 ><P ->Over the last two years, efforts have been underway +>Over the last few years, efforts have been underway by various Samba Team members to decode various aspects of the Microsoft Remote Procedure Call (MSRPC) system. This system is used for most network related operations between @@ -260,7 +273,28 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2262">15.4.2. Name Service Switch</H2 +NAME="AEN2397" +></A +>14.4.2. Microsoft Active Directory Services</H2 +><P +> Since late 2001, Samba has gained the ability to + interact with Microsoft Windows 2000 using its 'Native + Mode' protocols, rather than the NT4 RPC services. + Using LDAP and Kerberos, a domain member running + winbind can enumerate users and groups in exactly the + same way as a Win2k client would, and in so doing + provide a much more efficient and + effective winbind implementation. + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN2400" +></A +>14.4.3. Name Service Switch</H2 ><P >The Name Service Switch, or NSS, is a feature that is present in many UNIX operating systems. It allows system @@ -338,7 +372,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2278">15.4.3. Pluggable Authentication Modules</H2 +NAME="AEN2416" +></A +>14.4.4. Pluggable Authentication Modules</H2 ><P >Pluggable Authentication Modules, also known as PAM, is a system for abstracting authentication and authorization @@ -385,7 +421,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2286">15.4.4. User and Group ID Allocation</H2 +NAME="AEN2424" +></A +>14.4.5. User and Group ID Allocation</H2 ><P >When a user or group is created under Windows NT is it allocated a numerical relative identifier (RID). This is @@ -409,7 +447,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2290">15.4.5. Result Caching</H2 +NAME="AEN2428" +></A +>14.4.6. Result Caching</H2 ><P >An active system can generate a lot of user and group name lookups. To reduce the network cost of these lookups winbind @@ -430,7 +470,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2293">15.5. Installation and Configuration</H1 +NAME="AEN2431" +></A +>14.5. Installation and Configuration</H1 ><P >Many thanks to John Trostel <A HREF="mailto:jtrostel@snapserver.com" @@ -455,7 +497,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2300">15.5.1. Introduction</H2 +NAME="AEN2438" +></A +>14.5.1. Introduction</H2 ><P >This HOWTO describes the procedures used to get winbind up and running on my RedHat 7.1 system. Winbind is capable of providing access @@ -512,7 +556,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2313">15.5.2. Requirements</H2 +NAME="AEN2451" +></A +>14.5.2. Requirements</H2 ><P >If you have a samba configuration file that you are currently using... <SPAN @@ -580,7 +626,9 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2327">15.5.3. Testing Things Out</H2 +NAME="AEN2465" +></A +>14.5.3. Testing Things Out</H2 ><P >Before starting, it is probably best to kill off all the SAMBA related daemons running on your server. Kill off all <B @@ -623,7 +671,9 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2338">15.5.3.1. Configure and compile SAMBA</H3 +NAME="AEN2476" +></A +>14.5.3.1. Configure and compile SAMBA</H3 ><P >The configuration and compilation of SAMBA is pretty straightforward. The first three steps may not be necessary depending upon @@ -657,7 +707,7 @@ CLASS="PROMPT" >root#</TT > <B CLASS="COMMAND" ->./configure --with-winbind</B +>./configure</B > <TT CLASS="PROMPT" @@ -687,7 +737,9 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2357">15.5.3.2. Configure <TT +NAME="AEN2495" +></A +>14.5.3.2. Configure <TT CLASS="FILENAME" >nsswitch.conf</TT > and the @@ -790,7 +842,9 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2390">15.5.3.3. Configure smb.conf</H3 +NAME="AEN2528" +></A +>14.5.3.3. Configure smb.conf</H3 ><P >Several parameters are needed in the smb.conf file to control the behavior of <B @@ -815,7 +869,7 @@ include the following entries in the [global] section:</P ><PRE CLASS="PROGRAMLISTING" >[global] - <...> + <...> # separate domain and username with '+', like DOMAIN+username <A HREF="winbindd.8.html#WINBINDSEPARATOR" @@ -863,7 +917,9 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2406">15.5.3.4. Join the SAMBA server to the PDC domain</H3 +NAME="AEN2544" +></A +>14.5.3.4. Join the SAMBA server to the PDC domain</H3 ><P >Enter the following command to make the SAMBA server join the PDC domain, where <TT @@ -885,7 +941,7 @@ CLASS="PROMPT" >root#</TT > <B CLASS="COMMAND" ->/usr/local/samba/bin/net rpc join -S PDC -U Administrator</B +>/usr/local/samba/bin/net join -S PDC -U Administrator</B ></P ><P >The proper response to the command should be: "Joined the domain @@ -907,7 +963,9 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2417">15.5.3.5. Start up the winbindd daemon and test it!</H3 +NAME="AEN2555" +></A +>14.5.3.5. Start up the winbindd daemon and test it!</H3 ><P >Eventually, you will want to modify your smb startup script to automatically invoke the winbindd daemon when the other parts of @@ -1028,13 +1086,17 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2453">15.5.3.6. Fix the init.d startup scripts</H3 +NAME="AEN2591" +></A +>14.5.3.6. Fix the init.d startup scripts</H3 ><DIV CLASS="SECT4" ><H4 CLASS="SECT4" ><A -NAME="AEN2455">15.5.3.6.1. Linux</H4 +NAME="AEN2593" +></A +>14.5.3.6.1. Linux</H4 ><P >The <B CLASS="COMMAND" @@ -1091,7 +1153,7 @@ CLASS="PROGRAMLISTING" daemon /usr/local/samba/bin/winbindd RETVAL3=$? echo - [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] && touch /var/lock/subsys/smb || \ + [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] && touch /var/lock/subsys/smb || \ RETVAL=1 return $RETVAL }</PRE @@ -1117,7 +1179,7 @@ CLASS="PROGRAMLISTING" echo -n $"Shutting down $KIND services: " killproc winbindd RETVAL3=$? - [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] && rm -f /var/lock/subsys/smb + [ $RETVAL -eq 0 -a $RETVAL2 -eq 0 -a $RETVAL3 -eq 0 ] && rm -f /var/lock/subsys/smb echo "" return $RETVAL }</PRE @@ -1128,7 +1190,9 @@ CLASS="SECT4" ><H4 CLASS="SECT4" ><A -NAME="AEN2472">15.5.3.6.2. Solaris</H4 +NAME="AEN2610" +></A +>14.5.3.6.2. Solaris</H4 ><P >On solaris, you need to modify the <TT @@ -1157,7 +1221,7 @@ killproc() { # kill the named process(es) pid=`/usr/bin/ps -e | /usr/bin/grep -w $1 | /usr/bin/sed -e 's/^ *//' -e 's/ .*//'` - [ "$pid" != "" ] && kill $pid + [ "$pid" != "" ] && kill $pid } # Start/stop processes required for samba server @@ -1197,7 +1261,9 @@ CLASS="SECT4" ><H4 CLASS="SECT4" ><A -NAME="AEN2479">15.5.3.6.3. Restarting</H4 +NAME="AEN2617" +></A +>14.5.3.6.3. Restarting</H4 ><P >If you restart the <B CLASS="COMMAND" @@ -1219,7 +1285,9 @@ CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="AEN2485">15.5.3.7. Configure Winbind and PAM</H3 +NAME="AEN2623" +></A +>14.5.3.7. Configure Winbind and PAM</H3 ><P >If you have made it this far, you know that winbindd and samba are working together. If you want to use winbind to provide authentication for other @@ -1275,7 +1343,9 @@ CLASS="SECT4" ><H4 CLASS="SECT4" ><A -NAME="AEN2502">15.5.3.7.1. Linux/FreeBSD-specific PAM configuration</H4 +NAME="AEN2640" +></A +>14.5.3.7.1. Linux/FreeBSD-specific PAM configuration</H4 ><P >The <TT CLASS="FILENAME" @@ -1402,7 +1472,9 @@ CLASS="SECT4" ><H4 CLASS="SECT4" ><A -NAME="AEN2535">15.5.3.7.2. Solaris-specific configuration</H4 +NAME="AEN2673" +></A +>14.5.3.7.2. Solaris-specific configuration</H4 ><P >The /etc/pam.conf needs to be changed. I changed this file so that my Domain users can logon both locally as well as telnet.The following are the changes @@ -1476,7 +1548,7 @@ dtsession auth required /usr/lib/security/$ISA/pam_unix.so.1 >I also added a try_first_pass line after the winbind.so line to get rid of annoying double prompts for passwords.</P ><P ->Now restart your Samba & try connecting through your application that you +>Now restart your Samba and try connecting through your application that you configured in the pam.conf.</P ></DIV ></DIV @@ -1487,7 +1559,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2542">15.6. Limitations</H1 +NAME="AEN2680" +></A +>14.6. Limitations</H1 ><P >Winbind has a number of limitations in its current released version that we hope to overcome in future @@ -1498,7 +1572,7 @@ NAME="AEN2542">15.6. Limitations</H1 ><LI ><P >Winbind is currently only available for - the Linux operating system, although ports to other operating + the Linux, Solaris and IRIX operating systems, although ports to other operating systems are certainly possible. For such ports to be feasible, we require the C library of the target operating system to support the Name Service Switch and Pluggable Authentication @@ -1517,7 +1591,8 @@ NAME="AEN2542">15.6. Limitations</H1 ><P >Currently the winbind PAM module does not take into account possible workstation and logon time restrictions - that may be been set for Windows NT users.</P + that may be been set for Windows NT users, this is + instead up to the PDC to enforce.</P ></LI ></UL ></DIV @@ -1526,7 +1601,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2552">15.7. Conclusion</H1 +NAME="AEN2690" +></A +>14.7. Conclusion</H1 ><P >The winbind system, through the use of the Name Service Switch, Pluggable Authentication Modules, and appropriate @@ -1570,7 +1647,7 @@ WIDTH="33%" ALIGN="right" VALIGN="top" ><A -HREF="pdb-mysql.html" +HREF="improved-browsing.html" ACCESSKEY="N" >Next</A ></TD @@ -1594,7 +1671,7 @@ ACCESSKEY="U" WIDTH="33%" ALIGN="right" VALIGN="top" ->Passdb MySQL plugin</TD +>Improved browsing in samba</TD ></TR ></TABLE ></DIV |