Automation Framework - authentication

The Automation Framework supports a subset of the authentication mechanisms supported by ZAP.

Environmental Variables

ZAP supports a set of Authentication Header Environmental Variables - these will be applied by ZAP if they are defined however ZAP is run, including via the Automation Framework.

These environmental variables must be defined at the system level - if they are defined in the environment env section then they will be ignored.

Context Based Authentication

The Automation Framework supports the following methods of authentication supported by ZAP:

  • Manual (use this if you are using the Authentication Header Environmental Variable)
  • HTTP / NTLM

The remaining mechanisms will be supported soon.

Authentication Statistics

ZAP maintains authentication statistics - search for ‘auth’ in the key field on the ZAP Internal Statistics website page. These are ideal to use in tests to make sure the authentication is working as you expect.

The authentication statistics are maintained for all supported authentication methods (including ‘manual’) but only if you have configured all of the authentication elements correctly.
You are strongly advised to test this via the ZAP desktop GUI.

Configuring Authentication

The recommended way to configure authentication is to do so via the ZAP desktop GUI - this gives you complete control over all aspects and allows you to test it in place.
Then you can create a new Authentication Framework job using the context(s) you have tested - the authentication elements will be correctly initialised for all aspects supported.

It is worth noting that the authentication elements cannot be edited via the Automation Framework GUI, but they will not get lost if you use the GUI as long as you do not use it to delete the contexts.

The GUI will be updated to support all of the authentication elements in due course.