Koppelprofiel Email: verschil tussen versies
(→Pop3Mailbox) |
|||
(14 tussenliggende versies door dezelfde gebruiker niet weergegeven) | |||
Regel 15: | Regel 15: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
− | !Titel | + | !style="width: 100px"| |
− | !Voorbeeld | + | !style="width: 150px"|Titel |
+ | !style="width: 150px"|Voorbeeld | ||
!Omschrijving | !Omschrijving | ||
|- | |- | ||
+ | |rowspan="6"| | ||
|Verzendadres | |Verzendadres | ||
− | |info@ | + | |info@example.com |
|Het e-mailadres dat als verzendadres wordt getoond aan de ontvanger. | |Het e-mailadres dat als verzendadres wordt getoond aan de ontvanger. | ||
|- | |- | ||
Regel 35: | Regel 37: | ||
|De ontvangende partij heeft een limiet voor de maximale grote die binnenkomende e-mails mogen hebben. Het is daarom belangrijk om de limiet voor uitgaande mails lager in te stellen dan hun binnenkomende limiet, zodat gewaarborgd is dat e-mails die (succesvol) vanuit zaaksysteem verstuurd worden ook daadwerkelijk geaccepteerd(/ontvangen) worden door de ontvangende partij. | |De ontvangende partij heeft een limiet voor de maximale grote die binnenkomende e-mails mogen hebben. Het is daarom belangrijk om de limiet voor uitgaande mails lager in te stellen dan hun binnenkomende limiet, zodat gewaarborgd is dat e-mails die (succesvol) vanuit zaaksysteem verstuurd worden ook daadwerkelijk geaccepteerd(/ontvangen) worden door de ontvangende partij. | ||
− | Let op: Een bestand zal als e-mailbijlage groter zijn. Het verschilt per bestand(stype), maar de e-mailbijlage is rond de 33% groter dan het oorspronkelijke bestand. Zie voor meer informatie | + | Let op: Een bestand zal als e-mailbijlage groter zijn. Het verschilt per bestand(stype), maar de e-mailbijlage is rond de 33% groter dan het oorspronkelijke bestand. Zie voor meer informatie [http://en.wikipedia.org/wiki/Email_attachment#Size_limits Email attachments - Size limits op Wikipedia]. |
Let op: De maximale grote voor een e-mail die vanuit Zaaksysteem verstuurd kan worden is 20 MB, ongeacht deze instelling. | Let op: De maximale grote voor een e-mail die vanuit Zaaksysteem verstuurd kan worden is 20 MB, ongeacht deze instelling. | ||
Regel 43: | Regel 45: | ||
|Gebruik de opgegeven (SMTP) mailserver voor uitgaande email, in plaats van de standaard-server die Zaaksysteem biedt. | |Gebruik de opgegeven (SMTP) mailserver voor uitgaande email, in plaats van de standaard-server die Zaaksysteem biedt. | ||
|- | |- | ||
+ | |DKIM-signatures genereren | ||
+ | | | ||
+ | |Laat Zaaksysteem uitgaande email-headers voor DKIM toevoegen, zodat ontvangers kunnen verifiën dat de email uit een vertrouwde bron komt. Bij [[#DKIM|DKIM]] worden de DNS-wijzigingen die hiervoor nodig zijn beschreven. | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- style="vertical-align:top;" | ||
+ | !style="width: 100px"| | ||
+ | !style="width: 150px"|Titel | ||
+ | !style="width: 150px"|Voorbeeld | ||
+ | !Omschrijving | ||
+ | |- | ||
+ | |rowspan="4"|Externe mailserver gebruiken | ||
|Hostname van externe mailserver | |Hostname van externe mailserver | ||
|smtp.gmail.com | |smtp.gmail.com | ||
Regel 55: | Regel 70: | ||
|De gebruikersnaam die Zaaksysteem zal gebruiken om aan te melden bij de externe mailserver | |De gebruikersnaam die Zaaksysteem zal gebruiken om aan te melden bij de externe mailserver | ||
|- | |- | ||
− | | | + | |Wachtwoord voor externe mailserver |
− | | | + | |************* |
|Het wachtwoord dat Zaaksysteem zal gebruiken om aan te melden bij de externe mailserver | |Het wachtwoord dat Zaaksysteem zal gebruiken om aan te melden bij de externe mailserver | ||
+ | |- | ||
+ | |rowspan="6"|DKIM-signatures genereren | ||
+ | |DKIM Afzenderdomein | ||
+ | |example.com | ||
+ | |Afzenderdomein voor DKIM-ondertekening. Wordt opgenomen in de DKIM-signature en door de ontvangende partij gebruikt foor verificatie van deze signature.<br>Dit is vrijwel altijd gelijk aan het deel van het afzender-emailadres achter het "@"-teken (dus als het afzenderadres "info@example.com" is, is het afzenderdomein "example.com"). | ||
+ | |- | ||
+ | |Eigen DKIM-sleutel gebruiken | ||
+ | | | ||
+ | |Zet dit aan, en configureer de "DKIM Private key" en "DKIM Selector" als je een eigen DKIM-sleutel wilt gebruiken in plaats van de standaard DKIM-sleutels van Zaaksysteem. | ||
+ | |- | ||
+ | |DKIM Private key | ||
+ | | | ||
+ | |Private key die gebruikt wordt om DKIM-signatures te genereren, in Base64 (PEM) formaat ("-----BEGIN RSA PRIVATE KEY-----"). | ||
+ | |- | ||
+ | |DKIM Selector | ||
+ | | | ||
+ | |De selector wordt samen met de domeinnaam opgeslagen in de DKIM-signature en wordt door de ontvangende partij gebruikt om de publieke sleutel op te vragen om de signature te verifiëren. | ||
+ | |- | ||
+ | |Algoritme voor DKIM-signature | ||
+ | |rsa-sha256 | ||
+ | |Algoritme dat gebruikt wordt om de signature te genereren. Zaaksysteem gebruikt altijd "rsa-sha256". | ||
+ | |- | ||
+ | |Methode voor DKIM-canonicalisatie | ||
+ | |relaxed | ||
+ | |Methode van "canonicalisatie" van de email voor het genereren van de signature. Zaaksysteem gebruikt altijd de methode "relaxed". | ||
|} | |} | ||
Let op: Als er specifieke verzendgegevens zijn opgegeven in een e-mailsjabloon dan krijgen die prioriteit.<br/> | Let op: Als er specifieke verzendgegevens zijn opgegeven in een e-mailsjabloon dan krijgen die prioriteit.<br/> | ||
Regel 64: | Regel 104: | ||
=== Forward inregelen bij IT-afdeling === | === Forward inregelen bij IT-afdeling === | ||
− | Wanneer u een lokaal emailadres (<i>bijvoorbeeld</i>iets@gemeentenaam.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: iets@omgevingsnaam | + | Wanneer u een lokaal emailadres (<i>bijvoorbeeld</i>iets@gemeentenaam.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: iets@omgevingsnaam.zaaksysteem.nl. Dit zorgt ervoor dat het bericht ook daadwerkelijk bij het zaaksysteem afgeleverd wordt. Een forward van emailadressen kan door uw IT-afdeling ingeregeld worden. |
+ | |||
+ | ==== DNS records voor SPF en DKIM ==== | ||
+ | SPF en DKIM zijn methodes om aan te geven welke mailservers toestemming hebben om email te sturen met afzender-adressen binnen een (afzender-)domein. | ||
+ | |||
+ | ===== SPF ===== | ||
+ | Als enkel met het Zaaksysteem-platform gemaild wordt: | ||
+ | <pre> | ||
+ | example.com. IN TXT "v=spf1 include:spf.zaaksysteem.nl -all" | ||
+ | </pre> | ||
− | + | Als er ook door andere mailservers gemaild wordt: | |
− | |||
<pre> | <pre> | ||
− | + | example.com. IN TXT "v=spf1 a:mail.example.com mx mx:some.othermailer.nl include:spf.zaaksysteem.nl -all" | |
</pre> | </pre> | ||
− | + | ||
+ | Zie voor meer informatie [https://en.wikipedia.org/wiki/Sender_Policy_Framework Sender Policy Framework op Wikipedia] | ||
+ | |||
+ | ===== DKIM ===== | ||
+ | Als je de DKIM-sleutels gebruikt die door Zaaksysteem beheerd worden, moeten de volgende regels toegevoegd worden aan de DNS van het domein dat gebruikt wordt als DKIM-afzenderdomein: | ||
+ | |||
<pre> | <pre> | ||
− | + | zaaksysteem1._domainkey.example.com. IN CNAME dkim1.zaaksysteem.nl. | |
+ | zaaksysteem2._domainkey.example.com. IN CNAME dkim2.zaaksysteem.nl. | ||
</pre> | </pre> | ||
+ | '' | ||
+ | ''Vervang'' '''''example.com''''' ''door het DKIM-afzenderdomein.'' | ||
− | + | Als deze instellingen gebruikt worden kan Zaaksysteem nieuwe DKIM-sleutels in gebruik nemen zonder verdere configuratie-wijzigingen in de DNS van de gemeente. | |
− | + | Om te controleren of de DNS goed is ingesteld ga je naar de volgende pagina [https://mxtoolbox.com/dkim.aspx MXTOOLBOX] vul hier bij "domain name" "''gemeente''.nl" in en bij "selector" "zaaksysteem1" in. | |
− | |||
− | Het is belangrijk om te weten dat de emails die naar het zaaksysteem gestuurd worden ook gecontroleerd worden op SPAM en | + | Zie voor meer informatie [https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail DKIM op Wikipedia] |
+ | |||
+ | === Mail-ontvangst (prefix voor onderwerp) === | ||
+ | Als deze koppeling actief is wordt er een willekeurige code toegevoegd aan het onderwerp van uitgaande email-berichten (<i>[Prefix 1458-ae34dc] <onderwerp></i>). Op deze manier kan een mail die beantwoord wordt door zaaksysteem herkend worden en als [[Nieuw contactmoment|Contactmoment]] aan de timeline van de zaak toegevoegd worden. De mail wordt tevens als PDF-bestand toegevoegd aan het tabblad documenten, waar ook eventuele bijlagen geplaatst worden. | ||
+ | |||
+ | Het is belangrijk om te weten dat de emails die naar het zaaksysteem gestuurd worden ook gecontroleerd worden op SPAM en virussen. Wanneer een mail niet door deze controle komt zal de informatie niet in het zaaksysteem komen. | ||
=== Eerste keer inrichten === | === Eerste keer inrichten === | ||
Regel 90: | Regel 150: | ||
= Pop3Mailbox = | = Pop3Mailbox = | ||
Wanneer bij de uitgaande mailconfiguratie gekozen wordt om gebruik te maken van een externe mailserver zullen antwoordmailtjes van klanten in de externe mailbox terecht komen. Deze koppeling stelt zaaksysteem in staat deze mailbox uit te lezen en de binnengekomen e-mails te verwerken alsof ze aan zaaksysteem verstuurd zijn. | Wanneer bij de uitgaande mailconfiguratie gekozen wordt om gebruik te maken van een externe mailserver zullen antwoordmailtjes van klanten in de externe mailbox terecht komen. Deze koppeling stelt zaaksysteem in staat deze mailbox uit te lezen en de binnengekomen e-mails te verwerken alsof ze aan zaaksysteem verstuurd zijn. | ||
+ | |||
+ | Bij het ophalen van de mails zal zaaksysteem de e-mail aan de bijbehorende zaak toevoegen wanneer deze een prefix bevat en deze zaak nog niet afgehandeld is. Als dit niet zo is zal de zaak verwerkt worden als een mail voor de 'Inkomende mailafhandeling'. | ||
=== Instellingen === | === Instellingen === | ||
Regel 100: | Regel 162: | ||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
|Protocol voor externe mailbox | |Protocol voor externe mailbox | ||
− | |<li>POP3S (POP3 over TLS) | + | |De opties zijn: |
+ | <li>POP3S (POP3 over TLS) | ||
<li>POP3 + STLS (RFC2595) | <li>POP3 + STLS (RFC2595) | ||
|Protocol dat gebruikt wordt om de externe mailbox te benaderen. | |Protocol dat gebruikt wordt om de externe mailbox te benaderen. | ||
Regel 119: | Regel 182: | ||
|- | |- | ||
|Wachtwoord | |Wachtwoord | ||
− | | | + | |************* |
|Wachtwoord waarmee ingelogd wordt op de mailbox. | |Wachtwoord waarmee ingelogd wordt op de mailbox. | ||
|} | |} | ||
Regel 151: | Regel 214: | ||
=== Forward inregelen bij IT-afdeling === | === Forward inregelen bij IT-afdeling === | ||
− | Wanneer u een lokaal emailadres (<i>bijvoorbeeld</i> vergunningen@mijn.gemeente.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: vergunningen@omgevingsnaam | + | Wanneer u een lokaal emailadres (<i>bijvoorbeeld</i> vergunningen@mijn.gemeente.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: vergunningen@omgevingsnaam.zaaksysteem.nl. Dit zorgt ervoor dat het bericht ook daadwerkelijk bij het zaaksysteem afgeleverd wordt. Een forward van emailadressen kan door uw IT-afdeling ingeregeld worden. |
=== Omgevingsloket === | === Omgevingsloket === | ||
− | Het omgevingsloket kent twee stappen van inrichten. Eerst richt je het [ | + | Het omgevingsloket kent twee stappen van inrichten. Eerst richt je het [[Koppelprofiel_Omgevingsloket|koppelprofiel omgevingsloket]] in, zorg er voor dat deze koppeling werkt. Vervolgens maak je, zoals op deze pagina beschreven ook het profiel inkomende email voor het omgevingsloket aan. Wanneer de optie 'omgevingsloket' gekozen is hoeft er geen zaaktype gekozen te worden. |
− | <i>Zie ook: [ | + | <i>Zie ook: [[Koppelprofiel_Omgevingsloket|Koppelprofiel Omgevingsloket]]</i> |
=== Documentintake === | === Documentintake === | ||
Regel 188: | Regel 251: | ||
= Ingeplande e-mail = | = Ingeplande e-mail = | ||
− | Deze 'koppeling' moet aanwezig zijn voor het [ | + | Deze 'koppeling' moet aanwezig zijn voor het [[Zaaktypebeheer_Regels#E-mail_versturen|Inplannen van e-mails]] |
Huidige versie van 21 feb 2019 om 15:12
Inhoud
Algemeen
Er zijn verschillende koppelprofielen beschikbaar die afzonderlijk of in combinatie gebruikt kunnen worden voor het versturen en/of ontvangen van e-mails met zaaksysteem:
Uitgaande mailconfiguratie
Het zaaksysteem biedt de mogelijkheid om uw uitgaande email te configureren. Dat wil zeggen dat u in staat bent aan te geven welk emailadres en welke benaming u gebruikt bij uitgaande emails.
Instellingen
Met deze koppeling kunnen de volgende gegevens zaaksysteembreed ingesteld worden voor de uitgaande mail:
Let op: Als er specifieke verzendgegevens zijn opgegeven in een e-mailsjabloon dan krijgen die prioriteit. |
Forward inregelen bij IT-afdeling
Wanneer u een lokaal emailadres (bijvoorbeeldiets@gemeentenaam.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: iets@omgevingsnaam.zaaksysteem.nl. Dit zorgt ervoor dat het bericht ook daadwerkelijk bij het zaaksysteem afgeleverd wordt. Een forward van emailadressen kan door uw IT-afdeling ingeregeld worden.
DNS records voor SPF en DKIM
SPF en DKIM zijn methodes om aan te geven welke mailservers toestemming hebben om email te sturen met afzender-adressen binnen een (afzender-)domein.
SPF
Als enkel met het Zaaksysteem-platform gemaild wordt:
example.com. IN TXT "v=spf1 include:spf.zaaksysteem.nl -all"
Als er ook door andere mailservers gemaild wordt:
example.com. IN TXT "v=spf1 a:mail.example.com mx mx:some.othermailer.nl include:spf.zaaksysteem.nl -all"
Zie voor meer informatie Sender Policy Framework op Wikipedia
DKIM
Als je de DKIM-sleutels gebruikt die door Zaaksysteem beheerd worden, moeten de volgende regels toegevoegd worden aan de DNS van het domein dat gebruikt wordt als DKIM-afzenderdomein:
zaaksysteem1._domainkey.example.com. IN CNAME dkim1.zaaksysteem.nl. zaaksysteem2._domainkey.example.com. IN CNAME dkim2.zaaksysteem.nl.
Vervang example.com door het DKIM-afzenderdomein.
Als deze instellingen gebruikt worden kan Zaaksysteem nieuwe DKIM-sleutels in gebruik nemen zonder verdere configuratie-wijzigingen in de DNS van de gemeente.
Om te controleren of de DNS goed is ingesteld ga je naar de volgende pagina MXTOOLBOX vul hier bij "domain name" "gemeente.nl" in en bij "selector" "zaaksysteem1" in.
Zie voor meer informatie DKIM op Wikipedia
Mail-ontvangst (prefix voor onderwerp)
Als deze koppeling actief is wordt er een willekeurige code toegevoegd aan het onderwerp van uitgaande email-berichten ([Prefix 1458-ae34dc] <onderwerp>). Op deze manier kan een mail die beantwoord wordt door zaaksysteem herkend worden en als Contactmoment aan de timeline van de zaak toegevoegd worden. De mail wordt tevens als PDF-bestand toegevoegd aan het tabblad documenten, waar ook eventuele bijlagen geplaatst worden.
Het is belangrijk om te weten dat de emails die naar het zaaksysteem gestuurd worden ook gecontroleerd worden op SPAM en virussen. Wanneer een mail niet door deze controle komt zal de informatie niet in het zaaksysteem komen.
Eerste keer inrichten
Wanneer de emailkoppeling voor het eerst ingericht wordt dan moet er een kleine wijziging in uw configuratie gemaakt worden door Mintlab. Neem dan ook contact op met Mintlab wanneer u deze koppeling voor het eerst gaan inrichten.
Pop3Mailbox
Wanneer bij de uitgaande mailconfiguratie gekozen wordt om gebruik te maken van een externe mailserver zullen antwoordmailtjes van klanten in de externe mailbox terecht komen. Deze koppeling stelt zaaksysteem in staat deze mailbox uit te lezen en de binnengekomen e-mails te verwerken alsof ze aan zaaksysteem verstuurd zijn.
Bij het ophalen van de mails zal zaaksysteem de e-mail aan de bijbehorende zaak toevoegen wanneer deze een prefix bevat en deze zaak nog niet afgehandeld is. Als dit niet zo is zal de zaak verwerkt worden als een mail voor de 'Inkomende mailafhandeling'.
Instellingen
Instellingen | Voorbeeld | Omschrijving |
---|---|---|
Protocol voor externe mailbox | De opties zijn:
|
Protocol dat gebruikt wordt om de externe mailbox te benaderen.
|
Hostname | pop.gmail.com | Hostname van de mailserver waar de mailbox te vinden is. |
Poort | 995 | Poort waarop de mailserver te bereiken is. Standaard "110" voor POP3 en "995" voor POP3S. |
Gebruikersnaam | zaaksysteemtest@gmail.com | Gebruikersnaam waarmee ingelogd wordt op de mailbox. |
Wachtwoord | ************* | Wachtwoord waarmee ingelogd wordt op de mailbox. |
Let op: De externe mailserver moet geconfigureerd zijn om POP3 toe te staan.
Inkomende mailafhandeling
Met deze koppeling kunnen op basis van e-mails die naar een zaaksysteemadres gestuurd worden nieuwe zaken gestart worden of bijlagen in de algemene documentintake geplaatst worden. Per emailadres/zaaktype moet een profiel aangemaakt worden welke een duidelijk herkenbare naam krijgen. Let op, het is handig als u eerst een uitgaande mailconfiguratie aanmaakt.
Instellingen
Instelling | Voorbeeld | Omschrijving |
---|---|---|
E-mailadres | vergunningen@mijn.gemeente.nl | Het e-mailadres waar de klant zijn e-mails naar toe stuurt |
Type interface | ||
Zaaktype | Het zaaktype waarvan er zaken aangemaakt moeten worden. |
Forward inregelen bij IT-afdeling
Wanneer u een lokaal emailadres (bijvoorbeeld vergunningen@mijn.gemeente.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: vergunningen@omgevingsnaam.zaaksysteem.nl. Dit zorgt ervoor dat het bericht ook daadwerkelijk bij het zaaksysteem afgeleverd wordt. Een forward van emailadressen kan door uw IT-afdeling ingeregeld worden.
Omgevingsloket
Het omgevingsloket kent twee stappen van inrichten. Eerst richt je het koppelprofiel omgevingsloket in, zorg er voor dat deze koppeling werkt. Vervolgens maak je, zoals op deze pagina beschreven ook het profiel inkomende email voor het omgevingsloket aan. Wanneer de optie 'omgevingsloket' gekozen is hoeft er geen zaaktype gekozen te worden.
Zie ook: Koppelprofiel Omgevingsloket
Documentintake
Wanneer de optie 'documentintake' gekozen is hoeft er geen zaaktype gekozen te worden. In dit geval worden enkel de bijlagen van de ontvangen mail in de documentintake geplaatst.
Zaaktype
Als een zaaktype gekozen is kunnen de kenmerken gekoppeld worden. Deze kenmerken worden dan ingevuld bij het aanmaken van de zaak.
Titel | Kenmerk type |
---|---|
subject | tekstveld |
from | tekstveld |
body | groot tekstveld |
Eerste keer inrichten
Wanneer de emailkoppeling voor het eerst ingericht wordt dan moet er een kleine wijziging in uw configuratie gemaakt worden door Mintlab. Neem dan ook contact op met Mintlab wanneer u deze koppeling voor het eerst gaan inrichten.
Instellingen