Áttekintés

A meglévő szoftverrendszerek összekapcsolása a Tulip rendszerrel

A Tulip egy nyílt platform, amelyet úgy terveztek, hogy zökkenőmentesen integrálódjon meglévő IT-infrastruktúrájába. Ezt az integrációt a csatlakozók segítik elő.

A csatlakozók a Tulip olyan funkciója, amely lehetővé teszi az adatcserét a HTTP API, az MQTT és az SQL adatbázisok és a Tulip között. Alapvető fontosságúak a külső szerverekhez és rendszerekhez való csatlakozáshoz, beleértve a Table API-t is. Egy csatlakozó beállítása lehetővé teszi, hogy külső információkat vonjon be a Tulip-alkalmazásokba, és ezzel egyszerűsítse a folyamatokat.

A csatlakozók típusai

1. HTTP - Külső API-kból származó adatok elérése.
2. MQTT - Írás az MQTT névtérbe.
3. SQL - A Tulipen kívüli külső adatbázisok elérése.

A csatlakozók eléréséhez menjen az Alkalmazások fül fölé, és válassza a Csatlakozók lehetőséget.

A Csatlakozók lapon megtekintheti a csatlakozók állapotát, leírását és az utolsó frissítés időpontját.

Ha az állapotpillér fölé mozgatja a gépet, további információkat kaphat az egyes Environment állapotáról.

Minden egyes csatlakozóhoz több csatlakozófunkció vagy lekérdezés is tartozhat, amelyeket egy alkalmazáson belül indíthat el.
Íme egy példa egy Connector funkcióra:

A csatlakozók használata

A csatlakozók használhatók a Triggerekben vagy a Automation Action Blocks.

Példa 1

1. "Amikor a kezelő beolvas egy vonalkódot"
2. "Keresse meg ezt a vonalkódot az SQL-adatbázisomban"
3. "Ezután navigáljon a három különböző lépés egyikéhez az adatok alapján".

Példa 2

1. "Amikor a kezelő megnyomja ezt a gombot"
2. "Küldj egy kérést a HTTP API-mnak, amely nyomon követi a gyártási problémákat a gyáramban."

Mindkét példa önkiszolgáló jellegű. Ha le tud kérdezni egy SQL-adatbázist vagy egy külső szoftverszolgáltatást (például egy MES vagy ERP), akkor a lekérdezést megírhatja a Tulipen belül.

Az alábbi képen látható a trigger-szerkesztő logikája egy csatlakozófüggvény futtatásához:

Csatlakozó környezetek

A Környezetek lapon több kiszolgálót állíthat be az egyes csatlakozófunkciókhoz. A környezetek lehetővé teszik, hogy szegmentálja, hogy mely információkra van hatással, az alkalmazások és automatizálások életciklusa alapján.

További részletek a környezetekről itt találhatók.

Technikai részletek

Mivel a csatlakozók külső rendszerekkel kommunikálnak, alapvető fontosságú annak megértése, hogyan kell őket az egyéni informatikai környezetéhez igazítani. A Connector Host a Tulip platform egyik összetevője, amely ezeket a kapcsolatokat kezeli.

A Tulip Cloudból nyíltan elérhető adatbázisok és API-k esetében nincs szükség további konfigurációra. Ha azonban problémák merülnek fel, vagy olyan adatbázishoz, API-hoz vagy géphez kell csatlakoznia, amely nem nyíltan elérhető a Tulip Cloudból, olvassa el ezt a cikket a Connector Hostokról.

Csatlakozó létrehozása

Egy új csatlakozó beállítása nem igényel átfogó ismereteket az API-król vagy adatbázisokról, de a kapcsolattípusok ismerete hasznos.

Egy csatlakozó létrehozásához navigáljon az Alkalmazások menüpontban található Csatlakozók oldalra. Kattintson a + Csatlakozó létrehozása gombra a jobb felső sarokban. Kiválaszthat egy meglévő gyorscsatlakozót, vagy kattinthat az Egyéni csatlakozó létrehozása gombra.

Új csatlakozó beállítása

Alapvető információk

1. Adjon nevet és leírást a csatlakozóhoz. Ezek bármikor szerkeszthetők.
2. Válassza ki a csatlakozó típusát. Ez a csatlakozó létrehozása után nem módosítható.
3. [opcionálisan] Az egyéni aldomainek engedélyezése lehetővé teszi, hogy egyedi aldomaineket konfiguráljon minden egyes funkcióhoz, megkönnyítve ezzel az összetettebb szolgáltatási architektúrákba való integrációt.

