⚠️ If you're thinking of an admin user when adding authentications, please read this article first: Adding an admin user when adding Authentications
Selecting the authentication method
When you select Header Authentication you will be presented with the following modal. Header Authentications can be used to send a specific header to the endpoint with every request.
How to find the information
If you're unsure on where/how to find the information you need, please click the hyperlinks under 'Credentials' or refer to: Where to Find Required Information (at the bottom of this article).
Adding the credentials
Throughout this example we will be using
126.96.36.199 where we are hosting our test application, you may use a fully qualified domain name (FQDN) or IP address
In this example, we are starting our scan from the
/headers/ page of our application (
http://188.8.131.52/headers/). Unlike form-based authentication there is no login URL, instead the headers you define are sent with every request.
In our example we specify that there is a Logout URL which we want to exclude from scanning (
http://184.108.40.206/headers/logout). If your application uses Header Authentication, it's possible that you do not have a logout URL. Currently (v1.0) this field is mandatory, so you will need to provide some information here, you can set this path to something that definitely won't exist if needed to progress to the next stage.
We specify a
Header Name of
X-Auth-Token with the
Header Value set to
Bearer Tm90IGEgdmFsaWQgYXV0aCB0b2tlbg==. This is a standard bearer token which is used by many API endpoints. You can add multiple headers if you need.
It's worth noting that the header token needs to last long enough for a scan to run – we would recommend at least a few hours.
Once you've added the Authentication you should see it appear under Authentications on the Target Details page:
Where to Find Required Information
This section will explain where you can find the details that need to be entered when you're adding Authentications to a target.
The entrypoint URL tells the scanner where it should start all of it's crawling and scanning from. Most often this will be the root of your web application. Which in our example would be
http://220.127.116.11/ . Please note, there is not a path associated with the URL just a
/ on the end, which you should include if you want the full application to be scanned.
There are times when you won't want to scan from the root of the application, instead you might want to scan a subset. For example, when you have multiple applications running on the same target, but which live at different paths. For our example:
In this case, you would want to add 3 separate authentications each using one of the paths in the list.
The easiest way to find this would be to login to the application and find the Logout button on your page (it may say
Log Out or
Sign Out or something similar). If you hover over the button you'll see the Logout URL in in the bottom of your page, you can also right click and 'Save link address', then paste into Intruder. If that doesn't work, please see our extended explanation.