Risolvere l'errore AADSTS900144 "Missing Parameter" in Azure AD

By Mirko Peters · 2026-04-21

Nessuno ama sbattere contro un muro quando si tratta di errori di autenticazione, ma l'errore AADSTS900144 di parametro mancante in Azure AD è uno di quegli ostacoli classici che fanno perdere la pazienza a tutti, dagli sviluppatori di app agli amministratori IT. Questo articolo ti spiega esattamente cosa c'è dietro l'errore, cosa controllare per primo e i passaggi necessari per riportare gli uten

Automatically translated with AI from the original post. Read the English original

Cover: Fix Microsoft Teams Governance Sprawl with Enforced Decisions

Che tu stia supportando Microsoft 365, Azure, Power Platform o qualsiasi soluzione che si collega a Entra ID, troverai suggerimenti sia per le correzioni lato client sia per quelle lato server. Troubleshooting su casi reali, best practice pronte per l'uso in azienda e link utili ai contenuti sulla governance cloud ti aiuteranno a prevenire grattacapi la prossima volta che questo errore si presenta.

Perché compare "AADSTS900144" nell'autenticazione di Azure AD?

L'errore "AADSTS900144: Request body must contain the following parameter" compare quando nella richiesta di autenticazione inviata ad Azure Active Directory (o Microsoft Entra ID) mancano dettagli fondamentali. In parole semplici, Azure cerca informazioni come grant_type o client_id nella richiesta di token e non le trova, oppure le trova ma sono formattate male o si trovano nel punto sbagliato.

Questo errore è più comune nei flussi OAuth 2.0, soprattutto quando utenti o app tentano di accedere con servizi cloud aziendali. di solito qualcosa non va nei parametri del corpo della richiesta inviata quando si scambia un codice di autorizzazione con un token. Se un parametro obbligatorio viene omesso, scritto in modo errato o inserito al di fuori del corpo POST previsto, Azure AD blocca tutto con il codice AADSTS900144.

Potresti vedere questo errore durante l'integrazione di app aziendali personalizzate, la registrazione di nuove app in Azure o quando i client desktop (come Microsoft Teams) incontrano problemi di autenticazione. A volte basta un errore di copia e incolla o un rapido aggiornamento della registrazione dell'app per far perdere la sincronia al parametro. Il messaggio può sembrare criptico, ma è il modo in cui Azure ti dice: "Torna indietro, ricontrolla la richiesta e correggi ciò che manca".

Per chi lavora con applicazioni multi-tenant, tieni presente che disallineamenti nel contesto del tenant o negli endpoint del servizio possono generare una confusione simile, facendo talvolta sembrare che manchi un parametro quando in realtà è stato semplicemente indirizzato male. Capire questi meccanismi rende la risoluzione dei problemi più rapida e meno stressante per i team di supporto.

Problemi comuni nei parametri del corpo della richiesta e correzioni rapide

L'errore AADSTS900144 quasi sempre dipende da qualcosa di omesso o inserito nel punto sbagliato nella richiesta di token. Gli elementi chiave come client_id e grant_type sono i sospettati più frequenti. Se l'app non invia anche solo uno dei parametri obbligatori, l'endpoint del token di Azure AD rifiuta la richiesta senza esitazioni. Verifica di usare il metodo HTTP POST, perché GET e altri verbi non funzionano in questo caso.

Per prima cosa, assicurati che l'app invii le richieste con il tipo di contenuto application/x-www-form-urlencoded. Capita spesso che un tipo di contenuto sbagliato porti Azure AD a cercare parametri che non riesce a leggere. Poi apri uno strumento per le richieste HTTP (Postman, curl o anche Fiddler) e ispeziona il corpo grezzo: client_id, grant_type, client_secret e gli altri parametri sono davvero nel payload, e non come valori della query string o nascosti negli header?

Se modifichi una registrazione di app, ricorda che i parametri previsti possono cambiare in base al flusso di concessione. Ad esempio, con il grant del codice di autorizzazione è necessario fornire anche code. Non sempre è ovvio, quindi confronta sempre il tipo di grant con la documentazione di Azure prima di considerare chiuso il problema.

Nelle app multi-tenant, fai attenzione a inviare richieste all'endpoint /common quando il tenant di destinazione richiede un GUID o un valore specifico: altrimenti il "parametro mancante" potrebbe essere solo una richiesta instradata male. Indirizzare le richieste all'URL sbagliato, soprattutto in scenari cross-tenant, può mettere in difficoltà anche sviluppatori esperti, quindi verifica sempre endpoint e parametri insieme. Risolvi questi punti e, nella maggior parte dei casi, il temuto AADSTS900144 scomparirà.

