Gateway protokolü

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Taşıma

• JSON yükleri içeren metin çerçeveleriyle WebSocket.
• İlk çerçeve mutlaka bir connect isteği olmalıdır.
• Bağlantı öncesi çerçeveler 64 KiB ile sınırlandırılır. Başarılı bir el sıkışmadan sonra istemciler hello-ok.policy.maxPayload ve hello-ok.policy.maxBufferedBytes sınırlarına uymalıdır. Tanılamalar etkinken, aşırı büyük gelen çerçeveler ve yavaş giden arabellekler, gateway etkilenen çerçeveyi kapatmadan veya düşürmeden önce payload.large olayları yayar. Bu olaylar boyutları, sınırları, yüzeyleri ve güvenli neden kodlarını tutar. Mesaj gövdesini, ek içeriklerini, ham çerçeve gövdesini, belirteçleri, çerezleri veya gizli değerleri tutmazlar.

​

El sıkışma (connect)

{
  "type": "event",
  "event": "connect.challenge",
  "payload": { "nonce": "…", "ts": 1737264000000 }
}

{
  "type": "req",
  "id": "…",
  "method": "connect",
  "params": {
    "minProtocol": 3,
    "maxProtocol": 4,
    "client": {
      "id": "cli",
      "version": "1.2.3",
      "platform": "macos",
      "mode": "operator"
    },
    "role": "operator",
    "scopes": ["operator.read", "operator.write"],
    "caps": [],
    "commands": [],
    "permissions": {},
    "auth": { "token": "…" },
    "locale": "en-US",
    "userAgent": "openclaw-cli/1.2.3",
    "device": {
      "id": "device_fingerprint",
      "publicKey": "…",
      "signature": "…",
      "signedAt": 1737264000000,
      "nonce": "…"
    }
  }
}

{
  "type": "res",
  "id": "…",
  "ok": true,
  "payload": {
    "type": "hello-ok",
    "protocol": 4,
    "server": { "version": "…", "connId": "…" },
    "features": { "methods": ["…"], "events": ["…"] },
    "snapshot": { "…": "…" },
    "auth": {
      "role": "operator",
      "scopes": ["operator.read", "operator.write"]
    },
    "policy": {
      "maxPayload": 26214400,
      "maxBufferedBytes": 52428800,
      "tickIntervalMs": 15000
    }
  }
}

{
  "auth": {
    "role": "operator",
    "scopes": ["operator.read", "operator.write"]
  }
}

{
  "auth": {
    "deviceToken": "…",
    "role": "operator",
    "scopes": ["operator.read", "operator.write"]
  }
}

{
  "auth": {
    "deviceToken": "…",
    "role": "node",
    "scopes": [],
    "deviceTokens": [
      {
        "deviceToken": "…",
        "role": "operator",
        "scopes": ["operator.approvals", "operator.read", "operator.talk.secrets", "operator.write"]
      }
    ]
  }
}

​

Node örneği

{
  "type": "req",
  "id": "…",
  "method": "connect",
  "params": {
    "minProtocol": 3,
    "maxProtocol": 4,
    "client": {
      "id": "ios-node",
      "version": "1.2.3",
      "platform": "ios",
      "mode": "node"
    },
    "role": "node",
    "scopes": [],
    "caps": ["camera", "canvas", "screen", "location", "voice"],
    "commands": ["camera.snap", "canvas.navigate", "screen.record", "location.get"],
    "permissions": { "camera.capture": true, "screen.record": false },
    "auth": { "token": "…" },
    "locale": "en-US",
    "userAgent": "openclaw-ios/1.2.3",
    "device": {
      "id": "device_fingerprint",
      "publicKey": "…",
      "signature": "…",
      "signedAt": 1737264000000,
      "nonce": "…"
    }
  }
}

​

Çerçeveleme

• İstek: {type:"req", id, method, params}
• Yanıt: {type:"res", id, ok, payload|error}
• Olay: {type:"event", event, payload, seq?, stateVersion?}

​

Roller + kapsamlar

​

Roller

• operator = kontrol düzlemi istemcisi (CLI/kullanıcı arayüzü/otomasyon).
• node = yetenek ana makinesi (camera/screen/canvas/system.run).

​

Kapsamlar (operator)

• operator.read
• operator.write
• operator.admin
• operator.approvals
• operator.pairing
• operator.talk.secrets

