Gateway erişime açma operasyon kılavuzu

Bu çalışma kılavuzu, daha kapsamlı Güvenlik rehberini uzaktan erişim ve mesajlaşma dışa açıklığı için bir operatör kontrol listesine dönüştürür.

Dışa açıklık modelini seçin

İş akışını karşılayan en dar kapsamlı modeli tercih edin.

Gateway'e doğrudan genel bağlantı noktası yönlendirmesinden kaçının. Genel erişim gerekiyorsa önüne kimlik duyarlı bir proxy yerleştirin ve Gateway'e giden tek ağ yolunun bu proxy olmasını sağlayın.

Ön kontrol envanteri

Bağlama, proxy, Tailscale veya kanal politikasını değiştirmeden önce şunları kaydedin:

• Gateway ana makinesi, işletim sistemi kullanıcısı ve durum dizini (varsayılan ~/.openclaw).
• Gateway URL'si ve bağlama modu (gateway.bind; varsayılan bağlantı noktası 18789).
• Kimlik doğrulama modu, belirteç/parola kaynağı veya güvenilir proxy kimlik kaynağı.
• Etkinleştirilmiş her kanal ve doğrudan mesajları, grupları ya da Webhook'ları kabul edip etmediği.
• Yerel olmayan göndericilerin erişebildiği ajanlar.
• Erişilebilir her ajan için araç profili, korumalı alan modu ve yükseltilmiş araç politikası.
• Bu ajanların erişebildiği harici kimlik bilgileri.
• ~/.openclaw/openclaw.json ve kimlik bilgilerinin yedek konumu.

Bota birden fazla kişi mesaj gönderebiliyorsa bunu kullanıcı başına ana makine yalıtımı olarak değil, paylaşılan ve devredilmiş araç yetkisi olarak değerlendirin.

Temel kontroller

Erişimi açmadan önce çalıştırın:

openclaw doctoropenclaw security auditopenclaw security audit --deepopenclaw health

Önce kritik bulguları giderin. Uyarıları yalnızca dağıtım açısından kasıtlı ve belgelenmiş olduklarında kabul edin. Her checkId değerinin anlamı ve düzeltme anahtarı için Güvenlik denetimi kontrolleri bölümüne bakın.

Uzaktan CLI doğrulaması için kimlik bilgilerini açıkça iletin:

openclaw gateway probe --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Yerel yapılandırmadaki kimlik bilgilerinin açıkça belirtilmiş bir uzak URL için geçerli olduğunu varsaymayın.

Asgari güvenli temel yapılandırma

Dış erişime açık dağıtımlarda başlangıç noktası olarak bu yapıyı kullanın:

{  gateway: {    bind: "loopback",    auth: {      mode: "token",      token: "replace-with-a-long-random-token",    },  },  session: {    dmScope: "per-channel-peer",  },  agents: {    defaults: {      sandbox: { mode: "non-main" },    },  },  tools: {    profile: "messaging",    exec: { security: "deny", ask: "always" },    elevated: { enabled: false },  },}

Her seferinde yalnızca bir denetimi genişletin: yazma yeteneğine sahip araçları etkinleştirmeden önce belirli bir kanal izin listesi ekleyin veya uzaktaki Control UI trafiğini kabul etmeden önce ters proxy'yi etkinleştirin.

tools.exec.security: "deny", zararsız tanılama işlemleri dâhil olmak üzere tüm exec çağrılarını engeller. Tanılama veya düşük riskli komutlar gerekiyorsa bu ayarı yalnızca tehdit modelinize uygun belirli göndericileri, ajanları, komutları ve onay modunu seçtikten sonra gevşetin.

Doğrudan mesaj ve grup dışa açıklığı

Mesajlaşma kanalları güvenilmeyen girdi yüzeyleridir. Doğrudan mesajlara veya gruplara izin vermeden önce:

• dmPolicy: "open" yerine dmPolicy: "pairing" veya sıkı bir allowFrom listesi tercih edin.
• "*" izin listelerini geniş araç erişimiyle birleştirmeyin.
• Oda sıkı biçimde denetlenmiyorsa gruplarda bahsetme zorunluluğu getirin.
• Birden fazla kişi bota doğrudan mesaj gönderebiliyorsa doğrudan mesaj oturumlarının bağlam paylaşmaması için session.dmScope: "per-channel-peer" (veya çok hesaplı kanallarda "per-account-channel-peer") ayarını kullanın.
• Paylaşılan kanalları asgari araçlara sahip ve kişisel kimlik bilgileri bulunmayan ajanlara yönlendirin.

Eşleştirme, göndericinin botu tetiklemesine onay verir. Göndericiyi ayrı bir ana makine güvenlik sınırı hâline getirmez.

Ters proxy kontrolleri

Kimlik duyarlı proxy'ler için:

