Dışarıdaki sistemlerle konuşan bloklar hiçbir zaman adres veya parolayı kendileri tutmaz. Bunun yerine bir bağlantıyı adlandırırlar: bir kez kurup yeniden kullandığınız bir MQTT broker’ı veya bir HTTP uç noktası. Bağlantılardaki gizli bilgiler şifreli saklanır, bir daha gösterilmez ve hiçbir zaman bir mesaja, günlüğe, çalıştırma kaydına veya dışa aktarıma ulaşmaz.
Bağlantıları yönetme
- Automation‘ı, ardından üst bilgi menüsünü açın ve Connections seçeneğini seçin.
- New connection seçeneğini seçin, Type türünü belirleyin ve Next seçeneğini seçin.
- Alanları doldurun, ardından Save seçeneğini seçin.
- Kontrol etmek için Test seçeneğini seçin.
Bir bloğun ayarlarında Manage connections, bloğun kullanabildiği türlere göre filtrelenmiş aynı listeyi açar.
| Sütun | Gösterir |
|---|---|
| Name, Type, Version | Bağlantı |
| In use by | Bağlantıyı kullanan akışlar ve bloklar; aksi halde No flow uses it. |
| Uyarılar | “TLS not verified”, “Certificate ends in n days”, “Certificate expired” |
Hâlâ bir akışın kullandığı bağlantı silinemez: “A flow still uses it (n). Change those nodes first.”
HTTP uç noktası
“HTTP isteği düğümleri için kimlik doğrulamalı bir temel URL.”
| Alan | Anlamı | Değerler |
|---|---|---|
| base_url | Temel adres | http:// veya https://, zorunlu, en fazla 512 karakter, ?, # veya @ yok |
| allowed_hosts | Bir bloğun çağırabileceği hostlar | tam adlar veya tek seviyeli joker karakterler (*.example.com); varsayılan: temel URL’nin hostu |
| auth | Kimlik doğrulama | none, basic, bearer, header, oauth2_client_credentials, aws_sigv4 (bulut depolama ve işlev API’leri için imzalı istekler) |
| tls_verify | Sunucunun sertifikasını denetle | açık (varsayılan) |
| Özel CA (PEM) | Genel CA’lar yerine bu CA’lara güven | doğrulamayı kapatmak yerine bunu tercih edin |
| Client certificate (PEM), Client key (PEM), Client key password | İstemci sertifikası isteyen sunucular için (karşılıklı TLS) | anahtar ve parola gizli bilgilerdir |
Kimlik doğrulama alanları:
| auth | Alanlar |
|---|---|
| basic | username, password (gizli) |
| bearer | token (gizli), Authorization: Bearer olarak gönderilir |
| header | header_name (harfler, rakamlar, -, en fazla 64), header_value (gizli) |
| oauth2_client_credentials | token_url (https, izin verilen hostlarda), client_id, client_secret (gizli), scope, client_auth (basic veya body: kimliğin ve gizli bilginin nereye gideceği) |
| aws_sigv4 | access_key_id, secret_access_key (gizli), session_token (gizli, yalnızca geçici kimlik bilgileri), region, service |
- OAuth 2 client credentials: platform token URL’sinden bir token alır, süresi dolmadan bir dakika önce kadar saklar ve bunu bearer token olarak gönderir. API’den gelen bir
401, token’ı düşürür, böylece bir sonraki çağrı yenisini alır. Reddedilen bir istemcioauth_failedile başarısız olur. - Signed requests: her istek, tam olarak gönderilenleri imza kapsayacak şekilde, gönderilmeden hemen önce erişim anahtarıyla imzalanır. Her hizmet ve bölge için bir uç nokta kullanın ve anahtarın yalnızca akışın ihtiyaç duyduğu işleri yapabilmesini sağlayın.
- Test tek bir istek gönderir ve şu yanıtlardan birini verir: “The server answered and accepted the credentials.”, “The credentials were rejected.”, “The address is private or not allowed.”, “The certificate could not be verified.”, “The server did not answer in time.” ve benzeri.
MQTT broker
| Alan | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| host | Broker’ın adı veya adresi | zorunlu | her bağlantıda adres koruması ile denetlenir |
| port | Port | 1883 | 1 ile 65.535 arası (TLS ile genellikle 8883) |
| tls | TLS kullan | kapalı | özel CA ve karşılıklı TLS için istemci sertifikasıyla birlikte |
| tls_verify | Broker’ın sertifikasını denetle | açık | |
| protocol | MQTT sürümü | 5 | 3.1.1, 5 |
| client_id_mode | suffixed (temel ad artı bağlantı başına benzersiz bir sonek) veya fixed (verildiği gibi) | suffixed | |
| client_id | İstemci kimliği veya temel adı | yok | 256 karakter; fixed iken zorunlu |
| username, password | Kimlik bilgileri | yok | parola bir gizli bilgidir |
| topic_prefix | Bir konudaki ~/ ifadesinin karşılığı | yok | 256 karakter |
| keepalive_s | Canlı tutma | 60 | 1 ile 65.535 s arası |
| connect_timeout_ms | Bağlanma süresi | 10,000 | 1.000 ile 60.000 arası |
| clean_session | Her bağlantıyı boş bir oturumla başlat | açık | |
| session_expiry_s | MQTT 5, clean session kapalı: broker oturumu ne kadar süre saklar | 300 | 1 ile 86.400 s arası |
- Broker yalnızca istemci kimliği başına tek bağlantı kabul ettiğinde
fixedkullanın (bazı bulut broker’ları kimliği bir kimliğe bağlar): platform bu durumda kuruluş, broker ve kimlik için tam olarak bir bağlantı tutar. - QoS 2, kopan bağlantıda ayakta kalabilmesi için clean session kapalı olmasını gerektirir.
- Test tek bir bağlantı açar ve “The broker accepted the connection.”, “The broker refused the connection (code n).”, “The credentials were rejected.” ve benzeri sonuçları bildirir.
Harici zaman serisi veritabanı sunucusu
Harici bir zaman serisi veritabanına yazan blok için bağlantı: Server URL, izin verilen hostlar, veritabanının API sürümü (v2 veya v1), ardından Organisation ve API token (v2) veya Username ve Password (v1) ve tls_verify. Token ve parola gizli bilgilerdir. Yalnızca bu bloğu kullanıyorsanız kurun.
Adres kuralları
- Özel, loopback ve iç adresler, ad çözümlendikten sonra her denemede her zaman reddedilir (
ssrf_blocked, “The address is private or not allowed.”). Bağlantılarınız herkese açık adreslere işaret etmelidir. - Bir HTTP isteği yalnızca uç noktanın şemasına, portuna ve izin verilen hostlarına gider; temel yolun dışına çıkmaya çalışan bir yol reddedilir.
- Yönlendirmeler takip edilmez.
Gizli bilgiler
| Kural | Ayrıntı |
|---|---|
| Yalnızca yazılabilir | Kayıtlı bir gizli bilgi “A value is stored. Leave empty to keep it.” gösterir. Saklamak için alanı boş bırakın; değiştirmek için yeni bir değer yazın. |
| Şifreli | Şifreli olarak saklanır. Platformda şifreleme anahtarı ayarlı değilse, gizli bilgiyi kaydetmek başarısız olur (“Secrets cannot be stored right now…”). |
| Asla kopyalanmaz | Gizli bilgiler mesajlara, çalıştırma kayıtlarına, günlüklere, denetim günlüğüne veya dışa aktarımlara hiçbir zaman ulaşmaz. İçe aktarılan bir akışın bağlantılarının gizli bilgilerinin yeniden girilmesi gerekir. |
| Eşzamanlı düzenlemeler | “Someone else changed this connection since you opened it. Your changes were not saved.” Son sürümü açın ve yeniden düzenleyin. |
Webhook gizli bilgileri
token veya hmac kimlik doğrulamalı bir Webhook tetikleyicisinin üretilmiş bir gizli bilgisi vardır. Düzenleyicideki Webhooks iletişim kutusunu açın (akış yayımlandıktan ve açıldıktan sonra görünür):
| Öğe | Anlamı |
|---|---|
| Adres | Çağrılacak URL, Copy ile |
| Kimlik doğrulama | Bearer token, Signed request veya Signed-in session |
| Yanıt | “answers 202 at once” veya “answers with the flow’s reply” |
| Example call | Kopyalanacak hazır bir istek |
| Make a new secret | Bir kez gösterilen yeni bir gizli bilgi. “The old one keeps working for another 24 hours, so the callers can switch over.” |
| Revoke the old secret now | Yeni bir gizli bilgi; eskisi hemen durur. Eski gizli bilgi sızdıysa kullanın. |
Oturum webhook’un gizli bilgisi yoktur: çağıran, Call session-auth webhooks of deployed flows iznine (ve bloğun ek izni varsa ona) sahip, kuruluşunuzun oturum açmış bir üyesidir. Bkz. Trigger blocks.