CSNCurrent de:5931844

Ab der CS4N Version 2.8.0 besteht die Möglichkeit, die CS4N Funktionalität auch direkt in die Standard E-Mail Maske des persönlichen Postfachs zu integrieren. Dies bedeutet, dass die gesamte Funktionalitäten, die in der CS4N Memo-Maske zur Verfügung stehen, direkt in die Standard E-Mail Maske eingebunden werden können. Somit können die Anwender direkt aus ihrem Mailpostfach heraus CS4N E-Mails versenden, ohne die Anwendung wechseln zu müssen. Durch die Integration wird eine erleichterte Handhabung und somit eine größere Akzeptanz zur Verwendung der sicheren Dateiübertragung via CS4N beim Anwender gewährleistet. Hierzu müssen jedoch Erweiterungen an der bestehenden E-Mail Schablone vorgenommen werden.

Erforderliche Clients und Berechtigungen für die Implementierung

Es werden der Notes Designer und entsprechende Entwickler-Rechte für die Änderungen an der E-Mail Schablone benötigt.
Es werden der Domino Administrationsclient und entsprechende Administrationsrechte zur Erstellung der notwendigen Domino Serverregel benötigt.

Voraussetzungen

Damit die Kommunikation zwischen der Erweiterung im E-Mail Template und der CS4N Konfiguration funktioniert, müssen folgende Punkte berücksichtigt werden:

Es müssen drei NOTES.INI Einträge zur Kommunikation zwischen Client und CS4N Anwendung auf dem Anwenderclient vorhanden sein.
Eine Domino Serverregel zur Weiterleitung der E-Mail muss vorhanden sein.

Möglichkeiten zur Erstellung der NOTES.INI Einträge auf dem Notes Client

Mittels SmartIcon Roll-Out per E-Mail:

Wird das CS4N Smarticon auf dem Client installiert, werden automatisch auch alle notwendigen INI Einträge erstellt.

Manuell eintragen:

Die INI Einträge können manuell eingetragen und/oder per Notes Policy ausgerollt werden. Die folgenden drei INI Einträge müssen auf dem Client des Anwenders vorhanden sein:

INI Variablenname	Beschreibung
$BEFINE_ContentLanguage	Beinhaltete die Clientsprache des aktuellen Anwenders. Beispiel: $BEFINE_ContentLanguage = DE
$BEFINE_CS4LNServer	Beinhaltet den Domino Servernamen, auf welchem CS4N installiert wurde. Beispiel: $BEFINE_CS4LNServer = befineDemoV01/Befine/DE
$BEFINE_CS4LNApp	Beinhaltet den relativen Pfad vom DATA Verzeichnis des Domino Servers zur CS4N Anwendung Beispiel: $BEFINE_CS4LNApp = befine\CS4N\cryptshare.nsf

Domino Serverregel einrichten

Auf dem Domino Server muss eine Serverregel eingerichtet werden, um die E-Mails, die via CS4N versendet werden sollen, in die CS4N Anwendung weiterzuleiten. Die E-Mail Template Erweiterung fügt beim Senden eine konfigurierbare Texterweiterung im Betreff hinzu. Diese wird von der Domino Serverregel erkannt wird und die E-Mail in die CS4N Anwendung weitergeleitet. In der CS4N Anwendung wird diese Betreff-Erweiterung dann wieder entfernt.

Regeln im Domino Directory anlegen

Regeln für die automatische Verarbeitung können im Domino Directory angelegt werden. Öffnen Sie dazu den Domino Administrator Client auf dem Reiter "Konfiguration". Öffnen Sie den Bereich "Nachrichten" - "Konfiguration" in der Navigation. Öffnen Sie das Konfigurationsdokument des betreffenden Servers und versetzen Sie dieses in den Bearbeiten-Modus. Im Konfigurationsdokument befinden sich die Einstellungen für Regeln im Bereich "Router/SMTP" - "Restrictions and Controls" - "Rules".

Beispiel Serverregel Die Absender-Adresse muss die eigene Domino Domäne beinhalten (damit keine eingehenden Mails von Extern berücksichtigt werden) und im Betreff muss die Texterweiterung `[CS4N]` stehen (Konfiguration Texterweiterung). Wenn diese Bedingungen zutreffen, wird die E-Mail in die Anwendung cryptshare.nsf kopiert.

Nach der Erstellung der Domino Serverregel sollte der Domino Router-Task neu gestartet werden.

Im Sub-Register "Regelbasierte E-Mail Einlieferung" der CS4N Konfiguration wird definiert, wie mit E-Mails, die per Domino-Serverregel eingeliefert werden, verfahren werden soll.

Technische Einbindung

Hier werden die einzelnen Schritte beschrieben, wie Sie die Erweiterung in wenigen Schritten in Ihre E-Mail Schablone integrieren.

Öffnen Sie das CS4N Template "-T- Cryptshare Library V2.11.2.ntf" im Notes Designer

Das Design der Scriptbibliothek ist ausgeblendet. Speichern Sie niemals die Scriptbibliothek neu ab oder kompilieren Sie das E-Mail Template, da es sonst zu Fehlermeldungen kommen wird.

