Gegevens exporteren via FTP

Introductie

Exporteer alle Zivver-berichten die door je organisatie zijn verzonden en ontvangen voor archiveringsdoeleinden. Met deze methode kun je alle berichten exporteren via een FTP-verbinding. De FTP-methode is een verouderde aanpak en wordt niet aanbevolen voor nieuwe exports. Voor organisaties met een groot aantal berichten raden we aan om de API-methode te gebruiken om berichten te exporteren met een Python-script. Voor kleinere organisaties met een beperkt aantal berichten raden we aan om de Zivver WebApp-methode te gebruiken om alle berichten in een ZIP-bestand te exporteren via een Zivver-bericht.

Vereisten

We raden aan om FileZilla te gebruiken als FTP-client met de standaard verbindingsinstellingen, omdat dit het beste werkt met ons platform. FileZilla ondersteunt de vereiste configuratie:

  • Host: ftp.zivver.com
  • Encryptie: Explicit TLS
  • Poort: 21
  • Passieve poorten: 60000–60999 (alleen vereist bij gebruik van Passive Transfer Mode)

Verbinden

  1. Maak een supportticket aan om het exporteren van alle berichten voor je organisatie te laten inschakelen.
    Vermeld hierbij de methode FTP in je verzoek.

Nadat het exporteren van alle berichten voor je organisatie is ingeschakeld, kun je het exportproces starten:

  1. Log in op de Zivver WebApp.
  2. Klik op Organisatie-instellingen.
  3. Vouw Algemeen uit.
  4. Klik op Organisatieaccount.
  5. Scroll naar beneden naar Exporteer gebruikersdata.
  6. Kopieer de Host.
  7. Open je FTP-client en plak de gekopieerde Host.
  8. Ga terug naar Exporteer gebruikersdata.
  9. Kopieer de Gebruikersnaam.
  10. Open je FTP-client en plak de gekopieerde Gebruikersnaam.
  11. Genereer een Zivver API-sleutel.
  12. Gebruik in je FTP-client de gegenereerde API-sleutel als wachtwoord voor de FTP-verbinding.
  13. Zorg ervoor dat de verbinding poort 21 gebruikt.
  14. Zorg ervoor dat de verbinding Explicit TLS gebruikt voor encryptie.
  15. Zorg ervoor dat logging is ingeschakeld en lokaal wordt opgeslagen voor toekomstige referentie.
  16. Test de verbinding.

Je bent nu via FTP verbonden met Zivver. Je kunt Zivver-berichten downloaden als ongecodeerde .eml-bestanden.

Tip
Niet alle bestanden worden mogelijk direct succesvol overgedragen. Als dit gebeurt, klik met de rechtermuisknop op het tabblad Mislukte overdrachten linksonder en klik op Resetten en alles opnieuw in de wachtrij plaatsen om het opnieuw te proberen. Mogelijk moet je dit een paar keer doen.

Ordenen van de berichtbestanden

Berichten worden opgeslagen als EML-bestanden en bevatten eventuele bijlagen. De berichten worden ongecodeerd geëxporteerd, wat betekent dat je geen Zivver-client nodig hebt om ze te lezen.

In het exportbestand worden berichten gesorteerd op account, vervolgens op maand, op conversatie en op bericht. Een voorbeeld van de mapstructuur is:

v3
└── Account: johndoe@example.com
    └── Month: 202407
        └── Conversation: 20240705T120226Z_ee7f2e3j-w51j-642k-yt65-r3fb1233f07w
            └── Message
                ├── 0001_20240705T120226Z.eml
                ├── 0002_20240711T091921Z.eml
                └── 0003_20240711T092203Z.eml

Veelgestelde vragen

Fout: 530 Authentication failedWanneer je probeert verbinding te maken en de melding 530 Authentication failed krijgt, kan dit meerdere oorzaken hebben:
  1. Als dit je eerste poging is: verbinding maken via FTP met je Zivver-organisatie is waarschijnlijk nog standaard uitgeschakeld. Maak een supportticket aan om dit te laten inschakelen.
  2. Als je eerder succesvol FTP-export hebt gebruikt maar deze fout plotseling krijgt: de API-sleutel is mogelijk verwijderd of ongeldig geworden. De API-sleutel wordt gebruikt als wachtwoord voor de FTP-verbinding. Controleer dit en genereer indien nodig een nieuwe.
Fout: The data connection could not be established (ECONNREFUSED)Je kunt via FTP verbinding maken met je Zivver-organisatie, maar je kunt geen berichten overzetten. Je krijgt de foutmelding The data connection could not be established: ECONNREFUSED - Connection refused by server.

Dit probleem kan optreden wanneer de FTP-client is ingesteld op Passive Transfer Mode, maar de FTP-verbinding niet tot stand kan worden gebracht via het poortbereik 60000–60999. Mogelijk moet je in je firewall of proxy toestaan dat de FTP-client ftp.zivver.com via dit bereik kan bereiken.
Fout: Critical file transfer errorDe fout Critical file transfer error kan optreden wanneer je een .eml-bestand probeert over te zetten dat plotseling ontbreekt. Dit kan gebeuren tijdens een grote FTP-export als de intrekkingsdatum van een bericht is verstreken.
Sommige berichten ontbreken of zijn leeg in de conversatiemapAls je merkt dat sommige berichten ontbreken in de map van een specifieke conversatie, kan dit verschillende oorzaken hebben:
  1. Het bericht is ingetrokken. Ingetrokken berichten kunnen niet meer worden gelezen, waardoor het bestand leeg is in de FTP-export. Je ziet het woord DELETED in de bestandsnaam.
  2. Het bericht is ontvangen door een medewerker voordat je organisatie een eigen Zivver-organisatie had, en die medewerker heeft het bericht daarna nooit opnieuw geopend terwijl hij of zij een Zivver-account binnen je organisatie had. In dat geval is het bericht nog versleuteld met de guestsleutel. Pas wanneer de medewerker het bericht opnieuw opent met een Zivver-account, worden de sleutels vervangen door accountsleutels, waardoor beheerders van je organisatie deze berichten via FTP kunnen exporteren.
Sommige accounts ontbreken in de FTP-exportAls je merkt dat sommige accounts ontbreken in de FTP-export, kan dit meerdere oorzaken hebben:
  1. Het account is een guestaccount en maakt (nog) geen deel uit van je Zivver-organisatie. Controleer hoeveel accounts kunnen worden overgenomen voor domeinen die door je organisatie zijn geclaimd.
  2. Er is een master key reset uitgevoerd, maar de ontbrekende gebruikers hebben daarna niet ingelogd. Vraag deze gebruikers om in te loggen.
Is de FTP-verbinding veilig?De FTP-verbinding vereist Explicit TLS. Dit betekent dat de FTP-client eerst verbinding maakt en daarna een beveiligde SSL/TLS-verbinding opzet.
Hoe kunnen versleutelde berichten ongecodeerd worden geëxporteerd?De FTP-verbinding vereist een gegenereerde API-sleutel om verbinding te maken. Deze API-sleutel wordt gebruikt om de versleutelde berichten te ontsleutelen, zodat ze ongecodeerd kunnen worden geëxporteerd.
Hoe groot wordt de FTP-export?Als je FTP-client bestandswachtrijen ondersteunt, kun je de volledige map v3 in de wachtrij plaatsen. De FTP-client toont dan de totale grootte van de bestanden in de wachtrij.