Kanäle (REST API)
Allgemein: Siehe Abschnitt 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://<IP oder URL des Integration Servers>/dw/auth/v1/channelSearch https://<IP oder URL des Integration Servers>/dw/auth/v1/channelSearch |
Hinweis: Siehe Abschnitt Hinzufügen eines HTTPS-Listeners.
JSON:
{
"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://<IP oder URL des Integration Servers>/dw/auth/v1/channelinfo?id=<channel_ID> https://<IP oder URL des Integration Servers>/dw/auth/v1/channelinfo?id=<channel_ID> |
Hinweis: Siehe Abschnitt Hinzufügen eines HTTPS-Listeners.
Beispielhafte Response
{
"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://<IP oder URL des Integration Servers>/dw/auth/v1/channel https://<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://<IP oder URL des Integration Servers>/dw/auth/v1/channel https://<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://<IP oder URL des Integration Servers>/dw/auth/v1/channel https://<IP oder URL des Integration Servers>/dw/auth/v1/channel |
JSON:
{
"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 in den Server-Logs unter internal/message.log (bzw. in der Datei ./logs/services/message.log).