Troubleshooting lato client: pulizia delle credenziali in cache e reset delle app

A volte non è colpa del tuo codice, ma della macchina locale che compromette il flusso di autenticazione. Le credenziali memorizzate nella cache e i vecchi cookie possono conservare token obsoleti o corrompere i dati dei parametri, soprattutto nelle app desktop come Microsoft Teams o Outlook. Quando succede, gli utenti continuano a ricevere il messaggio AADSTS900144 anche dopo aver risolto i problemi lato back-end.

Il primo passo più semplice è cancellare le credenziali salvate. In Windows, usa Gestione credenziali per rimuovere i token memorizzati nella cache associati al tuo account. Nelle app web, eliminare i cookie del browser e i dati dei siti può avviare un nuovo processo di autenticazione pulito. Per i problemi più ostinati, soprattutto con Microsoft Teams, prova a eseguire un ripristino locale: esci da tutti i dispositivi, chiudi l'app, elimina le cartelle della cache e riavvia. Alcuni utenti potrebbero dover eliminare forzatamente il profilo account di Teams dalle impostazioni del dispositivo per essere sicuri che non rimanga alcuna traccia, per poi reinstallare Teams da zero.

Se supporti altri utenti, fornisci una checklist semplice: cancella le credenziali, chiudi l'app, svuota la cache e accedi di nuovo. Così si riducono i tempi di inattività e la confusione per gli utenti aziendali, che vogliono solo rimettere in funzione le proprie app. I team di supporto IT dovrebbero sempre verificare che tutti i vecchi dati di autenticazione siano stati eliminati prima di approfondire, perché i residui sono una delle cause principali degli errori AADSTS900144 persistenti.

Per chi si occupa della governance di Microsoft Teams o di problemi di autenticazione ricorrenti, è utile capire che le soluzioni tecniche da sole non "risolvono" la governance. Per approfondire perché la governance non è mai un traguardo definitivo e come renderla efficace nella pratica, leggi questa guida sulla governance di Teams e l'illusione del controllo oppure consulta questo playbook sull'automazione del ciclo di vita di Teams per strategie pratiche.

Best practice per prevenire AADSTS900144 nelle app aziendali

Prevenire l'errore AADSTS900144 dipende davvero dalla disciplina nella gestione delle richieste OAuth e delle configurazioni delle app. Fai l'abitudine di verificare tutti i parametri obbligatori, in particolare client_id e grant_type, prima di inviare le richieste all'endpoint del token di Azure AD. I controlli automatici nella pipeline di distribuzione possono individuare parametri mancanti o malformati prima che arrivino in produzione, risparmiandoti molti ticket in futuro.

Usa gli strumenti per sviluppatori di Microsoft Entra ID per simulare le richieste di autenticazione e vedere ciò che Azure AD riceve. Questo aiuta a individuare non solo i parametri mancanti, ma anche endpoint o criteri non corrispondenti che potrebbero bloccare richieste valide in tenant specifici. Configurare unit test con endpoint Entra ID simulati può ridurre ulteriormente le sorprese, facendo emergere i problemi sui parametri già in fase di sviluppo, non al momento del rilascio.

Per le organizzazioni con una governance complessa o più team di sviluppo, integra la validazione nelle pratiche di infrastructure-as-code. Usa controlli dello schema nei modelli di distribuzione ARM o Bicep per imporre l'inclusione di tutti i parametri OAuth obbligatori durante la registrazione dell'app. Questo riduce il rischio di disallineamenti e configurazioni errate, soprattutto man mano che le app evolvono.

Per un approccio orientato alla sicurezza, presta attenzione alle concessioni di consenso OAuth e all'applicazione dei criteri. Gli attaccanti sfruttano volentieri impostazioni di consenso troppo permissive, quindi limita il consenso degli utenti, richiedi editori approvati e applica i flussi di lavoro di amministrazione. Per un quadro solido su queste minacce e sulle misure di mitigazione, leggi questa analisi degli attacchi di consenso OAuth di Entra ID. Se stai migliorando i processi di governance, vale la pena usare automazione, RBAC e Azure Policy: consulta questa guida strategica sulla governance enterprise di Azure per indicazioni progettuali e controlli concreti.