Strumenti Sviluppatore

La sezione Developer della Console Auris fornisce una suite di strumenti per sviluppare, testare e debuggare le integrazioni con Auris. Questi strumenti sono progettati per ridurre il tempo tra “voglio integrare Auris” e “l’autenticazione funziona nella mia applicazione”.

Accedi al Developer Hub da Console → Developer → Hub.

Panoramica del Developer Hub

Il Developer Hub è una landing page con sei card che collegano a ogni strumento per sviluppatori:

Inoltre, la pagina Developer Docs fornisce guide di riferimento inline con blocchi di codice per le attività di integrazione comuni.

API Explorer

L’API Explorer fornisce un riferimento sfogliabile di tutti gli endpoint API di Auris, organizzati in 9 sezioni. Accedi da Console → Developer → API Explorer.

Sezioni API

Usare l’API Explorer

Ogni sezione si espande per mostrare i singoli endpoint con:

• Metodo HTTP e percorso (es. POST /api/auth/token)
• Parametri della richiesta: Query parameter, path parameter e schema del corpo della richiesta
• Formato della risposta: Esempi di risposta in caso di successo e di errore
• Requisito di autenticazione: Quali endpoint richiedono un token Bearer e quali sono pubblici

L’API Explorer è uno strumento di riferimento — mostra il formato di richiesta e risposta ma non esegue chiamate API. Usa il Sandbox per i test live.

Token Decoder

Il Token Decoder consente di incollare qualsiasi JWT e vedere i suoi contenuti decodificati. Accedi da Console → Developer → Token Decoder.

Come Usarlo

{
  "alg": "RS256",
  "kid": "key-id-1",
  "typ": "JWT"
}

{
  "sub": "usr_abc123",
  "iss": "https://auth.tuaazienda.com",
  "aud": "il-tuo-client-id",
  "iat": 1739880000,
  "exp": 1739880900,
  "email": "[email protected]",
  "roles": ["editor"],
  "acr": "urn:auris:acr:mfa",
  "amr": ["pwd", "otp"]
}

Casi d’Uso Comuni

• Debug dei claim: Verifica che i custom claim, i ruoli e gli scope siano presenti nel token
• Verifica scadenza: Determina se un errore 401 è causato da un token scaduto
• Verifica ACR/AMR: Conferma che i claim di autenticazione step-up siano inclusi dopo l’MFA
• Ispezione token M2M: Controlla type: "m2m" e i claim scope per i token client credentials
• Validazione DPoP: Controlla il claim cnf.jkt nei token con binding DPoP

Sandbox

Il Sandbox fornisce un ambiente di test API live connesso al tuo tenant. Accedi da Console → Developer → Sandbox.

Come Funziona

Il Sandbox pre-compila gli header di autenticazione con il token della tua sessione admin corrente e l’header x-tenant con il tuo tenant ID. Puoi:

1. Selezionare un endpoint API dal dropdown (organizzato nelle stesse 9 sezioni dell’API Explorer)
2. Compilare i parametri della richiesta (path param, query param, body)
3. Cliccare Invia per eseguire la richiesta sull’API Auris live
4. Visualizzare il codice di stato, gli header e il body della risposta

Contesto Pre-compilato

Questo significa che puoi testare immediatamente gli endpoint senza costruire manualmente gli header.

Quickstart

La procedura guidata Quickstart fornisce istruzioni passo-passo per integrare Auris nella tua applicazione. Accedi da Console → Developer → Quickstarts.

Procedura Guidata Interattiva

La procedura guidata si articola in tre passaggi:

Strumento CLI

La pagina di riferimento CLI documenta l’interfaccia a riga di comando auris per gestire il tuo tenant da terminale. Accedi al riferimento da Console → Developer → CLI.

Comandi Disponibili

Installazione

npm install -g @auris/cli

Panoramica SDK

La pagina Panoramica SDK confronta le funzionalità tra i tre pacchetti SDK. Accedi da Console → Developer → SDKs.

Confronto Funzionalità

Guide Correlate

• SDK — Documentazione completa SDK
• Riferimento API — Documentazione completa degli endpoint API
• Applicazioni — Configura le applicazioni usate nei Quickstart
• Tutorial Avvio Rapido — Guida completa per iniziare