Ha például a kiszolgáló címe tulip.co, az egyes funkció használhatja a community.tulip.co, a kettes funkció pedig a support.tulip.co aldomaineket.

Ha az egyéni aldomainek engedélyezve vannak, a csatlakozó állapotának ellenőrzéséhez meg kell adni egy alapértelmezett aldomaint.

Futtatás: connector host

Válassza ki a kéréseket végrehajtó Connector Hostot. A Tulip által biztosított Cloud Connector host a kéréseket a Tulip Cloudon keresztül hajtja végre. A fiókjához regisztrált bármely helyben lévő csatlakozó host is megjelenik.

További információkat a csatlakozó hostokról itt talál.

HTTP-csatlakozó beállítása

A HTTP-csatlakozó funkciók beállításáról itt tájékozódhat.

Egyéni aldomain engedélyezése

Ha engedélyezve van, a funkció szintjén aldomainek adhatók hozzá. Ha engedélyezve van, hozzá kell adni egy alapértelmezett aldomain-t, amelyet a csatlakozó online állapotának ellenőrzésére használnak.

PéldaAkiszolgáló acme.co, és néhány funkciója lekérdezi az értékesítés.acme.co címet, mások a szállítás.acme.co címet stb.

Kiszolgáló címe

Adja meg a hálózati címet, azaz egy hostnevet vagy IP-címet, amelyhez a Tulip csatlakozik.

TLS

A Transport Layer Security (TLS) egy kriptográfiai protokoll, amelyet arra terveztek, hogy biztonságos kommunikációt biztosítson számítógépes hálózaton keresztül. A felek között továbbított adatok titkosításával biztosítja az adatok titkosságát és sértetlenségét. A TLS a Secure Sockets Layer (SSL) utódja, és széles körben használják az internetes kapcsolatok biztonságossá tételére.

Port

A kiszolgálója a kiszolgálószolgáltatója által megadott meghatározott hálózati porton hallgatja a kéréseket. A 443-as port a legelterjedtebb a HTTPS-szolgáltatások esetében, a 80-as port pedig a HTTP-szolgáltatások esetében.

Hitelesítés

• No Auth - Nincs szükség hitelesítésre, vagy a hitelesítés más kérésfejlécekben, például az x-auth-tokenben található.
• Basic Auth -Alapszintű hitelesítés, amely felhasználónevet és jelszót tartalmaz.
• OAuth 2.0 (Bearer token) - A Bearer tokenek a használt hozzáférési tokenek uralkodó típusa. Egy átláthatatlan karakterláncból állnak, amelynek nem célja, hogy jelentése legyen az azt használó ügyfelek számára.
• OAuth 2.0 (felhasználói hitelesítő jelek) - Általában olyan ügyfeleknél használatos, amelyeknek egy felhasználó nevében korlátozott számú erőforráshoz kell hozzáférniük, például egy mobilalkalmazásnak szüksége van a felhasználó névjegyeihez vagy naptári eseményeihez való hozzáférésre. A felhasználónak kifejezetten engedélyt kell adnia.
• OAuth 2.0 (Client Credentials) - Az ügyfél hitelesítő adatai egy olyan engedélyezési típus, amelyet a Tulip használ a hozzáférési token megszerzéséhez az engedélyező kiszolgálóval való hitelesítéssel, az ügyfél hitelesítő adatainak (ügyfél azonosító és ügyfél titok) felhasználásával, jellemzően az erőforrásokhoz való hozzáféréshez saját nevében, nem pedig egy felhasználó nevében.
• OAuth 2.0 (szolgáltatási fiók) - Olyan ügyfelek számára használatos, akiknek az erőforrások szélesebb köréhez vagy adminisztrációs funkciókhoz van szükségük hozzáférésre. Ez a szerepkör széleskörű hozzáférést biztosít a felhasználói fiókhoz és erőforrásokhoz, például a fiókbeállítások kezeléséhez, erőforrások létrehozásához vagy törléséhez, illetve adminisztratív feladatok elvégzéséhez.
• OAuth 1.0 - Az OAuth korábbi verziója, amely elsősorban webes munkafolyamatokat kezel.

További információkat az OAuth-ról itt talál.

Fejlécek (nem kötelező)

