Original work By Adrian Chadd

Updated by James Robertson 19.01.2012

Updated by Christopher Schirner 11.11.2014

 

Warning: Any example presented here is provided "as-is" with no support or guarantee of suitability. If you have any further questions about these examples please email the squid-users mailing list.

 

Contents

1. 14.  

 

Introduction

This wiki page covers setup of a Squid proxy which will seamlessly integrate with Active Directory using Kerberos, NTLM and basic authentication for clients not authenticated via Kerberos or NTLM.

If you are running Debian or would like more verbose instructions including access groups  may be of interest.

 

Example Environment

the following examples are utilised, you should update any configuration examples with your clients domain, hostnames, IP's etc. where necessary.

• Network

  • Domain= example.local

  • Subnet = 192.168.0.0/24

• Proxy Server

  • OS = GNU/Linux

  • Squid 3.1

  • IP = 192.168.0.10

  • HOSTNAME = squidproxy.example.local

  • Kerberos computer name = SQUIDPROXY-K

• Windows Server 1

  • IP = 192.168.0.1

  • HOSTNAME = dc1.example.local

• Windows Server 2

  • IP = 192.168.0.2

  • HOSTNAME = dc2.example.local

 

Prerequisites

Client Windows Computers need to have Enable Integrated Windows Authentication ticked in Internet Options Advanced settings.

 

DNS Configuration

On the Windows DNS server add a new A record entry for the proxy server's hostname and ensure a corresponding PTR (reverse DNS) entry is also created and works. Check that the proxy is using the Windows DNS Server for name resolution and update/etc/resolv.conf accordingly.

Edit the file according to your network.

domain example.localsearch example.localnameserver 192.168.0.1nameserver 192.168.0.2

Ping a internal and external hostname to ensure DNS is operating.

ping dc1.example.local -c 4 && ping google.com -c 4

Check you can reverse lookup the Windows Server and the local proxy ip from the Windows DNS.

dig -x 192.168.0.1

dig -x 192.168.0.10

The ANSWER SECTION should contain the the DNS name of dc1.example.local and squidproxy.example.local.

Important: If either lookup fails do not proceed until fixed or authentication may fail.

 

NTP Configuration

Time needs to be syncronised with Windows Domain Controllers for authentication, configure the proxy to obtain time from them and test to ensure they are working as expected.

 

Install and Configure Kerberos

Install Kerberos packages - on Debian these are krb5-user libkrb53

Edit the file /etc/krb5.conf replacing the variables with the your domain and servers.

Important: If you only have 1 Domain Controller remove the additional kdc entry from the [realms] section, or add any additional DC's.

Depending on your Domain Controller's OS Version uncomment the relevant Windows 200X section and comment out the opposing section.

[libdefaults]    default_realm = EXAMPLE.LOCAL    dns_lookup_kdc = no    dns_lookup_realm = no    ticket_lifetime = 24h    default_keytab_name = /etc/squid3/PROXY.keytab; for Windows 2003    default_tgs_enctypes = rc4-hmac des-cbc-crc des-cbc-md5    default_tkt_enctypes = rc4-hmac des-cbc-crc des-cbc-md5    permitted_enctypes = rc4-hmac des-cbc-crc des-cbc-md5; for Windows 2008 with AES;    default_tgs_enctypes = aes256-cts-hmac-sha1-96 rc4-hmac des-cbc-crc des-cbc-md5;    default_tkt_enctypes = aes256-cts-hmac-sha1-96 rc4-hmac des-cbc-crc des-cbc-md5;    permitted_enctypes = aes256-cts-hmac-sha1-96 rc4-hmac des-cbc-crc des-cbc-md5[realms]    EXAMPLE.LOCAL = {        kdc = dc1.example.local        kdc = dc2.example.local        admin_server = dc1.example.local        default_domain = example.local    }[domain_realm]    .example.local = EXAMPLE.LOCAL    example.local = EXAMPLE.LOCAL

Important notice: One should use "Windows 2008 with AES" if available. This is not just important for security reasons, but you might also experience problems when using the DNS name of the squid server instead of the IP address.

Example error messages regarding this issue may look like this:

ERROR: Negotiate Authentication validating user. Error returned 'BH gss_accept_sec_context() failed: Unspecified GSS failure.  Minor code may provide more information.'

 

Install Squid 3

We install squid 3 now as we need the squid3 directories available. Squid configuration takes places after authentication is configured. On Debian install the squid3 ldap-utils packages.

 

Authentication

The Proxy uses 4 methods to authenticate clients, Negotiate/Kerberos, Negotiate/NTLM, NTLM and basic authentication. Markus Moellers negotiate_wrapper is used for the 2 Negotiate methods.

 

Kerberos

Kerberos utilises msktutil an Active Directory keytab manager (I presume the name is abbreviated for "Microsoft Keytab Utility"). We need to install some packages that msktutil requires. On Debian install libsasl2-modules-gssapi-mit libsasl2-modules

Install msktutil - you can find msktutil here ""

Initiate a kerberos session to the server with administrator permissions to add objects to AD, update the username where necessary. msktutil will use it to create our kerberos computer object in Active directory.

kinit administrator

It should return without errors. You can see if you succesfully obtained a ticket with:

klist

Now we configure the proxy's kerberos computer account and service principle by running msktutil (remember to update the values with yours).

Important: There are 2 important caveats in regard to the msktutils --computer-name argument.

-computer-name cannot be longer than 15 characters due to netbios name limitations. See this link and this link for further information.

-computer-name must be different from the proxy's hostname so computer account password updates for NTLM and Kerberos do not conflict, see this  for further information. This guide uses -k appended to the hostname.

Execute the msktutil command as follows:

