Poche cose nell'IPTV sono esasperanti come incollare un username e una password che sai essere corretti e vedere il player rispondere "Authentication Failed". Due fatti rendono la cosa peggiore di quanto dovrebbe essere:
- L'errore è la stessa stringa per almeno otto cause sottostanti diverse, molte delle quali non hanno nulla a che fare con le tue credenziali.
- I player quasi mai ti dicono quale sia.
Questa guida te le presenta nell'ordine in cui vale la pena controllarle. Se prima di iniziare riesci a incollare le credenziali nella verifica credenziali Xtream, i primi tre passi vengono fuori da soli — lo strumento ti dice se l'autenticazione è davvero fallita, scaduta, o se hai sforato il limite di connessioni.
Una stringa di errore, otto cause sottostanti — il player non le sa distinguere, quindi la diagnosi è tua.
1. L'abbonamento è oltre la data di scadenza
È la singola causa più comune, e nella maggior parte dei player non sembra diversa da una password sbagliata. Xtream restituisce la stessa risposta auth: 0 in entrambi i casi.
La soluzione è chiedere al provider la nuova scadenza — o, se hai già rinnovato, aspettare un'ora e riprovare. Alcuni pannelli di controllo dei provider aggiornano il database secondo una pianificazione, non in tempo reale, e un account appena rinnovato può continuare a risultare scaduto per mezz'ora dopo che il pagamento è andato a buon fine.
Qui la verifica credenziali restituirà auth: expired, così puoi escludere questo caso con un clic.
2. Il limite di connessioni è pieno
La maggior parte degli abbonamenti Xtream è venduta con un tetto sulle connessioni — di solito 1, 2, 3 o 5 connessioni simultanee. Se sono tutte in uso, un nuovo tentativo di login viene rifiutato con lo stesso errore di autenticazione di una password sbagliata.
Il tranello: una connessione non sta sempre attivamente trasmettendo. I player che escono senza disconnettersi in modo pulito (la maggior parte lo fa) possono lasciare una connessione "fantasma" che il provider ripulisce solo dopo un timeout. Se hai cambiato dispositivo di recente, riavviato una TV, o se il Wi-Fi è caduto e si è riconnesso, è plausibile che tutti i tuoi slot siano occupati da fantasmi che in realtà non stanno trasmettendo nulla.
La soluzione: aspetta 5–10 minuti perché scatti il timeout a monte e riprova. Oppure contatta il provider e chiedi di azzerare le connessioni attive sul tuo account.
3. Nell'username c'è uno spazio invisibile
Incollare credenziali da un'email, da un forum o da uno screenshot include spesso caratteri invisibili: uno spazio iniziale, un a capo finale, uno spazio non separabile (U+00A0) dove l'utente pensava di aver digitato uno spazio normale. La maggior parte dei player non li ripulisce, e un username con un singolo a capo in coda è un username diverso dal punto di vista del provider.
Per verificare, incolla username e password in un editor di testo semplice. Sposta il cursore proprio in fondo a ciascuno. Se puoi fare backspace e cancellare un carattere invisibile prima che il cursore si fermi alla fine del testo visibile, è quello il tuo problema.
La verifica credenziali taglia esplicitamente gli spazi su server e username prima di inviarli a monte, quindi se ha successo dove il tuo player fallisce, la causa è quasi sicuramente questa.
4. L'URL del server ha un path in coda o una query string extra
Xtream Codes chiama un singolo endpoint a /player_api.php. Il tuo player costruisce l'URL completo aggiungendo quel path a quello che hai messo nel campo "server". Se hai incollato l'URL M3U completo (http://server.example/get.php?username=…&password=…&type=m3u_plus) nel campo server invece di solo http://server.example, il player finisce a chiamare /get.php?username=…&password=…&type=m3u_plus/player_api.php?…, e qualunque server restituirà 404 o HTML. Il player riporta poi "auth failed" perché non ha ricevuto JSON.
La soluzione è ridurre l'URL a solo http(s)://host:porta. Username e password vanno nei loro campi. Molti utenti hanno copiato l'URL M3U nel campo server almeno una volta.
5. Il server è HTTPS ma la catena di certificati è rotta
Alcuni provider fanno girare l'API Xtream su un certificato autofirmato o scaduto. La maggior parte dei player moderni si rifiuta di parlare HTTPS con un server che ha un certificato non valido, ma alcuni più vecchi fanno silenziosamente downgrade a HTTP e poi falliscono perché il provider ha smesso di servire HTTP il trimestre scorso.
La diagnosi: apri l'URL del server in un browser desktop. Se vedi un avviso sul certificato, il player ci sta sbattendo contro anche lui. La soluzione è passare l'URL del server da https://… a http://…, con l'ovvia controindicazione che la tua password ora viaggia in chiaro. Stuzzica il provider perché rinnovi il certificato; è un problema loro, non tuo.
6. Il tuo IP è bloccato
I provider regolarmente fanno geo-blocking del traffico dai Paesi con cui non hanno accordi, o applicano rate-limit a livello IP quando un account fa troppe connessioni in una finestra breve. Entrambe le cose, per il player, sono identiche: una risposta di autenticazione fallita.
Per verificare, prova le stesse credenziali da una rete diversa — hotspot del telefono, un altro Wi-Fi, o una VPN verso un Paese diverso. Se le credenziali funzionano altrove ma non dalla tua connessione di casa, il problema è il tuo IP.
La verifica credenziali chiama l'API lato server da un IP fisso, quindi una situazione "il checker dice sì, il mio player dice no" conferma che il problema è l'IP del tuo client, non le tue credenziali.
7. Il database del provider è in manutenzione / migrazione
Le migrazioni periodiche dei provider rompono il login Xtream per ore intere. Sintomi: ogni account Xtream sullo stesso provider restituisce auth-failed simultaneamente. Non c'è modo di distinguerlo dal fatto che le tue credenziali siano state revocate se non aspettando e riprovando, o chiedendo su un forum dove altri clienti dello stesso provider l'hanno notato.
Se hai un URL M3U oltre alle credenziali Xtream (la maggior parte dei provider rilascia entrambi), l'M3U spesso continua a funzionare durante la migrazione perché è servito da un percorso di codice diverso. Passare all'URL M3U è un aggiramento veloce finché l'API non torna su.
8. Le credenziali sono davvero sbagliate
È il caso noioso ma è comunque reale. Il provider le ha invalidate. Il provider le ha ruotate dopo un incidente di pagamento. Stai usando le credenziali del mese scorso e ne hai ricevuto un nuovo set al rinnovo.
Come capirlo: accedi al portale clienti del tuo provider (quasi ogni provider Xtream ne ha uno) e copia nel form le credenziali mostrate lì. Se quelle funzionano e quelle che usavi no, hai la tua risposta.
Come si inserisce la verifica credenziali
La verifica credenziali Xtream su questo sito distingue automaticamente tra i casi 1, 2 e 8 (i più comuni):
auth: ok+ numeri nel pannello in cima → le credenziali sono buone. Il problema è il tuo player o la tua rete — prova i casi 4–7.auth: expired→ caso 1. Rinnova o contatta il provider.auth: failed→ caso 8. Le credenziali sono davvero sbagliate.- Avviso di limite di connessione → caso 2. Aspetta o chiedi al provider di azzerare le connessioni.
upstream_timeout/upstream_unreachable→ caso 6 o 7. Il server in sé non è raggiungibile da un IP pubblico, quindi il problema non è proprio l'autenticazione.
Lanciare la verifica una volta prima di mettersi a fare debug sul player risparmia in media circa venti minuti di trafficare. Esclude anche del tutto la domanda "è il provider giù?" — se il nostro server riesce a parlare col loro, il loro è su.
Cosa fare quando conosci la causa
Per credenziali che davvero funzionano (casi 1–7 in cui hai identificato la soluzione), Klipa supporta sia il login Xtream sia l'URL M3U fianco a fianco nella stessa libreria. Se l'API Xtream del tuo provider è ballerina ma l'export M3U è in salute, aggiungili entrambi — uno tiene viva la lista canali quando l'altro si rompe. Vedi il confronto Xtream vs M3U per decidere da quale interfaccia partire.
Se hai passato in rassegna tutti e otto i casi e le credenziali davvero non funzionano da nessuna parte — compresi il checker, il portale clienti e una rete diversa — il problema è dalla parte del provider e dal tuo lato non c'è altro da debuggare.