Hogyan hozzon létre egy csatlakozót

Áttekintés

A csatlakozók lehetővé teszik a külső rendszerek és adatbázisok közötti integrációt. További információért lásd: "Mik azok a csatlakozók?".

Új 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 alatt található Csatlakozók oldalra. Kattintson a + Csatlakozó létrehozása gombra a jobb felső sarokban. Kiválaszthat egy meglévő Könyvtár-csatlakozó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: A következő rendszeren: Connector Host

Válassza ki a Connector Hostot, amely a kéréseket végrehajtja. 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 helyhez kötött csatlakozó host is megjelenik. A Connector Hostokkal kapcsolatos további információk itt találhatók.

:::(Warning) (Connector Host képességek) Egyes connector hostok nem támogatnak bizonyos funkciókat. Ezek a hosztok le lesznek tiltva vagy el lesznek rejtve a connector host legördülő listában. :::

HTTP-csatlakozó beállítása

A HTTP-csatlakozó funkciók beállításával kapcsolatos információk itt találhatók: HTTP-csatlakozófunkció létrehozása és beállítása

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éldául: a kiszolgálóm acme.co, és néhány funkcióm lekérdezi az sales.acme.co címet, mások a shipping.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

:::(Warning) (Connector Host verzió) Az OAuth ügyfélhitelesítési adatfolyamhoz LTS13 vagy újabb verziójú Cloud Connector Host vagy On Prem Connector Host felhőszolgáltatót kell használni.
:::

Type

• 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ó az OAuth-ról itt érhető el.

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ülbírálhatja 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 teljes mértékben 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 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----- MIIDXTCCAkWgAwIBAgIJALaEfh0WW6ZcMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV BAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9z ZTEPMA0GA1UECgwGQ29tcGFueTAeFw0xNzA1MjUyMDE2NDRaFw0xNzA2MjQyMDE2 NDRaMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYD VQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTCCASIwDQYJKoZIhvcNAQEB BQADggEPADCCAQoCggEBAK9b+GVsTsmP7z9T2sh79uI/57pI1DBYNyOlwC0lfn8S ebVKRg0qAsaF3V4rQ/RPZFGkTb2G7IKnWQZ6VB8AFLF6A9xuGe7vSG9ZcJ1AKM2u OwYXzWQNWRFiW1XPOEIOXB+N7kMFTF6ZzE6RkV68hVqVn7Kx4s0RYAKM4ESJIMyF 64IHo5Rf6k3UtrOzy6M3LXM3axgUPHkHZh6/Pi3hecaF7w0qDhlS8UJLA4Gn1I6n rFt1URVd7aSIEiOQhs7wAGDzCjNYMEQK9ih0GLd9ybCm0flYo5fJqfOhWiCFm2z3 SuGH9MSnVdrzxY6x23J/gE3spPvBopF6bRjQl0qiw1ZAgMBAAGjUDBOMB0GA1Ud DgQWBBRZtdl2jSWpITThx8JZL4Jx0zCBdTAfBgNVHSMEGDAWgBRZtdl2jSWpITTh x8JZL4Jx0zCBdTAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBCwUAA4IBAQARzA8y dRMOfbU0QLOEp9V4B6nO8XBpe9uvtYwQjmb5ZX1bR2/P71bzeJwHK6v4RZl6V5fw GzFdsMFI8JAlLJChM1BpsU7a5R+U/X6XJpCzjErhZ68Z3G+TQ4Bk9LhRlQTH5ld9 lR8aWpVPvPIqMtkJhbvWn9P4ysc8q3WYfILy9m9J8Hz3i3AaAE

SQL-csatlakozó beállítása

| Mező | Leírás | | | --- | --- | | | Kiszolgáló címe | Az adatbázis-kiszolgáló IP-címe vagy hostneve. Ez az a hely, ahol az adatbázis található és elérhető. | | Port | Az a portszám, amelyen az adatbázis-kiszolgáló hallgat. A MySQL esetében a 3306, a PostgreSQL esetében az 5432, az SQL Server esetében pedig az 1433-as portszámok a leggyakoribbak. | | SSL | Megadja, hogy az SSL (Secure Sockets Layer) protokollt használja-e az adatbázis-kiszolgálóval való kapcsolat titkosítására. Általában tartalmazza az SSL-mód és a tanúsítványok beállításait. | | Adatbázis | Annak a kiszolgálón lévő adatbázisnak a neve, amelyhez csatlakozni szeretne. Ez az a hely, ahol az adatok tárolódnak. | | Felhasználónév | A hitelesítéshez és az adatbázishoz való hozzáféréshez szükséges felhasználónév. Ennek a felhasználónak rendelkeznie kell az adatbázison végzett műveletekhez szükséges jogosultságokkal. | | Jelszó | A felhasználónévhez tartozó jelszó, amellyel a felhasználó hitelesíti magát az adatbázisban. Ez biztosítja a biztonságos hozzáférés-szabályozást. |

MQTT-csatlakozó beállítása

Az MQTT-csatlakozók létrehozásával kapcsolatos információk itt találhatók: Az első MQTT-csatlakozó létrehozása