• Proxy, Gateway'e yönlendirmeden önce kullanıcıların kimliğini doğrulamalıdır.
• Güvenlik duvarı veya ağ politikası, Gateway bağlantı noktasına doğrudan erişimi engellemelidir.
• gateway.trustedProxies yalnızca proxy kaynak IP'lerini listelemelidir.
• Proxy, istemci tarafından sağlanan kimlik ve yönlendirme üstbilgilerini kaldırmalı veya bunların üzerine yazmalıdır.
• Proxy birden fazla hedef kitleye hizmet veriyorsa gateway.auth.trustedProxy.allowUsers ayarını belirleyin.
• gateway.auth.trustedProxy.allowLoopback ayarını yalnızca yerel süreçlere güvenilen ve kimlik üstbilgilerinin proxy tarafından yönetildiği aynı ana makinedeki proxy için kullanın.

Proxy değişikliklerinden sonra openclaw security audit --deep komutunu çalıştırın. Proxy kimlik doğrulama sınırı hâline geldiği için güvenilir proxy bulguları güçlü sinyallerdir.

Araç ve korumalı alan incelemesi

Bir ajanı uzak göndericilere açmadan önce:

• Hangi oturumların ana makinede, hangilerinin korumalı alanda çalıştığını doğrulayın.
• Ana makinede exec kullanımını reddedin veya onaya tabi tutun.
• Belirli ve güvenilir bir gönderici ihtiyaç duymadıkça yükseltilmiş araçları devre dışı tutun.
• Açık veya yarı açık mesajlaşma yüzeylerinde tarayıcı, canvas, Node, Cron, Gateway ve oturum oluşturma araçlarından kaçının.
• Bağlama noktalarını dar kapsamlı tutun; kimlik bilgisi, ev dizini, Docker soketi ve sistem yollarından kaçının.
• Önemli ölçüde farklı güven sınırları için ayrı Gateway'ler, işletim sistemi kullanıcıları veya ana makineler kullanın.

Uzak kullanıcılar tamamen güvenilir değilse yalıtım yalnızca istemlerden veya oturum etiketlerinden değil, ayrı dağıtımlardan sağlanmalıdır.

Değişiklik sonrası doğrulama

Her dışa açıklık değişikliğinden sonra:

1. openclaw security audit --deep komutunu yeniden çalıştırın.
2. Yetkilendirilmiş bir bağlantının başarıyla kurulduğunu doğrulayın.
3. Yetkisiz bir göndericinin veya tarayıcı oturumunun reddedildiğini doğrulayın.
4. Günlüklerin gizli bilgileri maskelediğini doğrulayın.
5. Doğrudan mesaj/grup yönlendirmesinin yalnızca amaçlanan ajana ulaştığını doğrulayın.
6. Yüksek etkili araçların onay istediğini veya reddedildiğini doğrulayın.
7. Kabul edilen kalan uyarıları belgeleyin.

Mevcut dışa açıklık değişikliği anlaşılmadan bir sonraki değişikliğe geçmeyin.

Geri alma planı

Gateway gerekenden fazla dışa açılmış olabilecekse:

{  gateway: {    bind: "loopback",  },  channels: {    whatsapp: { dmPolicy: "disabled" },    telegram: { dmPolicy: "disabled" },    discord: { dmPolicy: "disabled" },    slack: { dmPolicy: "disabled" },  },  tools: {    exec: { security: "deny", ask: "always" },    elevated: { enabled: false },  },}

Ardından:

1. Genel yönlendirmeyi, Tailscale Funnel'ı veya ters proxy yollarını durdurun.
2. Gateway belirteçlerini/parolalarını ve etkilenen entegrasyon kimlik bilgilerini yenileyin.
3. İzin listelerinden "*" değerini ve beklenmeyen göndericileri kaldırın.
4. Son denetim günlüklerini, çalıştırma geçmişini, araç çağrılarını ve yapılandırma değişikliklerini inceleyin.
5. openclaw security audit --deep komutunu yeniden çalıştırın.
6. İş akışını karşılayan en dar kapsamlı modelle erişimi yeniden etkinleştirin.

İnceleme kontrol listesi

• Belgelenmiş bir neden bulunmadıkça Gateway yalnızca loopback üzerinde kalır.
• Loopback dışı erişimde kimlik doğrulama ve güvenlik duvarı vardır; doğrudan genel erişim yolu yoktur.
• Güvenilir proxy dağıtımlarında sıkı proxy IP'leri ve üstbilgi denetimleri vardır.
• Doğrudan mesajlar varsayılan olarak açık erişim yerine eşleştirme veya izin listeleri kullanır.
• Gruplar bahsetme veya açık izin listeleri gerektirir.
• Paylaşılan kanallar kişisel kimlik bilgilerine erişmez.
• Ana olmayan oturumlar korumalı alan modunda çalışır.
• Ana makinede exec kullanımı ve yükseltilmiş araçlar reddedilir veya onaya tabidir.
• Günlükler gizli bilgileri maskeler.
• Kritik denetim bulguları giderilmiştir.
• Geri alma adımları test edilmiş ve belgelenmiştir.