• komutsuz istekler: operator.pairing
• exec olmayan node komutları içeren istekler: operator.pairing + operator.write
• system.run, system.run.prepare veya system.which içeren istekler: operator.pairing + operator.admin

​

Yetenekler/komutlar/izinler (node)

• caps: camera, canvas, screen, location, voice ve talk gibi üst düzey yetenek kategorileri.
• commands: çağırma için komut izin listesi.
• permissions: ayrıntılı anahtarlar (örn. screen.record, camera.capture).

​

Varlık

• system-presence, cihaz kimliğine göre anahtarlanmış girişler döndürür.
• Varlık girişleri deviceId, roles ve scopes içerir; böylece kullanıcı arayüzleri, cihaz hem operator hem de node olarak bağlandığında bile cihaz başına tek bir satır gösterebilir.
• node.list, isteğe bağlı lastSeenAtMs ve lastSeenReason alanlarını içerir. Bağlı node’lar mevcut bağlantı zamanlarını connect nedeniyle lastSeenAtMs olarak bildirir; eşleştirilmiş node’lar, güvenilen bir node olayı eşleştirme meta verilerini güncellediğinde kalıcı arka plan varlığı da bildirebilir.

​

Node arka plan canlı olayı

{
  "event": "node.presence.alive",
  "payloadJSON": "{\"trigger\":\"silent_push\",\"sentAtMs\":1737264000000,\"displayName\":\"Peter's iPhone\",\"version\":\"2026.4.28\",\"platform\":\"iOS 18.4.0\",\"deviceFamily\":\"iPhone\",\"modelIdentifier\":\"iPhone17,1\",\"pushTransport\":\"relay\"}"
}

{
  "ok": true,
  "event": "node.presence.alive",
  "handled": true,
  "reason": "persisted"
}

​

Yayın olayı kapsamlandırması

• Sohbet, aracı ve araç sonucu çerçeveleri (akışlı agent olayları ve araç çağrısı sonuçları dahil) en az operator.read gerektirir. operator.read olmayan oturumlar bu çerçeveleri tamamen atlar.
• Plugin tanımlı plugin.* yayınları, plugin’in bunları nasıl kaydettiğine bağlı olarak operator.write veya operator.admin ile kapılanır.
• Durum ve taşıma olayları (heartbeat, presence, tick, bağlantı/bağlantı kesme yaşam döngüsü vb.) sınırsız kalır; böylece taşıma sağlığı her kimliği doğrulanmış oturum tarafından gözlemlenebilir kalır.
• Bilinmeyen yayın olayı aileleri, kayıtlı bir işleyici bunları açıkça gevşetmediği sürece varsayılan olarak kapsam kapılıdır (kapalı başarısızlık).

​

Yaygın RPC yöntem aileleri

​

Yaygın olay aileleri

• chat: chat.inject gibi UI sohbet güncellemeleri ve yalnızca transkript içeren diğer sohbet olayları.
• session.message ve session.tool: abone olunan bir oturum için transkript/olay akışı güncellemeleri.
• sessions.changed: oturum dizini veya meta verileri değişti.
• presence: sistem varlık anlık görüntüsü güncellemeleri.
• tick: periyodik keepalive / canlılık olayı.
• health: gateway sağlık anlık görüntüsü güncellemesi.
• heartbeat: Heartbeat olay akışı güncellemesi.
• cron: Cron çalıştırma/iş değişikliği olayı.
• shutdown: gateway kapanma bildirimi.
• node.pair.requested / node.pair.resolved: node eşleştirme yaşam döngüsü.
• node.invoke.request: node invoke isteği yayını.
• device.pair.requested / device.pair.resolved: eşleştirilmiş cihaz yaşam döngüsü.
• voicewake.changed: wake-word tetikleyici yapılandırması değişti.
• exec.approval.requested / exec.approval.resolved: exec onay yaşam döngüsü.
• plugin.approval.requested / plugin.approval.resolved: plugin onay yaşam döngüsü.

​

Node yardımcı yöntemleri

• Node’lar, otomatik izin denetimleri için mevcut skill yürütülebilirleri listesini almak üzere skills.bins çağırabilir.

​

Görev defteri RPC’leri

• tasks.list, operator.read gerektirir.
  • Parametreler: isteğe bağlı status ("queued", "running", "completed", "failed", "cancelled" veya "timed_out") ya da bu durumların bir dizisi, isteğe bağlı agentId, isteğe bağlı sessionKey, 1 ile 500 arasında isteğe bağlı limit ve isteğe bağlı string cursor.
  • Sonuç: { "tasks": TaskSummary[], "nextCursor"?: string }.
