Implementieren eines Application Integration Servers - Versionsgeschichte

Cmussmann am 29. Juni 2017 um 12:23 Uhr

2017-06-29T12:23:26Z

Ltalaschus: /* Python */

2017-04-20T13:39:24Z

Python

Ltalaschus: /* Python */

2017-04-20T13:39:14Z

Python

Ltalaschus: /* Beispiel Server-Implementierung */

2016-12-12T09:23:28Z

Beispiel Server-Implementierung

Dweuthen am 15. September 2015 um 15:34 Uhr

2015-09-15T15:34:26Z

Dweuthen am 23. März 2015 um 15:47 Uhr

2015-03-23T15:47:47Z

Dweuthen am 23. März 2015 um 15:46 Uhr

2015-03-23T15:46:25Z

Dweuthen: Die Seite wurde neu angelegt: „Im Folgenen wird beschrieben, wie man einen eigenen Application Integration Server implementiert um Benutzer aus Quellen zu synchronisieren, welche nicht nativ…“

2015-03-23T15:45:50Z

Die Seite wurde neu angelegt: „Im Folgenen wird beschrieben, wie man einen eigenen Application Integration Server implementiert um Benutzer aus Quellen zu synchronisieren, welche nicht nativ…“

Neue Seite

Im Folgenen wird beschrieben, wie man einen eigenen Application Integration Server implementiert um Benutzer aus Quellen zu synchronisieren, welche nicht nativ von MailStore unterstützt werden. Dies kann nahezu eine beliebige Benutzerdatenbank sein, auf welche durch eine Programmier- oder Skriptsprache zugegriffen werden kann, wie z.B. SQL-Server Datenbanken oder einfache Textdateien. Der Verwendung eines Application Integration Servers ist unter [[Application Integration]] beschrieben

Ein Application Integration Server kann in einer beliebigen Programmier- oder Skriptsprache geschrieben sein. Er muss entweder einen eigenen HTTP-Server bereitstellen oder über einen existierenden HTTP-Server erreichbar sein.

=== Benutzer synchronisieren ===
Der Application Integration Server muss den folgenden Parameter per HTTP-POST-Anfrage akzeptieren um die Synchronisierung zu beginnen.

{| class="wikitable"
! width=80px | Name
! Description
|-
| <tt>cmd</tt>
| Zum Synchronisieren von Benutzern muss der ''cmd''-Parameter den Wert ''list'' haben.
|}

Die zurückgelieferte HTTP-Antwort muss aus gültigen, JSON-formatierten Daten bestehen. Werden Benutzer synchronisiert, wird die folgende Datenstruktur für jedes Objekt erwartet. Mehrere Benutzer müssen als ein Array von JSON-Objekten zurückgeliefert werden.

{| class="wikitable"
! width=150px | Name
! width=120px | Type
|-
| <tt>userName</tt>
| string
|-
| <tt>distinguishedName</tt>
| string ''(Optional)''
|-
| <tt>fullName</tt>
| string ''(Optional)''
|-
| <tt>emailAddresses</tt>
| array ''(Optional)''
|}

=== Beispiele ===

==== HTTP Anfrage ====
<source lang="xml" toolbar="false" gutter="false">
POST /mailstore-integration/index.php HTTP/1.1
Authorization: Basic bWFpbHN0b3JlQGV4YW1wbGUudGVzdDpQYXNzdzByZA==
User-Agent: curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
Host: mail.example.test
Accept: */*
Content-Length: 8
Content-Type: application/x-www-form-urlencoded

cmd=list
</source>

==== HTTP Antwort ====
<source lang="xml" toolbar="false" gutter="false">
HTTP/1.1 200 OK
X-Powered-By: PHP/5.4.4-14+deb7u5
Content-Type: text/json; charset=utf8
Date: Fri, 13 Dec 2013 14:20:27 GMT
Server: lighttpd/1.4.31
Content-Length: 23812
Accept-Ranges: none
Connection: Keep-Alive

[
{
"userName": "john.doe",
"distinguishedName": "UID=john.doe,DC=example,DC=com",
"fullName": "john.doe",
"emailAddresses": [
"john.doe@example.com",
"john@example.com"
]
},
{
"userName": "jane.doe",
"distinguishedName": "UID=jane.doe,DC=example,DC=com",
"fullName": "jane.doe",
"emailAddresses": [
"jane.doe@example.com",
"jane@example.com"
]
}
]
</source>

=== Benutzer authentifizieren ===
Der Application Integration Server muss die folgenden Parameter per HTTP-POST-Anfrage akzeptieren um Benutzer zu authentifizieren.

{| class="wikitable"
! width=80px | Name
! Description
|-
| <tt>cmd</tt>
| For authenticating users the ''cmd'' parameter must be set to ''auth''.
|-
| <tt>user</tt>
| The ''user'' parameter contains the user name to be authenticated.
|-
| <tt>pass</tt>
| The ''pass'' parameter contains the password to be verified.
|}

Die zurückgelieferte HTTP-Antwort muss aus gültigen, JSON-formatierten Daten bestehen. Werden Benutzer authentifizier, wird die folgende Datenstruktur für jedes Objekt erwartet. Mehrere Benutzer müssen als ein Array von JSON-Objekten zurückgeliefert werden.

{| class="wikitable"
! width=150px | Name
! width=120px | Type
|-
| <tt>succeeded</tt>
| boolean
|}

=== Beispiele ===

==== HTTP Anfrage ====
<source lang="xml" toolbar="false" gutter="false">
POST /mailstore-integration/index.php HTTP/1.1
Authorization: Basic bWFpbHN0b3JlQGV4YW1wbGUudGVzdDpQYXNzdzByZA==
User-Agent: curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
Host: mail.example.test
Accept: */*
Content-Length: 8
Content-Type: application/x-www-form-urlencoded

