Kirjoittanut George Curta ·
Vianmääritys ja usein kysytyt kysymykset
Korjaa yleiset anonym.legal Nextcloud-ongelmat: SSRF-sallittujen isäntien luettelon hylkäys, uuden version ilmoitus ja myös Basic-tason rajoitusvirheet.
Taustajärjestelmän API-URL hylätty (SSRF-sallittujen luettelo)
Sovellus kieltäytyy tallentamasta taustajärjestelmän API-URL:ää, tai pyynnöt epäonnistuvat URL-ei-sallittu-virheeseen.
Miksi näin tapahtuu
Molemmat sovellukset validoivat määritetyn taustajärjestelmän API-URL:n ajonaikaisesti validoitua sallittujen isäntien luetteloa (UrlGuard) vasten ennen minkään pyynnön tekemistä. Tämä SSRF-suoja on olemassa, jotta haitallinen tai väärin määritetty URL ei voisi koskaan saada sovelluksen Bearer-tokenia saavuttamaan hyökkääjän hallitsemaa isäntää. Vain anonym.legal ja anonymize.business (DEV-isäntä) ovat sallittuja — kaikki muut isännät hylätään, tarkoituksella.
Miten korjata
- 1.Käytä täsmälleen https://anonym.legal (tuotanto) tai https://anonymize.business (DEV) taustajärjestelmän API-URL:na.
- 2.Poista kaikki ylimääräiset polut, portit tai kirjoitusvirheet URL:sta — sallittujen luettelo täsmää isäntänimeen tarkalleen.
- 3.Jos uskot, että laillinen isäntä hylätään, ota yhteyttä tukeen — sallittujen luettelo ei tarkoituksella ole käyttäjän muokattavissa.
"Uusi versio saatavilla" -ilmoitus
Sovelluksen pääkäyttäjäasetukset näyttävät ilmoituksen, että uudempi versio on olemassa.
Miksi näin tapahtuu
Molemmat sovellukset tarkistavat säännöllisesti uudemman version ja näyttävät yksinkertaisen pääkäyttäjäilmoituksen, jossa on linkki muutoslokiin, kun sellainen on saatavilla. Tämä on manuaalinen päivitysilmoitus, ei automaattinen päivitys — mikään ei asennu itsestään Nextcloud-instanssiisi.
Miten korjata
- 1.Seuraa ilmoituksen muutoslokilinkkiä nähdäksesi, mikä muuttui.
- 2.Lataa uusi sovellusarkisto(t) GitHub releases -sivulta.
- 3.Pura apps/-hakemistoon ja suorita occ upgrade — samat manuaaliset asennusvaiheet kuin alkuperäisessä asennuksessa — omalla aikataulullasi.
403-virhe: "Basic-taso tai korkeampi"
Sovelluksen API-kutsut epäonnistuvat 403-tilalla ja viestillä Basic-tason tai korkeamman vaatimuksesta.
Miksi näin tapahtuu
Molemmat Nextcloud-sovellukset vaativat anonym.legal-tilin, jolla on Basic-taso tai korkeampi. Ilmaistaso ei sisällä API-käyttöoikeutta, josta nämä sovellukset ovat riippuvaisia, joten taustajärjestelmä palauttaa 403:n viestillä "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." hiljaisen epäonnistumisen sijaan.
Miten korjata
- 1.Vahvista, mihin anonym.legal-tiliin määritetty token kuuluu.
- 2.Päivitä kyseinen tili Basic-tasoon tai korkeampaan.
- 3.Yritä pyyntöä uudelleen — uudelleenasennusta tai -määritystä ei tarvita, kun tili on päivitetty.
Integraatio-token ei voi lukea salausavaimia — onko tämä bugi?
Pyyntö, joka yrittää hakea salauksesta purettua avainmateriaalia määritetyllä tokenilla, hylätään.
Miksi näin tapahtuu
Ei — tämä on tarkoituksellista. Näiden sovellusten käyttämä token on integraatiokohtainen token, joka on tarkoituksella rajoitetumpi kuin koko tilin API-token: se voi analysoida ja anonymisoida sisältöä, mutta jokainen päätepiste, joka palauttaisi salauksesta puretun avainmateriaalin, palauttaa 403:n integraatiokohtaiselle tokenille, jotta vaarantunutta Nextcloud-palvelinta ei koskaan voida käyttää palautettavan salaushistoriasi purkamiseen.
Mitä tehdä
- 1.Tämä on odotettua toimintaa, ei korjattava virhe — sovellukset eivät koskaan tarvitse salauksesta purettua avainmateriaalia analysoi/anonymisoi/palauta-työnkulkuunsa.
- 2.Jos työnkulku todella tarvitsee koko tilin käyttöoikeuden, käytä täyden laajuuden API-tokenia näiden sovellusten ulkopuolella, ympäristössä, jota itse hallitset.
Tarvitsetko yhä apua?
Jos mikään yllä olevista ratkaisuista ei toimi, ota meihin yhteyttä, niin autamme sinua ratkaisemaan ongelman.