Allgemein: System-Interaktion per HTTP (REST API).

Sie können Partner-Zertifikate per HTTP anlegen und widerrufen. Aus Sicherheitsgründen können keine eigenen Zertifikate importiert werden.

Jeder Request erfordert eine Authentifizierung über Basic Authentication (Benutzername und Passwort eines Lobster_data-Benutzers mit dem Benutzer-Recht Administrator oder Administration via REST). Alternativ zu Basic Authentication können die Benutzerdaten in der URL mit &user=myuser&passwd=mypassword übergeben werden.

Logs für Anfragen dieser Art finden Sie in den Server-Logs unter internal/message.log.

Zertifikat anlegen

URL (HTTP POST mit JSON):

http://<IP oder URL des Integration Servers>/dw/auth/v1/certificate

https://<IP oder URL des Integration Servers>/dw/auth/v1/certificate

Hinweis: Siehe Abschnitt Hinzufügen eines HTTPS-Listeners.

JSON:

{
	"operation": "add",
	"id": 0,
	"relation": "My partner",
	"commonName": "",
	"certificate": "MIIDXDCCAkSgAwIBAgIGAXdnKI1FMA0GCSqGSIb3DQEBCwUAMEExDTALBgNVBAMMBHRlc3QxDTALBgNVBAoMBHRlc3QxCzAJBgNVBAYTAmRlMRQwEgYKCZImiZPyLGQBGRYEdGVzdDAeFw0yMTAyMDIyMzAwMDBaFw00MTAyMDIyMzAwMDBaMEExDTALBgNVBAMMBHRlc3QxDTALBgNVBAoMBHRlc3QxCzAJBgNVBAYTAmRlMRQwEgYKCZImiZPyLGQBGRYEdGVzdDCCASAwCwYJKoZIhvcNAQEKA4IBDwAwggEKAoIBAQC7mwTRTO6ckaF1paQ/0fmEfX4Ue1BgTXlOUNSbfX+xY6yi+AQsboajcsth3hdrga6utEEwWNh89ya/KZiVZsF6m/R8xuEu+vXG3KfENhSI12bgvQSN7qOVFitRrQ4c4AM0hWxnRgVTdUgPwabDxuUBYbC1Q42JWbEiMWJjboJX736sifLfbJODO/wrV5ErIv8Y+r1ez7vktkaLzTPZ4iqaeozohj3vWf5YD958ASv4gJIZTgkES+A5eyA4oqTTurgW4WItZRHjdTgbHaxLuZrwG64DchaCBsiPVi6sxRkWnOibVSUw3ItVK7CjjBQIj+d4T0ZAD4243WGHwhu6ylJPAgMBAAGjXDBaMCkGA1UdDgQiBCBXPK15NyhJrNLkiK06/b2t3buAJORzFuMAdt9kGB6IaTAOBgNVHQ8BAf8EBAMCBLAwHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMBMA0GCSqGSIb3DQEBCwUAA4IBAQBDxNnzt3hKJHSXDthQC4W7jCFTeSdCRHM7wCoyF2Lv4onUnKFkTznjVfNfBpYfHgRRD0ioZOQUs7LShicxn4sz2yyHWNQbrnwPoWnUn516QS8L1l46BgcF12/7nfy25lK3QgGwprZg9wu64x1Mlcefb7+rFKT+4cl6+zCedSL00vdKUJMJZ2f0EhABHrjfDLvFjFmROBzmxL66OkVHwiL7uk70t0CYV+Y54J0UobTOuUR+Oxv3JvO6A0GYJJaOw2MLfJRHBmqj/e6bpGzpRttTfpyBZ3+jaSAcaLEH7QKgcGU8pvQ77v1+O/3ucLKYfgKn67guHC1lfNbfLzKoMFKl"
}

Sie können hier entweder 0 für die id angeben oder die Zeile ganz weglassen, da die ID des Partner-Zertifikats bei dieser Operation ja erst erzeugt wird.

Beim Parameter certificate wird alles akzeptiert (allerdings mit Base64 kodiert), was der Upload-Dialog in der GUI annimmt (.pem und .cer).

Beispiel:

Gehen wir von folgendem .pem-Zertifikat aus (welches bereits in Base64 kodiert ist).

Entfernen Sie die erste und letzte Zeile und alle Zeilenumbrüche, dann können Sie diesen String oben als Wert des Parameters certificate verwenden.

Wenn Sie eine .cer-Datei (binär) verwenden möchten, müssen Sie diese zuvor mit einem entsprechenden Tool in Base64 umwandeln.

Beispielhafte Response

Die Struktur der Response ist bei jeder erfolgreichen Zertifikats-Operation identisch.

Die id ist hier die ID des erzeugten Partner-Zertifikats.

{
    "response": {
        "status": "ok",
        "id": "1616398381212487"
    }
}

Zertifikat widerrufen

URL (HTTP POST mit JSON):

http://<IP oder URL des Integration Servers>/dw/auth/v1/certificate

https://<IP oder URL des Integration Servers>/dw/auth/v1/certificate

JSON:

{
	"operation": "revoke",
	"id": 1616398381212487,
	"relation": "My partner"
}