Immutable solution version
Scanning behind a login: form auth config plus cookie injection and logged-in indicators
Complete solution
What a coding agent needs to know about StackHawk here: Scanning behind a login: form auth config plus cookie injection and logged-in indicators.
To scan behind a login with HawkScan, configure both the login mechanics and the session proof. In stackhawk.yml under app.authentication, set usernamePassword with type: FORM, the login paths, the form field names, and the scan credentials; then add cookieAuthorization.cookieNames with your session cookie (e.g. JSESSIONID) so the scanner keeps the session. Add excludePaths: ["/logout"] so the spider does not log itself out mid-scan, set antiCsrfParam if your app uses CSRF tokens, and give the scanner a testPath with a success pattern plus loggedInIndicator/loggedOutIndicator regexes so it can verify it is actually logged in. Without the indicators, a scan can run fully unauthenticated and report a clean bill of health on pages it never reached.
Evidence
Real reported problem from web:github.com:stackhawk-form-auth: Web source (StackHawk's training-labs repo, legacy-training/MacOS-LinuxTrainingGuide.md on github.com): walks through configuring an authenticated HawkScan with form login plus cookie session injection. The config sets usernamePassword type FORM with loginPath/loginPagePath/usernameField/passwordField/scanUsername/scanPassword, then cookieAuthorization with the session cookie name, plus testPath with a success regex and loggedInIndicator/loggedOutIndicator patterns so the scanner can tell whether it is authenticated. The verified fix/answer: To scan behind a login with HawkScan, configure both the login mechanics and the session proof. In stackhawk.yml under app.authentication, set usernamePassword with type: FORM, the login paths, the form field names, and the scan credentials; then add cookieAuthorization.cookieNames with your session cookie (e.g. JSESSIONID) so the scanner keeps the session. Add excludePaths: ["/logout"] so the spider does not log itself out mid-scan, set antiCsrfParam if your app uses CSRF tokens, and give the scanner a testPath with a success pattern plus loggedInIndicator/loggedOutIndicator regexes so it can verify it is actually logged in. Without the indicators, a scan can run fully unauthenticated and report a clean bill of health on pages it never reached. Source: https://github.com/stackhawk/training-labs/blob/HEAD/legacy-training/MacOS-LinuxTrainingGuide.md
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_JVm6b7MlDrmNvyDLTs8kWg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Scanning behind a login: form auth config plus cookie injection and logged-in indicators <span>— Vectle</span></a>