CSNCurrent de:Integration in das persönliche E-Mail Postfach

Aus Cryptshare Documentation
Version vom 25. Januar 2024, 17:16 Uhr von imported>Botsasp
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche

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.
    • Eine zweite Domino Serverregel wird benötigt, wenn die Option zur direkten Weiterleitung der Benachrichtigungen an interne Empfänger aktiviert ist.

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

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
$CS4N_ContentLanguage Beinhaltete die Clientsprache des aktuellen Anwenders.

Beispiel: $CS4N_ContentLanguage = DE

$CS4N_Server Beinhaltet den Domino Servernamen, auf welchem CS4N installiert wurde.

Beispiel: $CS4N_Server = befineDemoV01/Befine/DE

$CS4N_App Beinhaltet den relativen Pfad vom DATA Verzeichnis des Domino Servers zur CS4N Anwendung

Beispiel:  $CS4_App = 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.

6488090.png

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.

1. Öffnen Sie das CS4N Template "-T- Cryptshare Library Vx.xx.x" 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.

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

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

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

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

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.

6. Ö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.

7. Fügen Sie nun im Bereich (Globals) den angegeben Befehl hinzu.
51975267.png

Quellcode zum Kopieren
Use "Cryptshare-CS4N-Mail-Integration"

8. Fügen Sie nun im Querysave Event der Memo Maske die angegebenen Programmzeilen ein.
8686113.png

Quellcode zum Kopieren
'**************** Cryptshare for Notes Integration ****************

Call CS4N_QuerySave(Source, Continue)
If Continue = False Then Exit Sub

'*******************************************************************

9. Fügen Sie nun im Queryclose Event der Memo Maske die angegebene Programmzeile ein.
8686114.png

Quellcode zum Kopieren
'**************** Cryptshare for Notes Integration ****************

Call CS4N_QueryClose(cMemoObject, Continue)

'*******************************************************************

10. Fügen Sie die Teilmaske "Cryptshare-CS4N-Integration" ein.
a. Bis einschließlich HCL Notes Version 10
Fügen Sie unterhalb und außerhalb der ersten Memo Kopftabelle die Cryptshare for Notes Teilmaske ein. Die eingefügte Teilmaske muss sich außerhalb der Tabelle befinden, da sonst beim Ausdrucken einer E-Mail Drucken die Datumsinformationen außerhalb des Druckbereichs liegen. 8686115.png
Weiter mit Schritt 51975262.png.

b. Ab HCL Notes Version 11
Fügen Sie unterhalb und außerhalb der ersten Memo Kopftabelle in der "MemoV11" Teilmaske die Cryptshare for Notes Teilmaske ein. Die eingefügte Teilmaske muss sich außerhalb der Tabelle befinden, da sonst beim Ausdrucken einer E-Mail Drucken die Datumsinformationen außerhalb des Druckbereichs liegen.

IntegrationMemoV11.gif


Weiter mit Schritt 51975261.png.

11. Positionieren Sie nun den Cursor in die Zeile und öffnen Sie den Dialog für das Einfügen der Teilmaske.
8686116.png

12. 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.


6488142.png

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

Quellcode zum Kopieren
"Cryptshare-CS4N-Integration"

14. Speichern Sie im Anschluss die Nachricht - Maske ab.
8686118.png

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.
Fokusfarbe in den Eingabefeldern der HCL Standard E-Mail
Es besteth die Möglichkeit, die Fokusfarben der Cryptshare for Notes Teilmaske Eingabefelder auch für die standard E-Mail Eingabefleder zu verwenden. (Fokusfarben...)
Grafik6.png
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.