cmd=auth&user=john.doe&pass=Passw0rd
</source>

==== HTTP Antwort - Authentifizierung erfolgreich ====
<source lang="xml" toolbar="false" gutter="false">
HTTP/1.1 200 OK
X-Powered-By: PHP/5.4.4-14+deb7u5
Content-Type: text/json; charset=utf8
Date: Fri, 13 Dec 2013 14:20:27 GMT
Server: lighttpd/1.4.31
Content-Length: 21
Accept-Ranges: none
Connection: Keep-Alive

{
succeeded: true
}
</source>

==== HTTP Antwort - Authentifizierung fehlgeschlagen ====
<source lang="xml" toolbar="false" gutter="false">
HTTP/1.1 200 OK
X-Powered-By: PHP/5.4.4-14+deb7u5
Content-Type: text/json; charset=utf8
Date: Fri, 13 Dec 2013 14:20:27 GMT
Server: lighttpd/1.4.31
Content-Length: 22
Accept-Ranges: none
Connection: Keep-Alive

{
succeeded: false
}
</source>

← Nächstältere Version		Version vom 29. Juni 2017, 12:23 Uhr
Zeile 1:		Zeile 1:
−	Im ~~Folgenen~~ wird beschrieben, wie man einen eigenen Application Integration Server implementiert um Benutzer aus Quellen zu synchronisieren, welche nicht nativ von MailStore unterstützt werden. Dies kann nahezu eine beliebige Benutzerdatenbank sein, auf welche durch eine Programmier- oder Skriptsprache zugegriffen ~~werden kann, wie~~ z.B. SQL-Server Datenbanken oder einfache Textdateien. ~~Der~~ Verwendung eines Application Integration Servers ist unter [[Application Integration]] beschrieben	+	Im Folgenden wird beschrieben, wie man einen eigenen Application Integration Server implementiert um Benutzer aus Quellen zu synchronisieren, welche nicht nativ von MailStore unterstützt werden. Dies kann nahezu eine beliebige Benutzerdatenbank sein, auf welche durch eine Programmier- oder Skriptsprache zugegriffen wird (z.B. SQL-Server Datenbanken oder einfache Textdateien wie CSV). Die Verwendung eines Application Integration Servers ist unter [[Application Integration]] beschrieben.

	Ein Application Integration Server kann in einer beliebigen Programmier- oder Skriptsprache geschrieben sein. Er muss entweder einen eigenen HTTP-Server bereitstellen oder über einen existierenden HTTP-Server erreichbar sein.		Ein Application Integration Server kann in einer beliebigen Programmier- oder Skriptsprache geschrieben sein. Er muss entweder einen eigenen HTTP-Server bereitstellen oder über einen existierenden HTTP-Server erreichbar sein.

@@ Zeile 159: / Zeile 159: @@
 === Python ===
-Die Python-Implementierung eines modularen Application Integration Servers finden Sie [[Media:Application-integration-server.zip|hier].
+Die Python-Implementierung eines modularen Application Integration Servers finden Sie [[Media:Application-integration-server.zip|hier]].
 [[de:Implementieren eines Application Integration Servers]]
 [[en:Implementing_an_Application_Integration_Server]]

@@ Zeile 159: / Zeile 159: @@
 === Python ===
-Die Python-Implementierung eines modularen Application Integration Servers finden Sie unter [http://ftp.mailstore.com/pub/Scripts/Python/application-integration-server.zip application-integration-server.zip].
+Die Python-Implementierung eines modularen Application Integration Servers finden Sie [[Media:Application-integration-server.zip|hier].
 [[de:Implementieren eines Application Integration Servers]]
 [[en:Implementing_an_Application_Integration_Server]]

@@ Zeile 159: / Zeile 159: @@
 === Python ===
-Die Python-Implementierung eines modularen Application Integration Servers finden Sie unter [ftp://ftp.mailstore.com/pub/Scripts/Python/application-integration-server.zip application-integration-server.zip].
+Die Python-Implementierung eines modularen Application Integration Servers finden Sie unter [http://ftp.mailstore.com/pub/Scripts/Python/application-integration-server.zip application-integration-server.zip].
 [[de:Implementieren eines Application Integration Servers]]
 [[en:Implementing_an_Application_Integration_Server]]

@@ Zeile 154: / Zeile 154: @@
+}
 </source>
 [[de:Implementieren eines Application Integration Servers]]
 [[en:Implementing_an_Application_Integration_Server]]

← Nächstältere Version		Version vom 23. März 2015, 15:47 Uhr
Zeile 154:		Zeile 154:
	}		}
	</source>		</source>
		+
		+	[[de:Implementieren eines Application Integration Servers]]
		+	[[en:Implementing_an_Application_Integration_Server]]

@@ Zeile 33: / Zeile 33: @@
 |}
-=== Beispiele ===
+=== Beispiel ===
 ==== HTTP Anfrage ====