Wazo · Authentication Profile

Wazo Authentication

Authentication

Wazo secures its APIs with apiKey and http across 2 declared security schemes, as derived from its OpenAPI definitions.

TelephonyVoIPUnified CommunicationsUCaaSContact CenterSIPasteriskWebRTCOpen-SourceSelf-HostedWhite LabelPBXMSPCall CenterProvisioningWebhookEvent-DrivenChatPresenceCDR

Methods: apiKey, http Schemes: 2 OAuth flows: API key in: header

Security Schemes

wazo_auth_token apiKey

· in: header (X-Auth-Token)

wazo_auth_basic http

scheme: basic

Source

Authentication Profile

generated: '2026-08-17'
method: searched
source: openapi/ (13 Swagger 2.0 contracts) + https://wazo-platform.org/uc-doc/api_sdk/rest_api/conventions + https://wazo-platform.org/uc-doc/api_sdk/rest_api/quickstart
  + https://api.wazo.io/documentation/api/authentication.html
summary:
  types:
  - apiKey
  - http
  api_key_in:
  - header
schemes:
- name: wazo_auth_token
  type: apiKey
  in: header
  parameter: X-Auth-Token
  sources:
  - openapi/wazo-agentd-api-openapi.yml
  - openapi/wazo-amid-api-openapi.yml
  - openapi/wazo-auth-api-openapi.yml
  - openapi/wazo-call-logd-api-openapi.yml
  - openapi/wazo-calld-api-openapi.yml
  - openapi/wazo-chatd-api-openapi.yml
  - openapi/wazo-confd-api-openapi.yml
  - openapi/wazo-dird-api-openapi.yml
  - openapi/wazo-phoned-api-openapi.yml
  - openapi/wazo-plugind-api-openapi.yml
  - openapi/wazo-provd-api-openapi.yml
  - openapi/wazo-setupd-api-openapi.yml
  - openapi/wazo-webhookd-api-openapi.yml
- name: wazo_auth_basic
  type: http
  scheme: basic
  sources:
  - openapi/wazo-auth-api-openapi.yml
docs: https://api.wazo.io/documentation/overview/authentication.html
model:
  style: opaque bearer token in a custom header, issued by a first-party token service
  header: X-Auth-Token
  oauth2: false
  oidc: false
  token_endpoint: POST https://{wazo_stack}/api/auth/0.1/token
  token_endpoint_auth: HTTP Basic username:password (the wazo_auth_basic scheme), or an existing refresh token
  recommended_user_purpose: external_api
  token_expiration: requested per token via the expiration field (seconds); tokens expire and must be renewed
  introspection:
  - HEAD /token/{token} — validity
  - GET /token/{token} — metadata incl. ACL list
  - POST /token/{token}/scopes/check — pre-flight an ACL
  revocation: DELETE /token/{token}
  refresh_tokens: GET /tokens lists refresh tokens created for the caller
  warning: The quickstart states that a manually generated token "gives all permissions to anyone who knows it" — Wazo ships
    no default least-privilege token. Scoping requires creating an ACL policy (POST /policies) and attaching it.
authorization:
  model: acl
  catalog: scopes/wazo-acl-permissions.yml
  permission_count: 788
  declaration: each operation states "**Required ACL:** `<string>`" in its own description
  wildcards:
    one_segment: '*'
    remainder: '#'
  multi_tenancy:
    header: Wazo-Tenant
    recurse_param: recurse
identity_backends:
  first_party:
  - wazo_user (username/password)
  federated:
  - LDAP — POST/GET /backends/ldap
  - SAML 2.0 — /saml/sso, /saml/acs, /saml/logout, /saml/sls, /backends/saml, /backends/saml/metadata
  external_auth:
  - Google
  - Microsoft
  - mobile push (FCM/APNs registration)
  source: openapi/wazo-auth-api-openapi.yml
mutual_tls: false
api_keys: false
api_keys_note: There is no long-lived API key. Programmatic access means minting a short-lived token from user credentials,
  or holding a refresh token.

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this

find_securityBrowse and filter every security artifact in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This security artifact

curl "https://apis.io/api/v1/security/wazo-authentication"

All security posture

curl "https://apis.io/api/v1/security?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.