source4/ntvfs/proxy/README

   1 This is the 'CIFS proxy' backend for Samba. It is based on the CIFS
   2 backend and may require changes made in the CIFS backend to be made
   3 here too. The proxy backend provides a caching and compressing CIFS
   4 proxy to a remote CIFS server, or even better, a remote CIFS proxy
   5 talking to a remote CIFS server. As a proxy pair, compression,
   6 caching and accelleration of CIFS connections may be obtained in
   7 a manner transparent to the CIFS client and server.
   8
   9 Based on the CIFS proxy there are three modes of operation:
  10   server config Password specified
  11   delegated credentials
  12   NTLM man-in-the-middle
  13
  14 Password specified is pretty useless except for testing or debugging.
  15
  16 Delegated credentials or NTML, along with wildcard shares allows the
  17 transparent proxy of all file shares on a remote server for all valid users.
  18
  19 If your incoming user is authenticated with Kerberos, and the machine
  20 account for this Samba4 proxy server is 'trusted for delegation', then
  21 the Samba4 proxy can forward the client's credentials to the target.
  22
  23 Otherwise NTML auth is done with the proxy as man-in-the-middle
  24
  25 You must be joined to the domain (net join <domain> member).
  26
  27 To set 'trusted for delegation' with MMC, see the checkbox in the
  28 Computer account property page under Users and Computers.
  29
  30 ; wildcard share
  31 [*]
  32         ntvfs handler = proxy
  33         proxy:server = myserver
  34         proxy:share = test
  35
  36