<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "Tor",
  "identifier" : "/documentation/Tor/TorError/controlAuthFailed(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Case",
  "symbol" : {
    "kind" : "Case",
    "modules" : [
      "Tor"
    ],
    "preciseIdentifier" : "s:3Tor0A5ErrorO17controlAuthFailedyACSScACmF"
  },
  "title" : "TorError.controlAuthFailed(_:)"
}
-->

# TorError.controlAuthFailed(_:)

A `AUTHENTICATE` command was rejected by Tor (reply code 515).

```
case controlAuthFailed(String)
```

## Discussion

Causes: wrong cookie file, invalid `HashedControlPassword`, or the
null-auth fallback attempted while `AUTHENTICATE_COOKIE_REQUIRED`
is enabled. See control-spec.txt §3.5. The payload carries Tor’s
response text. Not retryable without credential change.