Feed Manager: aflevering en toegang
De feed op de server van een kanaal zetten met SFTP of FTP, en bepalen wie hem mag ophalen.
De meeste kanalen halen je feed zelf op via de publieke link. Sommige niet: een marktplaats die elke nacht een bestand op zijn eigen server wil, of een partner wiens firewall geen links van buiten ophaalt. Beide stel je in op het tabblad Instellingen van de feed, onder Het bestand afleveren.
De feed afleveren
Section titled “De feed afleveren”| Instelling | Wat het doet | Standaard | Wanneer aanpassen |
|---|---|---|---|
| Afleveren via | Alleen de URL (het kanaal haalt hem op), SFTP, of FTP en FTPS (FTP over TLS) | Alleen de URL | Als het kanaal om een bestand op zijn server vraagt |
| Hun server en Poort | Het adres van de server van het kanaal | leeg; poort leeg = 22 voor SFTP, 21 voor FTP | Vul in wat het kanaal opgeeft |
| Gebruikersnaam en Wachtwoord | Om in te loggen op hun server | leeg | Versleuteld opgeslagen en nooit teruggetoond. Laat het wachtwoord leeg om het huidige te houden. Inloggen met een SSH-sleutel kan niet. |
| Waar het landt | De map en de bestandsnaam op hun server | lege map; bestandsnaam leeg = feed-{nummer}.xml of .csv |
Als het kanaal een vaste naam of map wil |
| Passieve modus (FTP) | Hoe de FTP-verbinding wordt opgezet | aan | Bijna nooit; alleen als het kanaal het vraagt |
Ontbrekende mappen worden aangemaakt. Gewone FTP en FTPS staan alleen in de lijst als de server van Nexym ze ondersteunt; SFTP werkt altijd. Reageert hun server niet binnen 20 seconden, dan geldt hij als onbereikbaar.
Wanneer wordt er afgeleverd? Na elke geslaagde run, nooit tijdens een run. Wat er wordt afgeleverd, is precies het bestand achter de publieke link. De twee kunnen dus niet uit elkaar lopen. In testmodus wordt niets afgeleverd; dat begint pas als de module op Aan staat.
En als hun server niet bereikbaar is? Dan blijft je feed gewoon op de link staan. De run zelf is geslaagd, maar in Runs & logs staat hij als waarschuwing, met de reden: bijvoorbeeld “The server refused these credentials” (inloggegevens fout), “Could not reach the server” (server niet bereikbaar) of “The server accepted the login but refused the file” (map of schrijfrechten fout). Een geslaagde aflevering staat er ook, met de bestandsnaam, de grootte en de server. Er wordt niet opnieuw geprobeerd tot de volgende run.
Wie de feed mag ophalen
Section titled “Wie de feed mag ophalen”De lange code in de publieke link is het eerste slot: fm_pub_ met 32 willekeurige
tekens, niet te raden en niet vindbaar in zoekmachines. Een nieuwe code aanvragen kan
niet; wil je een link intrekken, verwijder dan de feed of zet er een wachtwoord of
IP-lijst op. Staan er marges, voorraad of inkoopprijzen in
je feed, dan wil je meer. Er zijn twee extra sloten.
| Instelling | Wat het doet | Standaard | Wanneer aanpassen |
|---|---|---|---|
| Om een wachtwoord vragen | Basic authentication — het kanaal vult het één keer in | uit | Als de feed gevoelige gegevens bevat |
| Gebruikersnaam en wachtwoord | Wat het kanaal moet invullen. Versleuteld opgeslagen; een leeg wachtwoord houdt het huidige. | leeg | Samen met de optie hierboven |
| Alleen vanaf deze adressen | Eén IP-adres of reeks per regel (een komma mag ook), bijvoorbeeld 198.51.100.0/24. Leeg betekent: iedereen met de link. |
leeg | Als het kanaal vaste IP-adressen opgeeft |
Een IP-adres is het adres van de computer die de feed ophaalt. Een reeks met een
schuine streep (zoals /24) betekent: alle adressen die met hetzelfde begin starten.
Reeksen werken alleen voor IPv4-adressen; een IPv6-adres vul je volledig in.
Het adres wordt als eerste gecontroleerd. Staat een verzoek niet op de lijst, dan krijgt het “niet gevonden” (404), niet de vraag om een wachtwoord. Wie er niet bij hoort, hoeft niet te weten dat er iets te raden valt. Staat het adres wel op de lijst (of is de lijst leeg) en vraagt de feed om een wachtwoord, dan krijgt het kanaal eerst die vraag.
Hoe vaak mag een feed opgehaald worden?
Section titled “Hoe vaak mag een feed opgehaald worden?”Een publieke link mag 60 keer per uur worden opgehaald, en vanaf één IP-adres 30 keer per minuut. Dat is ruim meer dan een kanaal nodig heeft: de meeste halen een feed één keer per uur of minder op. Wordt de grens gehaald, dan krijgt de vrager tijdelijk een “te veel verzoeken” (429).
Testen
Section titled “Testen”- Zet de aflevering aan en klik Nu draaien.
- Kijk in Runs & logs. Bij een geslaagde aflevering staat er wat er is gezet, hoe groot het was en waarheen.
- Test de toegang: open de feed-URL in een privévenster. Vraagt de feed om een wachtwoord, dan zie je die vraag. Sta je niet op de IP-lijst, dan krijg je niets.