msktutil -c -b "CN=COMPUTERS" -s HTTP/squidproxy.example.local -k /etc/squid3/PROXY.keytab \--computer-name SQUIDPROXY-K --upn HTTP/squidproxy.example.local --server dc1.example.local --verbose

Important: If you are using a Server 2008 domain then add --enctypes 28 at the end of the command

Pay attention to the output of the command to ensure success, because we are using --verbose output you should review it carefully.

Set the permissions on the keytab so squid can read it.

chgrp proxy /etc/squid3/PROXY.keytabchmod g+r /etc/squid3/PROXY.keytab

Destroy the administrator credentials used to create the account.

kdestroy

On the Windows Server reset the Computer Account in AD by right clicking on the SQUIDPROXY-K Computer object and select "Reset Account", then run msktutil as follows to ensure the keytab is updated as expected and that the keytab is being sourced by msktutil from /etc/krb5.conf correctly. This is not completely necessary but is useful to ensure msktutil works as expected. Then run the following:

msktutil --auto-update --verbose --computer-name squidproxy-k

Note: Even though the account was added in capital letters, the --auto-update in msktutil requires the --computer-name to be lower case.

If the keytab is not found try adding -k /etc/squid3/PROXY.keytab to the command to see if it works and then troubleshoot until resolved or users will not be able to authenticate with Squid.

Add the following to cron so it can automatically updates the computer account in active directory when it expires (typically 30 days). Pipe it through logger so I can see any errors in syslog if necessary. As stated msktutil uses the default /etc/krb5.conf file for its paramaters so be aware of that if you decide to make any changes in it.

00 4  *   *   *     msktutil --auto-update --verbose --computer-name squidproxy-k | logger -t msktutil

Edit squid3's init script to export the KRB5_KTNAME variable so squid knows where to find the kerberos keytab.

On Debian the simplest way to do that is as follows:

Add the following configuration to /etc/default/squid3

KRB5_KTNAME=/etc/squid3/PROXY.keytabexport KRB5_KTNAME

 

NTLM

Install Samba and Winbind. On Debian install samba winbind samba-common-bin

Stop the samba and winbind daemons and edit /etc/samba/smb.conf

workgroup = EXAMPLEsecurity = adsrealm = EXAMPLE.LOCALwinbind uid = 10000-20000winbind gid = 10000-20000winbind use default domain = yeswinbind enum users = yeswinbind enum groups = yes

Now join the proxy to the domain.

net ads join -U Administrator

Start samba and winbind and test acces to the domain.

wbinfo -t

This command should output something like this:

checking the trust secret for domain EXAMPLE via RPC calls succeeded

wbinfo -a EXAMPLE\\testuser%'password'

Output should be similar to this.

plaintext password authentication succeededchallenge/response password authentication succeeded

Set Permissions so the proxy user account can read /var/run/samba/winbindd_privileged.

gpasswd -a proxy winbindd_priv

append the following to cron to regularly change the computer account password - Wiki note: Need to research if Samba does this automatically.

05  4  *   *   *     net rpc changetrustpw -d 1 | logger -t changetrustpw

 

Basic

In order to use basic authentication by way of LDAP we need to create an account with which to access Active Directory.

In Active Directory create a user called "Squid Proxy" with the logon name .

Ensure the following is true when creating the account.

• User must change password at next logon Unticked

• User cannot change password Ticked

• Password never expires Ticked

• Account is disabled Unticked

Create a password file used by squid for ldap access and secure the file permissions (substitute the word "squidpass" below with your password).

echo 'squidpass' > /etc/squid3/ldappass.txtchmod o-r /etc/squid3/ldappass.txtchgrp proxy /etc/squid3/ldappass.txt

 

Install negotiate_wrapper

Firstly we need to install negotiate_wrapper. Install the necessary build tools on Debian intall build-essential linux-headers-$(uname -r) Then compile and install.

cd /usr/local/src/wget "http://downloads.sourceforge.net/project/squidkerbauth/negotiate_wrapper/negotiate_wrapper-1.0.1/negotiate_wrapper-1.0.1.tar.gz"tar -xvzf negotiate_wrapper-1.0.1.tar.gzcd negotiate_wrapper-1.0.1/./configuremakemake install

 

squid.conf

Then setup squid and it's associated config files.

Add the following to your squid.conf.

Study and update the following text carefully, replacing the example content with your networks configuration - if you get something wrong your proxy will not work.

### /etc/squid3/squid.conf Configuration File ####### negotiate kerberos and ntlm authenticationauth_param negotiate program /usr/local/bin/negotiate_wrapper -d --ntlm /usr/bin/ntlm_auth --diagnostics --helper-protocol=squid-2.5-ntlmssp --domain=EXAMPLE --kerberos /usr/lib/squid3/squid_kerb_auth -d -s GSS_C_NO_NAMEauth_param negotiate children 10auth_param negotiate keep_alive off### pure ntlm authenticationauth_param ntlm program /usr/bin/ntlm_auth --diagnostics --helper-protocol=squid-2.5-ntlmssp --domain=EXAMPLEauth_param ntlm children 10auth_param ntlm keep_alive off### provide basic authentication via ldap for clients not authenticated via kerberos/ntlmauth_param basic program /usr/lib/squid3/squid_ldap_auth -R -b "dc=example,dc=local" -D squid@example.local -W /etc/squid3/ldappass.txt -f sAMAccountName=%s -h dc1.example.localauth_param basic children 10auth_param basic realm Internet Proxyauth_param basic credentialsttl 1 minute### acl for proxy auth and ldap authorizationsacl auth proxy_auth REQUIRED### enforce authenticationhttp_access deny !authhttp_access allow authhttp_access deny all