Kopieren Sie die Scriptbibliothek in den gleichnamigen Bereich (Code --> Scriptbibliotheken) in Ihr E-Mail Template.

Kopieren Sie die Teilmaske in Ihr E-Mail Template (Gemeinsame Elemente --> Teilmasken).

Kopieren Sie die vier Grafikelemente in Ihr E-Mail Template (Ressourcen --> Bilder).

Kopieren Sie den Agenten "Cryptshare-CS4N-IncomingMail-Encryption" in Ihr E-Mail Template.

MailIn Agent

Speichern Sie nach dem Einfügen des Agenten in das E-Mail Template diesen einmalig ab. Öffnen Sie hierzu den Agente per Doppelklick, fügen Sie ein Leerzeichen und/oder Zeilenumbruch ein und speichern sie den Agenten danach.
Die Signatur des Agenten muss einer der beiden Varianten entsprechen:
* Die Signatur des Domino Servers, auf welchem die Postfächer der Mitarbeiter liegen.
* Die Signatur eines Users der ein Postfach auf dem Domino Server besitz, auf welchem die Postfächer der Mitarbeiter liegen.
Diese Vorgaben sind seitens HCL Domino notwendig, damit ein MailIn Agent ordnungsgemäß funktioniert.

Öffnen Sie nun im Designer die Memo Maske (Alias: Memo) ihres E-Mail Templates.

Die Schritte 7 bis 14 müssen ebenso für beide Reply Masken (Alias: Reply) durchgeführt werden.

Fügen Sie nun im Bereich (Globals) den Befehl: Use "Cryptshare-CS4N-Mail-Integration" hinzu.

Quellcode zum kopieren

Use "Cryptshare-CS4N-Mail-Integration"

Fügen Sie nun im Querysave Event der Memo Maske die Programmzeilen Call CS4N_QuerySave(Source, Continue) und If Continue = False then Exit Sub ein.

Quellcode zum kopieren

'**************** Cryptshare for Notes Integration ****************
Call CS4N_QuerySave(Source, Continue)
If Continue = False Then Exit Sub
'*******************************************************************

Fügen Sie nun im Queryclose Event der Memo Maske die Programmzeile Call CS4N_QueryClose(cMemoObject, Continue) ein.

Quellcode zum kopieren

'**************** Cryptshare for Notes Integration ****************
Call CS4N_QueryClose(cMemoObject, Continue)
'*******************************************************************

Fügen Sie die Teilmaske "Cryptshare-CS4N-Integration" ein.
1. Bis einschließlich HCL Notes Version 10

Fügen Sie unterhalb der Memo Kopftabelle die Cryptshare for Notes Teilmaske ein. Schritt .

1. Ab HCL Notes Version 11

Fügen Sie unterhalb der Memo Kopftabelle in der Teilmaske "MemoV11" die Cryptshare for Notes Teilmaske ein. Schritt .

Positionieren Sie nun den Cursor in die Zeile und öffnen Sie den Dialog für das Einfügen der Teilmaske. Schritt bis .
Markieren Sie im Folgedialog die Checkbox Auf Formel basierende Teilmaske einfügen und bestätigen Sie die Dialogbox mit OK.

Aufgrund der Übersichtlichkeit empfehlen wir diese Art der Einbindung der Teilmaske. Sie können diese jedoch auch direkt einbinden.

Fügen Sie in den Formelbereich für die berechnete Teilmaske den Text "Cryptshare-CS4N-Integration" ein und bestätigen sie diese Eingabe.

Quellcode zum kopieren

"Cryptshare-CS4N-Integration"

Speichern Sie im Anschluss die Nachricht - Maske ab.

Aktualisieren Sie nun das Design Ihrer Mailanwendung mit dem modifizierten Template. Starten Sie im Anschluss den Notes-Client neu. Hierdurch werden alle evtl. "gecachten" Designelemente aktualisiert. Die Memo Maske sieht dann beispielsweise wie folgt aus:

Die Auswahloptionen für die Teilmasken werden aus der CS4N Konfiguration gelesen und sind die Gleichen wie bei der Memo-Maske in der CS4N Anwendung.

Verwendung von Kennzeichen bei aktivierter Rechtschreibprüfung

Damit die Domino Serverregel eine Nachricht in die CS4N Anwendung weiterleiten kann, wird temporär im Betreff der E-Mail eine konfigurierbare Ergänzung, z.B. [CS4N], hinzugefügt. Dies geschieht beim Klick auf den Sende-Button. Bei der Verarbeitung der E-Mail in CS4N wird im Anschluss diese Kennzeichnung wieder entfernt. Somit wird nur der Originalbetreff den E-Mail Empfängern zugestellt.
Bei aktivierter Rechtschreibprüfung kann es jedoch sein, dass diese die Erweiterung [CS4N] im Betreff bemängelt. Es wird deshalb den Anwendern empfohlen, die Kennzeichnung in das Wörterbuch mit aufzunehmen. Wird diese Kennzeichnung im Rahmen der Rechtschreibprüfung manuell vom Anwender aus dem Betreff herausgelöscht, so wird die E-Mail vom Domino Server nicht zur CS4N Anwendung weitergeleitet.