Kanäle (REST API)

Kanal suchen

Über den Namen des Partners (relation) und den Namen des Kanals (name) wird die ID des Kanals zurück geliefert.

URL (HTTP POST mit JSON):

http(s)://<IP oder URL des Integration Servers>/dw/auth/v1/channelSearch

{
	"relation": "My partner",
	"name": "My SSH channel"
}

Beispielhafte Response

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

Der Parameter id ist die ID des Kanals.

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

Kanal-Info anzeigen

Über die ID des Kanals werden die Informationen des Kanals zurück geliefert.

URL (HTTP GET):

http(s)://<IP oder URL des Integration Servers>/dw/auth/v1/channelinfo?id=<channel_ID>

Beispielhafte Response

{
    "partnerAddress": "http://example.com",
    "sendCompressed": false,
    "refreshURL": "https://\u003cserver\u003e/dw/register/oauth/token?grant_type=refresh_token\u0026refresh_token=\u003crefreshToken\u003e\u0026client_id=\u003cclientId\u003e\u0026client_secret=\u003cclientSecret\u003e",
    "active": true,
    "type": "HTTP",
    "sendSigned": false,
    "dmz": true,
    "certificates": {
 
    },
    "preemtive": false,
    "sendEncrypted": false,
    "name": "Showcase_Oauth2_Client_AuthorizationCode",
    "receiveSigned": false,
    "realm": "DEFAULT",
    "id": 1677075059014090,
    "operation": "get",
    "logSettings": {
        "retainDays": "-1",
        "Enabled": false
    },
    "receiveEncrypted": false,
    "releation": "01_Showcases",
    "direction": "in"
}

Kanal anlegen

URL (HTTP POST mit JSON):

http(s)://<IP oder URL des Integration Servers>/dw/auth/v1/channel

JSON-Dateien für die jeweilige Kanal-Art

Kanal ändern

URL (HTTP POST mit JSON):

http(s)://<IP oder URL des Integration Servers>/dw/auth/v1/channel

JSON:

Die Struktur der JSON-Datei ist hier wie beim Anlegen eines Partners, es wird lediglich im Parameter operation der Wert update statt add verwendet und im Parameter id statt dem Wert 0 die tatsächliche ID des Kanals.

Zudem muss nicht die gesamte Struktur verwendet werden, sondern lediglich die Pflicht-Parameter type, operation, name, relation und id und weitere Parameter, die Sie ändern möchten.

Kanal löschen

URL (HTTP POST mit JSON):

http(s)://<IP oder URL des Integration Servers>/dw/auth/v1/channel

{
	"type": "AS2",
	"operation": "delete",
	"relation": "My partner",
	"id": 1592398910884151
}

Bei type muss der Kanal-Typ (wie beim Anlegen) eingetragen werden.

Mit relation wird der Namen des Partners angegeben.

Der Parameter id ist hier die ID des Kanals.

Zusatzkennungen anlegen, ändern und löschen

Sie können beim Anlegen oder Ändern von Kanälen auch Zusatzkennungen für diese Kanäle anlegen, ändern oder löschen. Beachten Sie bitte, dass ein Anlegen nur funktioniert, wenn die Zusatzkennung existiert (Zusatzkennungen werden zentral angelegt und können in jedem Kanal unterschiedliche Werte haben).

Verwenden Sie dazu zusätzlich folgende Code-Segmente beim Anlegen oder Ändern von Kanälen.

Zusatzkennung anlegen

"optKeys": [ {
	"key": "a key",
	"value": "a value",
	"operation": "add",
	"secure": "true"
	}
]

Parameter key ist der Name der Zusatzkennung und Parameter value der Wert der Zusatzkennung.

Parameter secure gibt an, ob der Wert verschlüsselt abgelegt werden soll.

Zusatzkennung ändern

"optKeys": [ {
	"key": "a key",
	"value": "a new value",
	"operation": "add",
	"secure": "true"
	}
]

Beachten Sie bitte, dass hier ebenfalls der Wert add beim Parameter operation verwendet wird. Der alte Wert der Zusatzkennung (falls vorhanden) wird dann einfach überschrieben. Es kann also immer nur maximal ein Eintrag mit dem selben Schlüssel (key) erzeugt werden.

Zusatzkennung löschen

"optKeys": [ {
	"key": "a key",
	"operation": "delete"
	}
]

Beispiel

{
    "type": "SMB",
    "operation": "add",
    "name": "My SMB channel",
    "relation": "My partner",
    "active": true,
    "id": 0,
    "user": "me",
    "password": "secret",
    "domain": "lobster.de",
    "server": "smb://localhost",
    "contact": {
        "language": "de",
        "name": "John Doe",
        "fax": "",
        "email": "john.doe@example.com",
        "note": ""
    },   
	"optKeys": [ {
		"key": "a key",
		"value": "a value",
		"operation": "add",
		"secure": "true"
		},
		{
		"key": "another key",
		"value": "a value",
		"operation": "add",
		"secure": "true"
		},
	]    
}

Logs

Logs für Anfragen dieser Art finden Sie im Server Logging (→ "Verwaltung") unter internal/message.log (bzw. in der Datei./logs/services/message.log).