Slik fikser du autentiserings- og API-nøkkelfeil for Moonraker i Printer Tools
Feilsøking av Moonraker-autentisering
Det korte svaret
De fleste Moonraker-installasjoner på et pålitelig lokalt nettverk krever ingen legitimasjon i det hele tatt. Hvis din gjør det, på grunn av trusted_clients- eller force_logins-innstillinger i moonraker.conf, kan Printer Tools sende en API-nøkkel, en Bearer-token eller Basic Auth-legitimasjon med tilkoblingen, men de må samsvare nøyaktig med det Moonraker forventer, ellers avvises hver forespørsel.
Det du trenger
- Tilgang til moonraker.conf, eller til Mainsail eller Fluidd sine innstillinger, for å sjekke gjeldende autentiseringsoppsett
- Gjeldende API-nøkkel, Bearer-token eller Basic Auth-brukernavn og passord, avhengig av hva din Moonraker-installasjon bruker
- En Klipper-skriver som allerede er lagt til i Printer Tools
- Bekreftelse på om enhetens IP faller innenfor et eventuelt trusted_clients-område konfigurert i moonraker.conf
Løse en autentiseringsfeil
- 1
Sjekk om autentisering faktisk er nødvendig
Se på trusted_clients og force_logins i moonraker.conf. Hvis enhetens nettverk allerede faller innenfor et pålitelig område, skal det ikke være nødvendig med legitimasjon, og en autentiseringsfeil peker i stedet på et nettverks- eller IP-område-avvik.
- 2
Hent gjeldende legitimasjon
Generer eller kopier API-nøkkelen fra Moonrakers egne verktøy, vanligvis tilgjengelig gjennom Mainsail eller Fluidd sin innstillingsside, eller bekreft Bearer-token eller Basic Auth-brukernavn og passord konfigurert på serveren.
- 3
Angi den nøyaktig i Printer Tools
Åpne skriverens innstillinger i Printer Tools og angi legitimasjonen uten mellomrom foran eller bak. Ett ekstra tegn er nok til å forårsake en avvisning som ser identisk ut med en manglende nøkkel.
- 4
Koble til på nytt og sjekk resultatet
Koble til skriveren på nytt og bekreft at dashbordet laster. Hvis det fortsatt feiler, test samme legitimasjon direkte mot Moonrakers API med en enkel forespørsel for å bekrefte at selve nøkkelen er gyldig.
- 5
Regenerer nøkkelen hvis den ble mistet eller rotert
Hvis nøkkelen ble regenerert på serveren etter at du kopierte den, generer en ny og oppdater den overalt den brukes, inkludert Printer Tools og enhver annen Moonraker-klient.
Tilkoblingsstatus inne i Printer Tools
Autentiseringsfelt vises sammen med vertsadressen når du legger til eller redigerer en Klipper-skriver i Printer Tools.
Hva Printer Tools støtter
- En valgfri API-nøkkel sendt som en standard header med hver Moonraker-forespørsel
- Valgfri Bearer-token-autentisering for oppsett konfigurert på den måten
- Valgfritt Basic Auth-brukernavn og passord for oppsett konfigurert på den måten
- Ingen legitimasjon nødvendig i det hele tatt når nettverket ditt allerede er innenfor Moonrakers trusted_clients-område
Hva som ikke støttes
- Printer Tools implementerer ikke Moonrakers oneshot-token eller nettleserbaserte sesjonsinnloggingsflyt
- Den kan ikke oppdage eller generere en Moonraker API-nøkkel på egen hånd, nøkkelen må allerede eksistere på serveren
- En legitimasjon som er gyldig, men som ikke samsvarer med Moonrakers gjeldende konfigurerte metode, blir likevel avvist
Vanlige autentiseringsfeil
Ikke autorisert selv om en nøkkel ble angitt
Bekreft at nøkkelen ikke ble regenerert på serveren etter at du kopierte den, og se etter ekstra mellomrom eller skjulte tegn da den ble angitt i Printer Tools.
Det fungerte før og stoppet plutselig
En Moonraker-omstart kan rotere nøkkelen hvis den ikke er lagret korrekt, eller enhetens IP kan ha endret seg og ikke lenger falle innenfor et trusted_clients-område. Sjekk begge deler på nytt.
Basic Auth avvises
Bekreft at moonraker.conf faktisk definerer Basic Auth for oppsettet ditt i stedet for en API-nøkkel. Å sende feil type legitimasjon gir samme avviste resultat som å sende ingenting.
Autentisering fungerer i Mainsail eller Fluidd, men ikke i Printer Tools
Nettleserklienter er ofte avhengige av en sesjon opprettet etter et innloggingssteg. Printer Tools trenger i stedet den underliggende statiske API-nøkkelen, Bearer-tokenet eller Basic Auth-legitimasjonen.
Autentisering for fjerntilgang
Samme legitimasjon gjelder enten du kobler til direkte på ditt lokale nettverk eller via en VPN tilbake til det. OctoEverywhere og Obico håndterer sitt eget autorisasjonslag separat fra Moonrakers API-nøkkel.
Ofte stilte spørsmål
Er en API-nøkkel alltid nødvendig?
Nei. Mange lokale Moonraker-oppsett krever ikke en i det hele tatt. Den blir bare nødvendig hvis moonraker.conf håndhever autentisering for klienter utenfor trusted_clients.
Hvor finner jeg min Moonraker API-nøkkel?
Den er vanligvis tilgjengelig fra Mainsail eller Fluidd sin innstillingsside, eller direkte fra Moonrakers egen database hvis du administrerer serveren uten et webgrensesnitt.
Støtter Printer Tools Moonrakers innlogging og sesjonstokens?
Nei. Printer Tools bruker statisk legitimasjon, enten en API-nøkkel, en Bearer-token eller Basic Auth, i stedet for den interaktive sesjonsflyten nettleserklienter bruker.
Kan jeg fjerne autentisering helt?
Det avhenger av dine egne valg for moonraker.conf og nettverkssikkerhet. Printer Tools følger ganske enkelt hvilken autentisering Moonraker-instansen din for øyeblikket krever.
Påvirker endring av API-nøkkelen en pågående utskrift?
Nei. En pågående utskrift fortsetter på selve skriveren. Det er kun appens evne til å hente live-oppdateringer som påvirkes inntil riktig legitimasjon er angitt på nytt.
Relaterte veiledninger
Se full Klipper- og Moonraker-kompatibilitet
Gå gjennom støttede Moonraker-funksjoner, valgfrie krav til kamera og Spoolman, valg for fjerntilgang og gjeldende begrensninger.
Alle 3D-printerne dine i ett dashbord
Overvåk Bambu Lab-, Klipper-, OctoPrint-, Creality-, Snapmaker-, Anycubic-, Flashforge-, Elegoo- og Prusa-printere fra én app
Tilgjengelig på Android, iPhone, iPad og Mac, med følgeapper for Apple Watch og Wear OS og valgfri fjerntilgang via VPN, OctoEverywhere eller Obico