• tasks.get, operator.read gerektirir.
  • Parametreler: { "taskId": string }.
  • Sonuç: { "task": TaskSummary }.
  • Eksik görev kimlikleri Gateway not-found hata biçimini döndürür.
• tasks.cancel, operator.write gerektirir.
  • Parametreler: { "taskId": string, "reason"?: string }.
  • Sonuç: { "found": boolean, "cancelled": boolean, "reason"?: string, "task"?: TaskSummary }.
  • found, defterde eşleşen bir görev olup olmadığını bildirir. cancelled, çalışma zamanının iptali kabul edip etmediğini veya kaydedip kaydetmediğini bildirir.

​

Operatör yardımcı yöntemleri

• Operatörler, bir agent için çalışma zamanı komut envanterini almak üzere commands.list (operator.read) çağırabilir.
  • agentId isteğe bağlıdır; varsayılan agent çalışma alanını okumak için atlayın.
  • scope, birincil name değerinin hangi yüzeyi hedeflediğini denetler:
    • text, başında / olmadan birincil metin komutu belirtecini döndürür
    • native ve varsayılan both yolu, mevcut olduğunda sağlayıcı farkındalıklı yerel adları döndürür
  • textAliases, /model ve /m gibi tam slash alias’larını taşır.
  • nativeName, varsa sağlayıcı farkındalıklı yerel komut adını taşır.
  • provider isteğe bağlıdır ve yalnızca yerel adlandırmayı ve yerel plugin komut kullanılabilirliğini etkiler.
  • includeArgs=false, serileştirilmiş argüman meta verilerini yanıttan çıkarır.
• Operatörler, bir agent için çalışma zamanı araç kataloğunu almak üzere tools.catalog (operator.read) çağırabilir. Yanıt, gruplanmış araçları ve provenans meta verilerini içerir:
  • source: core veya plugin
  • pluginId: source="plugin" olduğunda plugin sahibi
  • optional: bir plugin aracının isteğe bağlı olup olmadığı
• Operatörler, bir oturum için çalışma zamanında etkili araç envanterini almak üzere tools.effective (operator.read) çağırabilir.
  • sessionKey gereklidir.
  • Gateway, çağıranın sağladığı auth veya teslim bağlamını kabul etmek yerine güvenilir çalışma zamanı bağlamını sunucu tarafındaki oturumdan türetir.
  • Yanıt oturum kapsamındadır ve etkin konuşmanın şu anda kullanabileceği core, plugin ve kanal araçları dahil her şeyi yansıtır.
• Operatörler, /tools/invoke ile aynı gateway ilkesi yolu üzerinden kullanılabilir bir aracı çağırmak için tools.invoke (operator.write) çağırabilir.
  • name gereklidir. args, sessionKey, agentId, confirm ve idempotencyKey isteğe bağlıdır.
  • Hem sessionKey hem de agentId varsa, çözümlenen oturum agent’ı agentId ile eşleşmelidir.
  • Yanıt, ok, toolName, isteğe bağlı output ve tipli error alanları içeren SDK’ya dönük bir zarf biçimindedir. Onay veya ilke retleri, gateway araç ilkesi işlem hattını atlamak yerine payload içinde ok:false döndürür.
• Operatörler, bir agent için görünür skill envanterini almak üzere skills.status (operator.read) çağırabilir.
  • agentId isteğe bağlıdır; varsayılan agent çalışma alanını okumak için atlayın.
  • Yanıt, ham secret değerlerini göstermeden uygunluk durumunu, eksik gereksinimleri, yapılandırma denetimlerini ve temizlenmiş kurulum seçeneklerini içerir.
• Operatörler, ClawHub keşif meta verileri için skills.search ve skills.detail (operator.read) çağırabilir.
• Operatörler, bir private skill arşivini kurmadan önce hazırlamak için skills.upload.begin, skills.upload.chunk ve skills.upload.commit (operator.admin) çağırabilir. Bu, güvenilir istemciler için ayrı bir admin upload yoludur; normal ClawHub skill kurulum akışı değildir ve skills.install.allowUploadedArchives etkinleştirilmedikçe varsayılan olarak devre dışıdır.
  • skills.upload.begin({ kind: "skill-archive", slug, sizeBytes, sha256?, force?, idempotencyKey? }) bu slug ve force değerine bağlı bir upload oluşturur.
  • skills.upload.chunk({ uploadId, offset, dataBase64 }), baytları tam olarak çözümlenen offset konumuna ekler.
  • skills.upload.commit({ uploadId, sha256? }), son boyutu ve SHA-256 değerini doğrular. Commit yalnızca upload’u sonlandırır; skill’i kurmaz.
  • Yüklenen skill arşivleri, kökte SKILL.md içeren zip arşivleridir. Arşivin iç dizin adı hiçbir zaman kurulum hedefini seçmez.