A fejlécek biztosítják az adatok eredetének hitelesítését, az adatok sértetlenségét és a visszajátszás elleni védelmet. Ezek a fejlécek a csatlakozó minden egyes funkciójához hozzá lesznek adva a csatlakozón.

Tanúsítványhivatalok bővítése

.pem formátumú fájlokat lehet feltölteni az alapértelmezett Node.js TLS tanúsítványhatóságok bővítéséhez. Ez a mező frissíti a Node.js TLS könyvtár ca mezőjét.

"Opcionálisan felülírhatja a megbízható hitelesítésszolgáltatói tanúsítványokat. Alapértelmezés szerint a Mozilla által kurátorként kezelt, jól ismert hitelesítésszolgáltatókban bízik. A Mozilla hitelesítésszolgáltatókat teljesen helyettesíti, ha a hitelesítésszolgáltatókat kifejezetten ezzel az opcióval adjuk meg. Az érték lehet egy string vagy Buffer, vagy stringek és/vagy Bufferek tömbje. Bármely karakterlánc vagy Buffer tartalmazhat több PEM hitelesítésszolgáltatót egymáshoz fűzve. A kapcsolat hitelesítéséhez a partner tanúsítványának egy, a kiszolgáló által megbízható CA-hoz kell kapcsolódnia. Olyan tanúsítványok használata esetén, amelyek nem kapcsolhatók egy jól ismert hitelesítésszolgáltatóhoz, a tanúsítvány hitelesítésszolgáltatóját kifejezetten megbízhatónak kell megadni, különben a kapcsolat hitelesítése sikertelen lesz. Ha a partner olyan tanúsítványt használ, amely nem illeszkedik az alapértelmezett hitelesítésszolgáltatók egyikéhez sem, vagy nem láncolható hozzá, akkor a ca opcióval adjon meg egy olyan hitelesítésszolgáltatói tanúsítványt, amelyhez a partner tanúsítványa illeszkedik, vagy amelyhez láncolható. Saját aláírású tanúsítványok esetén a tanúsítvány a saját CA-ja, és meg kell adni. A PEM kódolt tanúsítványok esetében a támogatott típusok a "TRUSTED CERTIFICATE", "X509 CERTIFICATE" és "CERTIFICATE". Lásd még tls.rootCertificates."

Egy érvényes CA példának valahogy így kell kinéznie:

-----BEGIN CERTIFICATE-----MIIDXTCCAkWgAwIBAgIJALaEfh0WW6ZcMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTAeFw0xNzA1MjUyMDE2NDRaFw0xNzA2MjQyMDE2NDRaMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK9b+GVsTsmP7z9T2sh79uI/57pI1DBYNyOlwC0lfn8SebVKRg0qAsaF3V4rQ/RPZFGkTb2G7IKnWQZ6VB8AFLF6A9xuGe7vSG9ZcJ1AKM2uOwYXzWQNWRFiW1XPOEIOXB+N7kMFTF6ZzE6RkV68hVqVn7Kx4s0RYAKM4ESJIMyF64IHo5Rf6k3UtrOzy6M3LXM3axgUPHkHZh6/Pi3hecaF7w0qDhlS8UJLA4Gn1I6nrFt1URVd7aSIEiOQhs7wAGDzCjNYMEQK9ih0GLd9ybCm0flYo5fJqfOhWiCFm2z3SuGH9MSnVdrzxY6x23J/gE3spPvBopF6bRjQl0qiw1ZAgMBAAGjUDBOMB0GA1UdDgQWBBRZtdl2jSWpITThx8JZL4Jx0zCBdTAfBgNVHSMEGDAWgBRZtdl2jSWpITThx8JZL4Jx0zCBdTAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBCwUAA4IBAQARzA8ydRMOfbU0QLOEp9V4B6nO8XBpe9uvtYwQjmb5ZX1bR2/P71bzeJwHK6v4RZl6V5fwGzFdsMFI8JAlLJChM1BpsU7a5R+U/X6XJpCzjErhZ68Z3G+TQ4Bk9LhRlQTH5ld9lR8aWpVPvPIqMtkJhbvWn9P4ysc8q3WYfILy9m9J8Hz3i3AaAEjS5WWm4BjKUMvOF

SQL-csatlakozó beállítása

MQTT-csatlakozó beállítása

Az MQTT-csatlakozók létrehozásának módja itt olvasható.

További olvasnivalók

• Csatlakozó pillanatképek készítése
• Gyorscsatlakozók beállítása
• Csatlakozók hibaelhárítása