Server Fault is a question and answer site for system and network administrators. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I've successfully setup HAProxy in front of an HTTP server which I have no control over.

Is it possible to configure HAProxy to add Simple HTTP Authentication to all sites, bearing in mind I can't configure this on the backend?



share|improve this question
up vote 22 down vote accepted

I had to do this today myself (because IIS 7.5 bizarrely doesn't actually support authenticating against anything but Windows user accounts or AD!)...

Here's all the code

userlist UsersFor_AcmeCorp
  user joebloggs insecure-password letmein

backend HttpServers
  .. normal backend stuff goes here as usual ..
  acl AuthOkay_AcmeCorp http_auth(UsersFor_AcmeCorp)
  http-request auth realm AcmeCorp if !AuthOkay_AcmeCorp

I documented it a bit better here:

share|improve this answer
+1 Just wanted to add that you can also add the final lines in a frontend definition rather than backend if you want. And the realm xxxx part is optional. – UpTheCreek May 1 '13 at 8:52

I think this is actually possible, but right now I can only find an example to get you halfway... is your bible.

Check out section 3.4 (Userlists)

It starts:

It is possible to control access to frontend/backend/listen sections or to http stats by allowing only authenticated and authorized users. To do this, it is required to create at least one userlist and to define users.

That section explains how to set up a userlist. The example in that section's quite exhaustive so copy that if you need to.

Next, need to figure out how to apply it... I think the answer lies in section 7.5.3 (Matching at Layer 7)

I think it might be as simple as using the following in an acl:

http_auth_group(userlist) <group> [<group>]*
  Returns true when authentication data received from the client matches
  username & password stored on the userlist. It is also possible to
  use http_auth_group to check if the user is assigned to at least one
  of specified groups.

Again, I haven't tested it, but that's what I read the documentation as suggesting is possible.

I hope that's enough to get you started?

share|improve this answer
Can I make a suggestion, you're bible should actually be -- it's approximately 147 times easier to read and navigate that the single massive txt file! – Coops Feb 24 '11 at 19:00
Good shout, i guess i'm just used to it now! – PriceChild Feb 25 '11 at 0:23
Although looking at it again, it doesn't seem to have been updated in months... I haven't checked for specific changes between that and the wall of text but assume there is some. – PriceChild Feb 25 '11 at 9:19
That 'better' bible link is 404'ing. Even better would be this . There you find HTML/text manual goodies. – Glenn Plas Aug 12 '14 at 9:25

If you're looking to do this for the purposes of authenticating an

option httpchk

config, this simpler solution works:

share|improve this answer
Welcome to Server Fault! While this may theoretically answer the question, it would be preferable to include the essential parts of the answer here, and provide the link for reference. – HopelessN00b Mar 27 '13 at 21:56

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.