Cum rezolvi erorile de autentificare și cheie API Moonraker în Printer Tools
Depanarea autentificării Moonraker
Răspunsul scurt
Majoritatea instalărilor Moonraker dintr-o rețea locală de încredere nu necesită deloc credențiale. Dacă a ta necesită, din cauza setărilor trusted_clients sau force_logins din moonraker.conf, Printer Tools poate trimite o cheie API, un token Bearer sau credențiale Basic Auth odată cu conexiunea, dar acestea trebuie să corespundă exact cu ceea ce așteaptă Moonraker, altfel fiecare cerere este respinsă.
De ce ai nevoie
- Acces la moonraker.conf-ul tău, sau la setările Mainsail sau Fluidd, pentru a verifica configurația actuală de autentificare
- Cheia API actuală, tokenul Bearer sau numele de utilizator și parola Basic Auth, oricare dintre acestea folosește instalarea ta Moonraker
- O imprimantă Klipper deja adăugată în Printer Tools
- Confirmarea dacă IP-ul dispozitivului tău se încadrează în orice interval trusted_clients configurat în moonraker.conf
Remediază o eroare de autentificare
- 1
Verifică dacă autentificarea este cu adevărat necesară
Verifică trusted_clients și force_logins în moonraker.conf. Dacă rețeaua dispozitivului tău se află deja într-un interval de încredere, nu ar trebui să fie necesare credențiale, iar o eroare de autentificare indică mai degrabă o nepotrivire de rețea sau interval IP.
- 2
Recuperează credențiala actuală
Generează sau copiază cheia API din propriile unelte ale Moonraker, disponibilă de obicei prin pagina de setări Mainsail sau Fluidd, sau confirmă tokenul Bearer ori numele de utilizator și parola Basic Auth configurate pe server.
- 3
Introdu-o exact în Printer Tools
Deschide setările imprimantei în Printer Tools și introdu credențiala fără spații la început sau la sfârșit. Un singur caracter în plus este suficient pentru a provoca o respingere identică cu absența unei chei.
- 4
Reconectează și verifică rezultatul
Reconectează imprimanta și confirmă că panoul se încarcă. Dacă tot eșuează, testează aceeași credențială direct pe API-ul Moonraker cu o cerere simplă pentru a confirma dacă cheia în sine este validă.
- 5
Regenerează cheia dacă a fost pierdută sau schimbată
Dacă cheia a fost regenerată pe server după ce ai copiat-o, generează una nouă și actualizeaz-o peste tot unde este folosită, inclusiv în Printer Tools și orice alt client Moonraker.
Statusul conexiunii în Printer Tools
Câmpurile de autentificare apar alături de adresa gazdei atunci când adaugi sau editezi o imprimantă Klipper în Printer Tools.
Ce acceptă Printer Tools
- O cheie API opțională trimisă ca header standard cu fiecare cerere Moonraker
- Autentificare opțională prin token Bearer pentru configurațiile setate astfel
- Nume de utilizator și parolă Basic Auth opționale pentru configurațiile setate astfel
- Nicio credențială necesară atunci când rețeaua ta se află deja în intervalul trusted_clients al Moonraker
Ce nu este acceptat
- Printer Tools nu implementează tokenul de unică folosință al Moonraker sau fluxul de autentificare prin sesiune de browser
- Nu poate descoperi sau genera singur o cheie API Moonraker, cheia trebuie să existe deja pe server
- O credențială validă dar care nu corespunde metodei configurate în prezent în Moonraker va fi în continuare respinsă
Erori frecvente de autentificare
Unauthorized chiar și după introducerea unei chei
Confirmă că cheia nu a fost regenerată pe server după ce ai copiat-o, și verifică spații suplimentare sau caractere ascunse la introducerea ei în Printer Tools.
Funcționa înainte și s-a oprit brusc
O repornire Moonraker poate schimba cheia dacă aceasta nu este persistată corect, sau IP-ul dispozitivului tău s-ar putea să se fi schimbat și să nu mai fie în intervalul trusted_clients. Verifică ambele situații.
Basic Auth este respins
Confirmă că moonraker.conf definește într-adevăr Basic Auth pentru configurația ta, și nu o cheie API. Trimiterea tipului greșit de credențială produce același rezultat respins ca și cum nu ai trimite nimic.
Autentificarea funcționează în Mainsail sau Fluidd, dar nu în Printer Tools
Clienții de browser se bazează adesea pe o sesiune creată după un pas de autentificare. Printer Tools are nevoie în schimb de cheia API statică, tokenul Bearer sau credențiala Basic Auth de bază.
Autentificarea pentru acces la distanță
Aceleași credențiale se aplică indiferent dacă te conectezi direct pe rețeaua ta locală sau printr-un VPN înapoi la ea. OctoEverywhere și Obico își gestionează propriul strat de autorizare separat de cheia API Moonraker.
Întrebări frecvente
Este întotdeauna necesară o cheie API?
Nu. Multe configurații Moonraker locale nu necesită deloc una. Devine necesară doar dacă moonraker.conf-ul tău impune autentificare pentru clienții din afara trusted_clients.
Unde găsesc cheia mea API Moonraker?
Este de obicei disponibilă din pagina de setări Mainsail sau Fluidd, sau direct din baza de date a Moonraker dacă administrezi serverul fără o interfață web.
Printer Tools acceptă tokenurile de autentificare și sesiune ale Moonraker?
Nu. Printer Tools folosește credențiale statice, o cheie API, un token Bearer sau Basic Auth, în loc de fluxul interactiv de sesiune folosit de clienții de browser.
Pot elimina complet autentificarea?
Asta depinde de moonraker.conf-ul tău și de alegerile tale de securitate a rețelei. Printer Tools urmează pur și simplu orice autentificare cere în prezent instanța ta Moonraker.
Schimbarea cheii API afectează o imprimare în curs?
Nu. O imprimare în curs continuă pe imprimantă. Este afectată doar capacitatea aplicației de a prelua actualizări live, până la introducerea din nou a credențialei corecte.
Ghiduri conexe
Vezi compatibilitatea completă cu Klipper și Moonraker
Verifică funcțiile Moonraker acceptate, cerințele opționale pentru cameră și Spoolman, opțiunile de acces la distanță și limitările actuale.
Toate imprimantele 3D într-un singur panou
Monitorizați imprimante Bambu Lab, Klipper, OctoPrint, Creality, Snapmaker, Anycubic, Flashforge, Elegoo și Prusa dintr-o singură aplicație
Disponibilă pe Android, iPhone, iPad și Mac, cu aplicații companion pentru Apple Watch și Wear OS și acces la distanță opțional prin VPN, OctoEverywhere sau Obico
