Il nodo critico del workflow
Se sei qui, è perché il tuo sistema continua a lanciare errori “ADM non autorizzato”. Qui la questione è semplice: la tua app non sta leggendo il token corretto, o il dominio non è stato registrato sul portale ADM. Ecco perché il processo di verifica è diventato il collo di bottiglia di ogni progetto.
Perché il dominio conta più del nome utente
Il dominio è l’identificatore unico, il biglietto da visita digitale che il server controlla prima di concedere ogni permesso. Non è una questione di “cosa scrivi”, ma di “dove lo scrivi”. Un dominio non registrato equivale a una porta chiusa a chiave: nessun token potrà mai passare.
Passo 1: Controllo rapido sul portale ADM
Accedi al portale, vai alla sezione “Gestione domini”. Qui troverai una lista, spesso lunga come una maratona, ma il tuo obiettivo è trovare il tuo nome di dominio. Se è assente, devi aggiungerlo subito, altrimenti il sistema ti tornerà a respingere ogni chiamata.
Passo 2: Verifica dell’autorizzazione
Una volta confermato il dominio, il passo successivo è la verifica dell’autorizzazione. Qui entra in gioco il token OAuth2. Genera un nuovo token, assicurandoti di includere lo scope “adm:read”. Se il token è stato creato con uno scope limitato, il server lo scarterà in un batter d’occhio.
Passo 3: Allineamento di configurazione
Nel file di configurazione della tua app (spesso config.yml o .env), devi inserire due variabili: ADM_DOMAIN e ADM_TOKEN. Nessuna variabile, nessuna magia. Un errore tipico è dimenticare le virgolette intorno al dominio, trasformando “mydomain.com” in “mydomaincom” e rompendo l’intera catena di richieste.
Il trucco che pochi conoscono
Se hai già registrato il dominio ma continui a ricevere “unauthorized”, prova a cancellare la cache del browser o, meglio ancora, usa una sessione privata. Alcuni browser memorizzano in maniera aggressiva le credenziali precedenti e ti restituiscono una risposta “falsa”.
Testare in ambiente di staging
Non buttare il codice in produzione prima di aver provato in staging. In quell’ambiente, imposta il dominio a “staging.miodominio.com” e verifica il token con lo stesso metodo. Se funziona, sei a posto; se no, il problema è altrove, forse nel certificato SSL.
Link utile
Per un approfondimento pratico, consulta la guida su verificare autorizzazione e dominio ADM. Troverai esempi di curl, screenshot del portale e checklist da spuntare.
Azioni immediate
Ora, prendi il tuo laptop, apri il portale ADM, aggiungi il dominio se manca, genera un nuovo token con gli scope corretti, aggiorna la configurazione e lancia un test di ping. Se il risultato è “200 OK”, il lavoro è fatto. Se no, ricontrolla la cache e ripeti. Non c’è tempo da perdere.