MENU
    Hogyan hozzon létre egy csatlakozót
    • 08 Jan 2025
    • 4 Elolvasandó percek
    • Közreműködők

    Hogyan hozzon létre egy csatlakozót


    Cikk összefoglaló

    Á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

    image.png

    Alapinformá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.

    Connector Host Capabilities

    Some connector hosts do not support certain features. These hosts will be disabled or hidden in the connector host dropdown.

    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: Hogyan hozzunk létre és konfiguráljunk egy HTTP-csatlakozó funkciót?

    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 függvényem 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

    Connector Host Version

    For the OAuth Client Credential flow, Cloud Connector Host or On Prem Connector Host of version LTS13 or newer must be used.

    Típus:

    • No Auth - Nincs szükség hitelesítésre, vagy a hitelesítés más kérési fejlé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. Ezek egy átláthatatlan karakterláncból állnak, és nem arra szolgálnak, hogy az azt használó ügyfelek számára jelentéssel bírjanak.
    • 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

    image.png

    .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 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 egyezik meg az alapértelmezett hitelesítésszolgáltatók egyikével, vagy nem láncolható hozzá, akkor a ca opcióval adjon meg egy olyan hitelesítésszolgáltatói tanúsítványt, amellyel a partner tanúsítványa egyezhet, 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 Connector beállítása

    MezőLeírás
    Kiszolgáló címeAz adatbázis-kiszolgáló IP-címe vagy hostneve. Ez az a hely, ahol az adatbázist tárolják, és ahol az adatbázis elérhető.
    PortA portszám, amelyen az adatbázis-kiszolgáló hallgatja. A MySQL esetében a 3306, a PostgreSQL esetében az 5432, az SQL Server esetében az 1433 általános portszámok.
    SSLMegadja, 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ázisAnnak a kiszolgálón lévő konkrét adatbázisnak a neve, amelyhez csatlakozni szeretne. Ez az a hely, ahol az adatok tárolódnak.
    FelhasználónévA 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 a szükséges jogosultságokkal az adatbázison végzett műveletek elvégzéséhez.
    JelszóA felhasználónévhez tartozó jelszó, amely a felhasználó hitelesítésére szolgál az adatbázisban. Ez biztosítja a biztonságos hozzáférés-szabályozást.

    MQTT-csatlakozó beállítása

    Az MQTT-konnektorok létrehozásával kapcsolatos információk itt találhatók: Hogyan készítsük el az első MQTT-konnektort?


    Hasznos volt ez a cikk?