Konnektoren enthalten Verbindungsparameter zu externen Systemen und Applikationen. Konnektoren können in Workflow-Aktionen aufgerufen und in Integrationen verwendet werden.
Typen
Folgende Konnektoren können erstellt werden.
| REST | Dieser Typ ermöglicht die Anbindung externer REST-APIs. |
| Eingehende E-Mail | Dieser Typ ermöglicht eingehende E-Mail-Verarbeitung. Wenn der Konnektor aktiviert wird, wird das hinterlegte E-Mail-Postfach minütlich auf ungelesene E-Mails überprüft. E-Mails werden als neuer Datensatz in Cameleon erfasst. |
| Ausgehende E-Mail | Wird im Rahmen der Aktion “E-Mail verfassen” verwendet. Mit diesem Typ können zum Beispiel verschiedene Support-Postfächer hinterlegt werden. |
| Microsoft SQL Server | Mit diesem Konnektor können Verbindungsparameter von einer Microsoft SQL Datenbank hinterlegt werden. Dieser Endpunkt kann im Integration Designer als Datenquelle verwendet werden. |
| LDAP | Mit diesem Konnektor können Daten im LDAP-Server abgerufen, erstellt, aktualisiert oder gelöscht werden. |
| PowerShell | Mit diesem Konnektor lassen sich PowerShell-Skripte remote ausführen. Erfordert die Konfiguration und Aktivierung von Windows Remote Management (WinRM) auf dem entsprechenden Server. |
Einen Konnektor erstellen
- Öffnen Sie im Hauptmenü “Integrationen” > Konnektoren
- Klicken Sie auf den Button “Neu”
- Füllen Sie die erforderlichen Felder aus
- Klicken Sie auf den Button “Hinzufügen”, um den Datensatz zu erstellen
Einen Konnektor bearbeiten
- Öffnen Sie im Hauptmenü “Integrationen” > Endpunkte
- Wählen Sie das gewünschte Element aus der Liste aus
- Führen Sie die gewünschte Änderung durch und klicken Sie anschließend auf “Speichern”
Konnektor
Eingehende E-Mail und ausgehende E-Mail
| Verbindung | |
| Aktiv | Ist die Option aktiviert, wird dieser Endpunkt minütlich ausgeführt. |
| Anmeldetyp | IMAP, Microsoft ROPC, Microsoft Client Credentials |
| Tenant Id | Nur für Microsoft ROPC und Microsoft Client Credentials |
| Application Client Id | Nur für Microsoft ROPC und Microsoft Client Credentials |
| Client Secret | Nur für Microsoft ROPC und Microsoft Client Credentials |
| Benutzername | E-Mail-Adresse |
| Passwort | Nur für Microsoft ROPC und IMAP |
| Mail Server | Nur für IMAP |
| Port | Nur für IMAP |
| TLS aktivieren | Nur für IMAP |
Über die Option „Verbindung testen“ kann die Verbindung zum Postfach getestet werden.
REST
| Methode | GET, POST, PUT, DELETE |
| Protokoll | https, http |
| Self-Signed Zertifikatsfehler ignorieren | Ist die Option aktiviert, werden Zertifikatsfehler ignoriert. |
| Endpunkt-URL | Eine URL ohne die Angabe von Protokoll, Port und Pfad |
| Port | Port der API |
| URL-Pfad | Der Pfad der API beginnend mit / |
| Token | Token sind Passwörter oder Secrets, die verschlüsselt gespeichert werden. Token können in Header- und Body-Parametern verwendet werden. Ein Token kann über den Ausdruck {{vault.<Index>}}verwendet werden. |
| Authentifizierung verwenden | Ist diese Option aktiv, wird zunächst der Endpunkt zur Authentifizierung ausgeführt. |
| Endpunkt für Authentifizierung | Der Endpunkt, der zur Authentifizierung ausgeführt wird. Der Response wird im Objekt {{auth}} gespeichert und kann sowohl in Header- als auch Body-Parametern verwendet werden. |
| Headers | Header-Parameter für den REST-API-Aufruf |
| Body | Der Body kann im JSON-Format und x-www-form-urlencoded erstellt werden. |
Über die Option „Jetzt ausführen“ kann die API manuell ausgeführt werden.
Microsoft SQL Server
| Datenbank-Host | Host- oder IP-Adresse des Datenbank-Servers |
| Datenbank-Port | Port der Datenbank |
| Datenbank-Name | Name der Datenbank |
| Mit einem Domain-Account verbinden | Ist der Parameter aktiv, wird ein Domain-Account zur Anmeldung an der Datenbank verwendet |
| Domain | Domain des Accounts, der für die Anmeldung verwendet wird. Nur sichtbar, wenn der Parameter Mit einem Domain-Account verbinden aktiv ist. |
| Anmeldename | Benutzername zur Anmeldung an der Datenbank |
| Passwort | Passwort zur Anmeldung an der Datenbank |
LDAP
| Untertyp | Beschreibung |
| Datensatz hinzufügen | Erstellung eines Datensatzes |
| Datensatz löschen | Löschen eines Datensatzes |
| Datensatz bearbeiten | Verändern von Attributen eines Datensatzes |
| DN bearbeiten | DN eines Datensatzes verändern |
| Suchen | Datensätze abrufen |
Verbindungsparameter
| LDAP Server und Port | Host- oder IP-Adresse und Port des LDAP-Servers |
| LDAPS | Aktivieren, wenn LDAPS verwendet werden soll |
| Self-Signed Zertifikatsfehler ignorieren | Nur bei LDAPS: Aktivieren, um Self-Signed Zertifikatsfehler zu ignorieren |
| CA-Zertifikat | Nur bei LDAPS: LDAP CA im pem-Format |
| Suchbasis | Basis-Verzeichnis zur Abfrage |
| Benutzername | DN des Benutzers, der zur Durchführung der Aktion verwendet wird |
| Passwort | Passwort des Benutzers, der zur Durchführung der Aktion verwendet wird |
In den folgenden Aktionen können die Platzhalter {{record.Feldname}} und {{temp.Variable}} verwendet werden, um den Konnektor innerhalb eines Workflows mit den erforderlichen Parametern aufzurufen.
Datensatz hinzufügen / bearbeiten
| Parameter | Beschreibung |
| DN | DN des Benutzers, der erstellt bzw. bearbeitet werden soll |
| Eintrag | Schlüssel-Werte Tabelle. Der Schlüssel ist das LDAP-Feld, der Wert der gewünschte Wert für den Datensatz. Beispiel: Schlüssel: cn – Wert: Max |
Datensatz löschen
| Parameter | Beschreibung |
| DN | DN des Benutzers, der gelöscht werden soll |
DN bearbeiten
| Parameter | Beschreibung |
| DN | DN des Benutzers, der angepasst werden soll |
| Neuer DN | Neuer DN des Benutzers |
Suchen
| Parameter | Beschreibung |
| Filter | LDAP Filter zur Suche, z.B. (objectClass=inetOrgPerson) |
| Attribute | Attribute, die abgerufen werden sollen |
PowerShell
Mit diesem Konnektor lassen sich lokale PowerShell-Skripte aus Cameleon heraus aufrufen. Voraussetzung zur Verwendung ist die Aktivierung von Windows Remote Management (WinRM) auf dem entsprechenden Server. Die Konfiguration kann auf dem Server über den PS-Aufruf winrm get winrm/config überprüft werden. Die ausführende Library ist das Python-Paket pypsrp – Python PowerShell Remoting Protocol Client library
| Servername oder IP-Adresse | Host- oder IP-Adresse des Servers |
| SSL-Verbindung über https | Aktivieren, wenn https verwendet werden soll |
| SSL-Zertifikat des Servers validieren | Deaktivieren, um Self-Signed Zertifikatsfehler zu ignorieren |
| Verschlüsselung | Auto, Always, Never |
| Authentifizierungsprotokoll | Basic, NTLM, Negotiate |
| Anmeldename | Benutzername des Servers, um das PowerShell-Skript auszuführen |
| Passwort | Passwort des Benutzers, der zur Durchführung der Aktion verwendet wird |
| Lokaler Pfad zum PowerShell-Skript | Pfad zum PowerShell-Skrip, z.B. C:\\tmp\\script.ps1 |
| Argumente | Werte, die dem PowerShell-Skript übergeben werden können. Die Angabe von Variablen mit {{record.Feldname}} und {{temp.myVar}} ist möglich. Die Argumente sind kommasepariert. Die Argumente können in dem PowerShell-Skript abgerufen und in ein Array umgewandelt werden: $array=$args[0].Split(“,”) |
Details
| Hersteller | Ist dieser Parameter aktiv, handelt es sich um einen Konfigurationsdatensatz, der durch den Softwarehersteller im Standard ausgeliefert wurde Hinweis: Bei Konfigurationsdatensätzen vom Hersteller können nur Anzeigelabel und der Verwendungsstatus aktualisiert werden. Diese Datensätze können nicht gelöscht werden |
| Version | Die Version des Konfigurationsdatensatzes |
| Name | Der Name des Endpunktes |
| Typ | Der Typ des Endpunktes |
| Erstellt am | Das Erstellungsdatum des Konfigurationsdatensatzes Hinweis: Das Feld wird automatisch gefüllt |
| Aktualisiert am | Das Datum, an dem der Konfigurationsdatensatz zuletzt aktualisiert wurde Hinweis: Das Feld wird automatisch gefüllt |
| UUID | Eine eindeutige ID des Konfigurationsdatensatzes Hinweis: Das Feld wird automatisch gefüllt |
| Erstellt von | Der Ersteller des Konfigurationsdatensatzes Hinweis: Das Feld wird automatisch gefüllt |
| Aktualisiert von | Die Person, die den Konfigurationsdatensatz zuletzt aktualisiert hat Hinweis: Das Feld wird automatisch gefüllt |