Hoe Externe Logo's in Factuur-pdf's Worden Geladen
In dit artikel
In veel webapps kan een logo dat er in de editor goed uitziet, ontbreken in de gedownloade pdf. De oorzaak zijn meestal de beveiligingsregels van de browser, niet het logo zelf. Invoice Generator voorkomt dat met een kleine afbeeldingsproxy op de server. Dit is wat die doet en wanneer hij wordt gebruikt.
Waarom een Logo van een Andere Website een Probleem Is
Je pdf wordt niet op onze servers gemaakt. De app tekent de factuur in een verborgen frame in je browser, zet die om naar een afbeelding en slaat die op als pdf. Browsers beperken dat soort tekenwerk: komt een afbeelding van een andere website die dat niet expliciet heeft toegestaan, dan mag de pagina de pixels niet uitlezen. Een logo dat direct van een andere website wordt gelinkt, zoals je eigen site of een afbeeldingshost, zou daardoor vaak ontbreken in de pdf of het maken van de pdf tegenhouden.
De Proxy Levert het Logo via Ons Eigen Adres
Om dat te voorkomen, past de pdf-stap het adres van het logo aan vlak voordat er wordt getekend. Is het logo een gewone weblink (http of https) naar een andere website, dan vervangt de app die door een link naar de eigen afbeeldingsproxy, met het oorspronkelijke adres erbij. Omdat de afbeelding dan van dezelfde site komt als de app, laat de browser de pdf-stap er gebruik van maken.
Logo's die dit niet nodig hebben, blijven ongewijzigd:
- Ingesloten afbeeldingsgegevens, zoals geüploade logo's en logo's in je bedrijfsprofiel worden opgeslagen, zijn al onderdeel van de pagina.
- Afbeeldingen op onze eigen site staan al op dezelfde site.
- Afbeeldingen in het geheugen van de browser komen van de pagina zelf.
In de praktijk is de proxy vooral van belang als er een logo-URL in een factuur is getypt en de factuur nog niet in een account is opgeslagen. Bij het opslaan in een account wordt een extern logo namelijk omgezet naar ingesloten afbeeldingsgegevens.
Wat de Proxy Controleert
De proxy stuurt niet zomaar alles door wat hij krijgt. Bij elk verzoek:
- Controleert hij of het adres een geldige http- of https-URL is, en weigert hij al het andere.
- Downloadt hij de afbeelding van de oorspronkelijke website.
- Controleert hij of het antwoord echt een afbeelding is, en weigert hij het anders, zodat een webpagina of bestand niet als logo kan worden doorgegeven.
- Handhaaft hij een limiet van 2 MB, eerst op basis van de grootte die de website opgeeft en daarna nog eens op de daadwerkelijke download, zodat een website die een verkeerde grootte opgeeft er niet omheen kan.
Mislukt een van deze controles, dan geeft de proxy een foutmelding terug in plaats van een afbeelding. De oplossing is dan om het logobestand direct te uploaden, zoals hieronder beschreven.
Caching en Limieten
Bij een geslaagd antwoord mag de browser de afbeelding 24 uur bewaren, zodat bij het downloaden van meerdere pdf's achter elkaar niet steeds hetzelfde logo wordt opgehaald. De proxy heeft een eigen limiet van 500 verzoeken per 15 minuten per IP-adres, los van de limiet voor de rest van de app, zodat veel pdf's maken niet ten koste gaat van de limiet die je voor al het andere nodig hebt.
De Betrouwbaarste Keuze
De proxy kan externe logo's aan, maar de betrouwbaarste keuze is nog steeds om je logobestand direct te uploaden of in je bedrijfsprofiel op te slaan. In beide gevallen wordt het bewaard als ingesloten afbeeldingsgegevens die bij de factuur horen, dus het hangt niet af van een andere website die online moet zijn, en het ziet er in de editor, in de pdf en op elke deellink hetzelfde uit. Houd het bestand klein en scherp, ruim onder de limiet van 2 MB, zodat pdf's snel gemaakt en verstuurd kunnen worden.
Gerelateerde Artikelen
Hoe een Factuur Wordt Opgeslagen: Eén Rij per Factuurregel, Plus een Volledige Kopie
Een opgeslagen factuur bestaat uit één databaserij per factuurregel, gekoppeld via een gedeeld groeps-ID, met op elke rij een volledige kopie van de factuur. Bij het opslaan van een wijziging worden al die rijen in één transactie vervangen.
Waarom Inlogpogingen Worden Beperkt
Inloggen, registreren, tweestapscontroles en het opnieuw versturen van verificatiemails delen een budget van 10 pogingen per uur per IP-adres. Dat is veel strenger dan de limiet voor gewone verzoeken in de app. Zo zit het met die verschillende getallen.
Hoe Registratie en E-mailverificatie Precies Werken
Bij het aanmaken van een account wordt in dezelfde databasetransactie een persoonlijke werkruimte opgezet. De verificatielink is 24 uur geldig, en wie op een verlopen link klikt, krijgt automatisch een nieuwe toegestuurd.
Hoe Je Logo Wordt Opgeslagen Wanneer Je Het Uploadt
Een logo dat als externe URL wordt geplakt, wordt server-side opgehaald, gecontroleerd tegen een limiet van 2MB en een echt afbeeldings-contenttype, en omgezet in een zelfstandige data-URL voordat het wordt opgeslagen.
Waarom Je Na Een Uur Wordt Uitgelogd
Elk sessietoken verloopt na precies één uur, en er is geen vernieuwingsmechanisme op de achtergrond dat het stilletjes verlengt — plus de ene bewuste uitzondering voor tweestapsverificatie-logins.
Hoe Klantenportaal-Links Verlopen
Een portaallink staat standaard op 30 dagen, controleert de vervaldatum bij elk verzoek in plaats van vooraf, en koppelt de documenten van een klant via een exacte vergelijking — niet via een database-sleutel.