QuantumAPI

Autenticazione

Ogni chiamata API richiede una credenziale. Usa una chiave API per servizi e script, o un token bearer OAuth/OIDC per i flussi utente.

Creato: 20 ottobre 2026 Aggiornato: 20 ottobre 2026 Platform v0.21.5

QuantumAPI accetta due tipi di credenziale. Le chiavi API sono per i tuoi backend, script, job CI e la CLI. I token di accesso OAuth 2.0 / OIDC sono per gli utenti autenticati e per le applicazioni di servizio che usano il flusso client-credentials. Scegline una per richiesta.

Chiavi API (header X-Api-Key)

Crea una chiave nel portale in Keys → API Keys e inviala nell'header X-Api-Key a ogni richiesta. La chiave da sola basta: nessuno scambio di token, nessuna sessione, nessuna seconda credenziale.

curl
curl https://api.quantumapi.eu/api/v1/secrets \
  -H "X-Api-Key: $QAPI_API_KEY"
  • Le chiavi iniziano con qapi_sk_ (segreta) o qapi_pk_ (pubblicabile). La chiave completa viene mostrata una sola volta: conservala nel tuo vault o nel secret store della CI.
  • URL di base: https://api.quantumapi.eu/api/v1.
  • La chiave identifica la tua organizzazione, quindi non serve inviare un header di tenant.
Non inviare una chiave API come Authorization: Bearer .... Le chiavi API vengono lette solo dall'header X-Api-Key; l'header Authorization: Bearer è riservato ai token di accesso OAuth/OIDC.

Scope

Ogni chiave porta un elenco di scope come secrets:read, keys:write, encrypt o qrng:read. Assegna a una chiave solo gli scope necessari all'applicazione: una chiave creata senza scope selezionati li riceve tutti. Una chiamata senza lo scope giusto restituisce 403:

Risposta 403
{
  "error": "insufficient_scope",
  "message": "The API key does not have the required scope 'secrets:read'.",
  "details": { "required_scope": "secrets:read" }
}

Token bearer OAuth 2.0 / OIDC

Per l'accesso degli utenti (authorization code con PKCE) e per l'accesso machine-to-machine, richiedi un token di accesso al server di identità QuantumID e invialo come Authorization: Bearer <token>. L'esempio usa un'applicazione di servizio e il flusso client-credentials.

curl
# 1. Exchange the client credentials of a service application for an access token
curl -X POST https://auth.quantumapi.eu/connect/token \
  -d "grant_type=client_credentials" \
  -d "client_id=$QAPI_CLIENT_ID" \
  -d "client_secret=$QAPI_CLIENT_SECRET" \
  -d "scope=api"

# 2. Send the access_token from the response as a Bearer token
curl https://api.quantumapi.eu/api/v1/secrets \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Caso d'usoCredenzialeHeader
Backend, script, job CI, CLIChiave APIX-Api-Key: qapi_sk_...
Applicazione di servizio (machine-to-machine)Token di accesso da client_credentialsAuthorization: Bearer <token>
Utente autenticato (web, mobile)Token di accesso da authorization code + PKCEAuthorization: Bearer <token>
La discovery per i client OIDC è disponibile su https://auth.quantumapi.eu/.well-known/openid-configuration; l'endpoint dei token è /connect/token.
Autenticazione | QuantumAPI Docs