• Operatörler, skills.install (operator.admin) öğesini üç modda çağırabilir:
  • ClawHub modu: { source: "clawhub", slug, version?, force? }, bir skill klasörünü varsayılan agent çalışma alanındaki skills/ dizinine kurar.
  • Upload modu: { source: "upload", uploadId, slug, force?, sha256?, timeoutMs? }, commit edilmiş bir upload’u varsayılan agent çalışma alanındaki skills/<slug> dizinine kurar. Slug ve force değeri, özgün skills.upload.begin isteğiyle eşleşmelidir. Bu mod, skills.install.allowUploadedArchives etkinleştirilmedikçe reddedilir. Ayar, ClawHub kurulumlarını etkilemez.
  • Gateway kurucu modu: { name, installId, dangerouslyForceUnsafeInstall?, timeoutMs? }, gateway host üzerinde bildirilmiş bir metadata.openclaw.install eylemini çalıştırır.
• Operatörler, skills.update (operator.admin) öğesini iki modda çağırabilir:
  • ClawHub modu, varsayılan agent çalışma alanındaki izlenen bir slug’ı veya izlenen tüm ClawHub kurulumlarını günceller.
  • Config modu, enabled, apiKey ve env gibi skills.entries.<skillKey> değerlerini yamalar.

​

models.list görünümleri

