> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tester.army/llms.txt.
> For full documentation content, see https://docs.tester.army/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tester.army/_mcp/server.

# Auth Troubleshooting

Use this page when a test cannot authenticate into the app under test.

## Missing login credentials

If a test has a login step but no saved credential is available, add one under **Project → Test Accounts**.

See [Test Credentials](/auth/credentials).

## Saved credential rejected

If the app rejects a saved username or password:

1. Confirm the credential works in a normal browser.
2. Update the saved credential in TesterArmy.
3. Check whether the account is locked, expired, or requires password reset.
4. Retry the run.

## Email and OTP login

For magic links, OTP codes, invitations, or password resets, use an Agent Mail inbox.

See [Agent Mail Inboxes](/auth/agent-mail-inboxes).

## Unsupported auth blockers

Some auth flows need product or environment changes before an agent can complete them reliably:

* CAPTCHA or bot challenges
* Required MFA without an email/SMS test path
* Device approval prompts
* SSO policies that block automated browsers

Create a dedicated QA account or staging auth path for automated testing.

## HTTP Basic Auth

If the browser shows an HTTP Basic Auth prompt before your app loads, configure site protection credentials instead of app login credentials.

See [HTTP Basic Auth](/auth/basic-auth).