Skip to content
Ask Questions

Authentication

piespector currently supports these auth types:

  • No Auth
  • Basic Auth
  • Bearer Token
  • API Key
  • Cookie Auth
  • Custom Header
  • OAuth 2.0

Sends no auth-specific headers or query parameters.

Sends Authorization: Basic ... using the configured username and password.

If you add an explicit Authorization header in Headers, that explicit header wins.

Sends an Authorization header using:

  • Header Prefix
  • Token

The default prefix is Bearer, but it can be changed.

API key auth can be applied in one of two places:

  • request header
  • query string

If you already set the same header or query parameter explicitly, the explicit value wins.

Cookie auth sends the configured cookie name and value inside the Cookie header.

Custom Header auth sends a single configured header name and value.

If the same header is also present in Headers, the explicit header wins.

The current OAuth support is OAuth 2.0 Client Credentials.

It fetches a bearer token from the configured token endpoint at send time, then uses that token on the real request.

OAuth 2.0 currently supports:

  • Token URL
  • Client ID
  • Client Secret
  • Client Auth
  • Header Prefix
  • optional Scope

Client Auth can be sent in one of two ways:

  • Basic Auth header
  • Send creds in body

Header Prefix defaults to Bearer, but it can be changed.

In previews, piespector shows an inferred Authorization header with a placeholder token. At send time it fetches the real token first.

Authentication is edited from the Auth section on Home, alongside Info, Params, Headers, Body, and Settings.

Placeholder completion is available in text auth fields with Tab.