| ... |
... |
@@ -1,1
+1,45 @@ |
| 1 |
|
-test |
|
1 |
+{{content/}} |
|
2 |
+ |
|
3 |
+{{figure image="plugin_ldap_mail_encryption_config_de.png" width="600"}} |
|
4 |
+ Es muss ein {{smallcaps}}Ldap{{/smallcaps}}-Server konfiguriert werden, aus dem das Zertifikat des Empfängers der E-Mail ausgelesen wird. Zudem muss angegeben werden, in welchen Attributen die E-Mail-Adresse und das Zertifikat stehen. |
|
5 |
+{{/figure}} |
|
6 |
+ |
|
7 |
+Es ist möglich, in [[E-Mail-Aktionen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.EMail]] in der [[Statusverarbeitung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.WebHome]] per S/MIME verschlüsselte E-Mails zu versenden. Dazu wird ein Zertifikat des Empfängers benötigt, welches den Schlüssel für die Verschlüsselung enthält. Das {{smallcaps}}Ldap{{/smallcaps}}-E-Mail-Verschlüsselungsplugin ermöglicht es, dieses Zertifikat aus einem {{smallcaps}}Ldap{{/smallcaps}}-Verzeichnis auszulesen. Dabei wird anhand der E-Mail-Adresse des Empfängers nach einem Eintrag beziehungsweise einer Person im {{smallcaps}}Ldap{{/smallcaps}}-Verzeichnis gesucht. Wird ein Eintrag gefunden, wird der das Zertifikat aus einem frei einstellbaren Attribut des Eintrags ausgelesen und verwendet. |
|
8 |
+ |
|
9 |
+Nachdem dieses Plugin installiert wurde, muss es konfiguriert werden. Die Konfiguration besteht daraus, dass angegeben wird, auf welches {{smallcaps}}Ldap{{/smallcaps}}-Verzeichnis zugegriffen werden soll und in welchen Attributen die E-Mail-Adresse und das Zertifikat stehen. |
|
10 |
+ |
|
11 |
+Bei Bedarf können auch mehrere {{smallcaps}}Ldap{{/smallcaps}}-Verzeichnisse konfiguriert werden. Dazu müssen Konfigurationsparameter mit dem entsprechenden Index angelegt werden, also zum Beispiel //connection.data.2.base.dn// oder //connection.data.3.base.dn//. |
|
12 |
+ |
|
13 |
+== Konfiguration == |
|
14 |
+ |
|
15 |
+Folgende Konfigurationsparameter gibt es: |
|
16 |
+ |
|
17 |
+; connection.data.<INDEX>.host (Erforderlich) |
|
18 |
+: Host-Name des {{smallcaps}}Ldap{{/smallcaps}}-Servers, ohne Port und ohne Protokoll. |
|
19 |
+: Beispiel: {{code language="none"}}directory.bayern.de{{/code}} |
|
20 |
+; connection.data.<INDEX>.port (Erforderlich) |
|
21 |
+: Port des {{smallcaps}}Ldap{{/smallcaps}}-Servers. |
|
22 |
+: Beispiel: {{code language="none"}}389{{/code}} |
|
23 |
+; connection.data.<INDEX>.base.dn (Erforderlich) |
|
24 |
+: Base-Domain für die {{smallcaps}}Ldap{{/smallcaps}}-Suche. |
|
25 |
+: Beispiel: {{code language="none"}}ou=pki-teilnehmer,dc=pki,dc=bayern,dc=de{{/code}} |
|
26 |
+; connection.data.<INDEX>.attribute.email (Erforderlich) |
|
27 |
+: Attribut im Active-Directory, welches die E-Mail-Adresse enthält. |
|
28 |
+: Beispiel: {{code language="none"}}mail{{/code}} |
|
29 |
+; connection.data.<INDEX>.attribute.certificate (Erforderlich) |
|
30 |
+: Attribut im Active-Directory, welches das Zertifikat enthält. Es muss sich um ein X-509-Zertifikat handeln. |
|
31 |
+: Beispiel: {{code language="none"}}userCertificate{{/code}} |
|
32 |
+; connection.data.<INDEX>.auth.name |
|
33 |
+: Nutzername für die Verbindung zum {{smallcaps}}Ldap{{/smallcaps}}-Server. Freilassen, falls keine Anmeldung erforderlich ist. |
|
34 |
+; connection.data.<INDEX>.auth.password |
|
35 |
+: Passwort für die Verbindung zum {{smallcaps}}Ldap{{/smallcaps}}-Server. Freilassen, falls keine Anmeldung erforderlich ist. |
|
36 |
+; connection.data.<INDEX>.referral.hop.count (Erforderlich) |
|
37 |
+: Maximale Anzahl an Verweisen, denen gefolgt wird. |
|
38 |
+; connection.data.<INDEX>.use.ssl |
|
39 |
+: Ob die Verbindung zum {{smallcaps}}Ldap{{/smallcaps}}-Server verschlüsselt ist, also {{smallcaps}}Ssl{{/smallcaps}} beziehungsweise {{smallcaps}}Tls{{/smallcaps}} benutzt. Kann auf //true// oder //false// gesetzt werden. |
|
40 |
+ |
|
41 |
+== Versionhistorie |
|
42 |
+ |
|
43 |
+=== 1.0.0 |
|
44 |
+ |
|
45 |
+* Initialer Release. |