• Atlanmış veya "default": mevcut çalışma zamanı davranışı. agents.defaults.models yapılandırıldıysa, yanıt izin verilen katalogdur ve provider/* girdileri için dinamik olarak keşfedilen modelleri içerir. Aksi takdirde yanıt tam Gateway kataloğudur.
• "configured": picker boyutunda davranış. agents.defaults.models yapılandırıldıysa, provider/* girdileri için sağlayıcı kapsamlı keşif dahil hâlâ o kazanır. Bir allowlist olmadan, yanıt açık models.providers.*.models girdilerini kullanır ve yalnızca yapılandırılmış model satırı yoksa tam kataloğa geri döner.
• "all": agents.defaults.models öğesini atlayarak tam Gateway kataloğu. Bunu normal model picker’ları için değil, tanılama ve keşif UI’leri için kullanın.

​

Exec onayları

• Bir exec isteği onay gerektirdiğinde, gateway exec.approval.requested yayınlar.
• Operatör istemcileri exec.approval.resolve çağırarak çözer (operator.approvals kapsamı gerektirir).
• host=node için, exec.approval.request içinde systemRunPlan (kanonik argv/cwd/rawCommand/oturum meta verileri) bulunmalıdır. systemRunPlan eksik olan istekler reddedilir.
• Onaydan sonra, iletilen node.invoke system.run çağrıları bu kanonik systemRunPlan değerini yetkili komut/cwd/oturum bağlamı olarak yeniden kullanır.
• Bir çağıran, hazırlama ile onaylanmış son system.run iletimi arasında command, rawCommand, cwd, agentId veya sessionKey değerini değiştirirse gateway, değiştirilmiş payload’a güvenmek yerine çalıştırmayı reddeder.

​

Agent teslimi geri dönüşü

• agent istekleri, giden teslimi istemek için deliver=true içerebilir.
• bestEffortDeliver=false katı davranışı korur: çözümlenemeyen veya yalnızca dahili teslim hedefleri INVALID_REQUEST döndürür.
• bestEffortDeliver=true, harici teslim edilebilir bir rota çözümlenemediğinde oturumla sınırlı yürütmeye geri dönüşe izin verir (örneğin dahili/webchat oturumları veya belirsiz çok kanallı yapılandırmalar).
• Nihai agent sonuçları, teslim istendiğinde openclaw agent --json --deliver için belgelenen aynı sent, suppressed, partial_failed ve failed durumlarını kullanarak result.deliveryStatus içerebilir.

​

Sürümleme

• PROTOCOL_VERSION, src/gateway/protocol/version.ts içinde bulunur.
• İstemciler minProtocol + maxProtocol gönderir; sunucu, mevcut protokolünü içermeyen aralıkları reddeder. Native istemciler v3 alt sınırı kullanır; böylece eklemeli v4 istemcileri hâlâ v3 gateway’lere erişebilir.
• Şemalar + modeller TypeBox tanımlarından üretilir:
  • pnpm protocol:gen
  • pnpm protocol:gen:swift
  • pnpm protocol:check

​

İstemci sabitleri

​

Kimlik Doğrulama

• Paylaşılan gizli anahtarlı gateway kimlik doğrulaması, yapılandırılmış kimlik doğrulama moduna bağlı olarak connect.params.auth.token veya connect.params.auth.password kullanır.
• Tailscale Serve (gateway.auth.allowTailscale: true) veya local loopback olmayan gateway.auth.mode: "trusted-proxy" gibi kimlik taşıyan modlar, bağlantı kimlik doğrulama denetimini connect.params.auth.* yerine istek üst bilgilerinden karşılar.
• Özel giriş gateway.auth.mode: "none", paylaşılan gizli anahtarlı bağlantı kimlik doğrulamasını tamamen atlar; bu modu genel/güvenilmeyen girişlerde açığa çıkarmayın.
• Eşleştirmeden sonra Gateway, bağlantı rolü + kapsamlarıyla sınırlı bir cihaz belirteci verir. Bu belirteç hello-ok.auth.deviceToken içinde döndürülür ve istemci tarafından gelecekteki bağlantılar için kalıcı olarak saklanmalıdır.
• İstemciler, başarılı herhangi bir bağlantıdan sonra birincil hello-ok.auth.deviceToken değerini kalıcı olarak saklamalıdır.
• Bu saklanan cihaz belirteciyle yeniden bağlanmak, o belirteç için saklanan onaylanmış kapsam kümesini de yeniden kullanmalıdır. Bu, zaten verilmiş okuma/yoklama/durum erişimini korur ve yeniden bağlantıların sessizce daha dar örtük yalnızca yönetici kapsamına düşmesini önler.
• İstemci tarafı bağlantı kimlik doğrulaması derlemesi (src/gateway/client.ts içindeki selectConnectAuth):
  • auth.password bağımsızdır ve ayarlandığında her zaman iletilir.
  • auth.token öncelik sırasına göre doldurulur: önce açık paylaşılan belirteç, ardından açık bir deviceToken, ardından saklanan cihaz başına belirteç (deviceId + role ile anahtarlanır).
  • auth.bootstrapToken yalnızca yukarıdakilerden hiçbiri bir auth.token çözümlemediğinde gönderilir. Paylaşılan belirteç veya çözümlenmiş herhangi bir cihaz belirteci bunu bastırır.
  • Tek seferlik AUTH_TOKEN_MISMATCH yeniden denemesinde saklanan bir cihaz belirtecinin otomatik yükseltilmesi yalnızca güvenilir uç noktalarla sınırlıdır — local loopback veya sabitlenmiş tlsFingerprint ile wss://. Sabitleme olmadan genel wss:// uygun değildir.
• Ek hello-ok.auth.deviceTokens girdileri bootstrap aktarım belirteçleridir. Bunları yalnızca bağlantı, wss:// veya loopback/yerel eşleştirme gibi güvenilir bir taşıma üzerinde bootstrap kimlik doğrulaması kullandığında kalıcı olarak saklayın.
• Bir istemci açık deviceToken veya açık scopes sağlarsa, çağıranın istediği kapsam kümesi yetkili kalır; önbelleğe alınmış kapsamlar yalnızca istemci saklanan cihaz başına belirteci yeniden kullandığında yeniden kullanılır.
• Cihaz belirteçleri device.token.rotate ve device.token.revoke ile döndürülebilir/iptal edilebilir (operator.pairing kapsamı gerekir).
• device.token.rotate, döndürme meta verilerini döndürür. Yedek taşıyıcı belirteci yalnızca halihazırda o cihaz belirteciyle kimliği doğrulanmış aynı cihaz çağrıları için yankılar; böylece yalnızca belirteç kullanan istemciler yeniden bağlanmadan önce yedeklerini kalıcı olarak saklayabilir. Paylaşılan/ yönetici döndürmeleri taşıyıcı belirteci yankılamaz.
• Belirteç verme, döndürme ve iptal işlemleri, o cihazın eşleştirme girdisinde kaydedilen onaylı rol kümesiyle sınırlı kalır; belirteç değişikliği, eşleştirme onayının hiç vermediği bir cihaz rolünü genişletemez veya hedefleyemez.
• Eşleştirilmiş cihaz belirteci oturumları için, çağıranın operator.admin yetkisi de yoksa cihaz yönetimi kendi kapsamıyla sınırlıdır: yönetici olmayan çağıranlar yalnızca kendi cihaz girdilerini kaldırabilir/iptal edebilir/ döndürebilir.
• device.token.rotate ve device.token.revoke, hedef operator belirteci kapsam kümesini çağıranın geçerli oturum kapsamlarına karşı da denetler. Yönetici olmayan çağıranlar, zaten sahip olduklarından daha geniş bir operator belirtecini döndüremez veya iptal edemez.
• Kimlik doğrulama hataları error.details.code ve kurtarma ipuçlarını içerir:
  • error.details.canRetryWithDeviceToken (boolean)
  • error.details.recommendedNextStep (retry_with_device_token, update_auth_configuration, update_auth_credentials, wait_then_retry, review_auth_configuration)
• AUTH_TOKEN_MISMATCH için istemci davranışı:
  • Güvenilir istemciler, önbelleğe alınmış cihaz başına belirteçle sınırlı bir yeniden deneme yapabilir.
  • Bu yeniden deneme başarısız olursa, istemciler otomatik yeniden bağlanma döngülerini durdurmalı ve operator eylem yönlendirmesini göstermelidir.
• AUTH_SCOPE_MISMATCH, cihaz belirtecinin tanındığı ancak istenen rolü/kapsamları kapsamadığı anlamına gelir. İstemciler bunu kötü bir belirteç olarak sunmamalıdır; operator’den yeniden eşleştirme yapmasını veya daha dar/daha geniş kapsam sözleşmesini onaylamasını istemelidir.

​

Cihaz kimliği + eşleştirme

• Node’lar, anahtar çifti parmak izinden türetilmiş kararlı bir cihaz kimliği (device.id) içermelidir.
• Gateway’ler cihaz + rol başına belirteç verir.
• Yerel otomatik onay etkin değilse yeni cihaz kimlikleri için eşleştirme onayları gerekir.
• Eşleştirme otomatik onayı, doğrudan yerel local loopback bağlantılarına odaklanır.
• OpenClaw ayrıca güvenilir paylaşılan gizli yardımcı akışlar için dar bir arka uç/konteyner-yerel kendi kendine bağlantı yoluna sahiptir.
• Aynı ana bilgisayar tailnet veya LAN bağlantıları, eşleştirme için yine de uzak olarak değerlendirilir ve onay gerektirir.
• WS istemcileri normalde connect sırasında device kimliği içerir (operator + node). Cihazsız tek operator istisnaları açık güven yollarıdır:
  • localhost’a özel güvensiz HTTP uyumluluğu için gateway.controlUi.allowInsecureAuth=true.
  • başarılı gateway.auth.mode: "trusted-proxy" operator Control UI kimlik doğrulaması.
  • gateway.controlUi.dangerouslyDisableDeviceAuth=true (son çare, ciddi güvenlik düşürmesi).
  • paylaşılan gateway belirteci/parolasıyla kimliği doğrulanmış doğrudan-loopback gateway-client arka uç RPC’leri.
• Tüm bağlantılar, sunucu tarafından sağlanan connect.challenge nonce değerini imzalamalıdır.

​

Cihaz kimlik doğrulaması geçiş tanılamaları

• Her zaman connect.challenge bekleyin.
• Sunucu nonce değerini içeren v2 yükünü imzalayın.
• Aynı nonce değerini connect.params.device.nonce içinde gönderin.
• Tercih edilen imza yükü v3 değeridir; bu, cihaz/istemci/rol/kapsamlar/ belirteç/nonce alanlarına ek olarak platform ve deviceFamily değerlerini bağlar.
• Eski v2 imzaları uyumluluk için kabul edilmeye devam eder, ancak eşleştirilmiş cihaz meta verisi sabitlemesi yeniden bağlantıda komut politikasını hâlâ denetler.

​

TLS + sabitleme

• TLS, WS bağlantıları için desteklenir.
• İstemciler isteğe bağlı olarak gateway sertifika parmak izini sabitleyebilir (gateway.tls yapılandırmasına ve gateway.remote.tlsFingerprint ya da CLI --tls-fingerprint değerine bakın).

​

Kapsam

​

İlgili

• Bridge protokolü
• Gateway çalışma kılavuzu