Gateway एक्सपोज़र रनबुक

​

एक्सपोजर पैटर्न चुनें

​

प्री-फ़्लाइट इन्वेंटरी

• Gateway होस्ट, OS उपयोगकर्ता, और स्टेट डायरेक्टरी।
• Gateway URL और बाइंड मोड।
• प्रमाणीकरण मोड, टोकन/पासवर्ड स्रोत, या विश्वसनीय प्रॉक्सी पहचान स्रोत।
• सभी सक्षम चैनल और क्या वे DM, समूह, या webhooks स्वीकार करते हैं।
• गैर-स्थानीय प्रेषकों से पहुंच योग्य एजेंट।
• प्रत्येक पहुंच योग्य एजेंट के लिए टूल प्रोफ़ाइल, सैंडबॉक्स मोड, और एलिवेटेड टूल नीति।
• उन एजेंटों के लिए उपलब्ध बाहरी क्रेडेंशियल।
• ~/.openclaw/openclaw.json और क्रेडेंशियल के लिए बैकअप स्थान।

​

बेसलाइन जांच

openclaw doctor
openclaw security audit
openclaw security audit --deep
openclaw health

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

​

न्यूनतम सुरक्षित बेसलाइन

{
  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 },
  },
}

​

DM और समूह एक्सपोजर

• dmPolicy: "pairing" या सख्त allowFrom सूचियों को प्राथमिकता दें।
• जब तक हर प्रेषक विश्वसनीय न हो, dmPolicy: "open" से बचें।
• व्यापक टूल एक्सेस के साथ "*" अलाउलिस्ट को संयोजित न करें।
• समूहों में मेंशन आवश्यक करें, जब तक कि रूम सख्ती से नियंत्रित न हो।
• जब कई लोग बॉट को DM कर सकते हैं, तो session.dmScope: "per-channel-peer" का उपयोग करें।
• साझा चैनलों को न्यूनतम टूल और बिना व्यक्तिगत क्रेडेंशियल वाले एजेंटों तक रूट करें।

​

रिवर्स प्रॉक्सी जांच

• प्रॉक्सी को Gateway पर फ़ॉरवर्ड करने से पहले उपयोगकर्ताओं को प्रमाणित करना होगा।
• Gateway पोर्ट तक सीधा एक्सेस फ़ायरवॉल या नेटवर्क नीति द्वारा ब्लॉक होना चाहिए।
• gateway.trustedProxies में केवल प्रॉक्सी स्रोत IP होने चाहिए।
• प्रॉक्सी को क्लाइंट द्वारा दिए गए पहचान और फ़ॉरवर्डिंग हेडर स्ट्रिप या ओवरराइट करने होंगे।
• जब प्रॉक्सी एक से अधिक ऑडियंस को सेवा देता है, तो gateway.auth.trustedProxy.allowUsers में अपेक्षित उपयोगकर्ताओं की सूची होनी चाहिए।
• समान-होस्ट लूपबैक प्रॉक्सी मोड को allowLoopback का उपयोग केवल तब करना चाहिए जब स्थानीय प्रक्रियाएं विश्वसनीय हों और प्रॉक्सी पहचान हेडर का स्वामी हो।

​

टूल और सैंडबॉक्स समीक्षा

• पुष्टि करें कि कौन से सेशन होस्ट पर चलते हैं और कौन से सैंडबॉक्स में।
• होस्ट exec को अस्वीकार करें या उसके लिए अनुमोदन आवश्यक करें।
• जब तक किसी विशिष्ट, विश्वसनीय प्रेषक को उनकी जरूरत न हो, एलिवेटेड टूल अक्षम रखें।
• खुले या अर्ध-खुले मैसेजिंग सतहों के लिए ब्राउज़र, कैनवास, node, cron, gateway, और session-spawn टूल से बचें।
• बाइंड माउंट संकीर्ण रखें और क्रेडेंशियल, होम, Docker सॉकेट, और सिस्टम पथों से बचें।
• भौतिक रूप से अलग भरोसे की सीमाओं के लिए अलग gateways, OS उपयोगकर्ता, या होस्ट का उपयोग करें।

​

बदलाव के बाद सत्यापन

1. openclaw security audit --deep दोबारा चलाएं।
2. एक सफल अधिकृत कनेक्शन का परीक्षण करें।
3. परीक्षण करें कि अनधिकृत प्रेषक या ब्राउज़र सेशन अस्वीकार किया जाता है।
4. पुष्टि करें कि लॉग सीक्रेट्स को रिडैक्ट करते हैं।
5. पुष्टि करें कि DM/समूह रूटिंग केवल इच्छित एजेंट तक पहुंचती है।
6. पुष्टि करें कि उच्च-प्रभाव वाले टूल अनुमोदन मांगते हैं या अस्वीकार किए जाते हैं।
7. स्वीकृत शेष चेतावनियों का दस्तावेजीकरण करें।

​

रोलबैक योजना

{
  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 },
  },
}

1. सार्वजनिक फ़ॉरवर्डिंग, Tailscale Funnel, या रिवर्स प्रॉक्सी रूट रोकें।
2. Gateway टोकन/पासवर्ड और प्रभावित इंटीग्रेशन क्रेडेंशियल रोटेट करें।
3. अलाउलिस्ट से "*" और अनपेक्षित प्रेषकों को हटाएं।
4. हाल के ऑडिट लॉग, रन इतिहास, टूल कॉल, और कॉन्फ़िग बदलावों की समीक्षा करें।
5. openclaw security audit --deep दोबारा चलाएं।
6. वर्कफ़्लो को पूरा करने वाले सबसे संकीर्ण पैटर्न के साथ एक्सेस फिर से सक्षम करें।

​

समीक्षा चेकलिस्ट

• जब तक कोई दस्तावेजीकृत कारण न हो, Gateway केवल लूपबैक रहता है।
• गैर-लूपबैक एक्सेस में प्रमाणीकरण, फ़ायरवॉलिंग है, और कोई सार्वजनिक सीधा रूट नहीं है।
• विश्वसनीय-प्रॉक्सी डिप्लॉयमेंट में सख्त प्रॉक्सी IP और हेडर नियंत्रण हैं।
• DM डिफ़ॉल्ट रूप से खुले एक्सेस के बजाय पेयरिंग या अलाउलिस्ट का उपयोग करते हैं।
• समूहों में मेंशन या स्पष्ट अलाउलिस्ट आवश्यक हैं।
• साझा चैनल व्यक्तिगत क्रेडेंशियल तक नहीं पहुंचते।
• गैर-मुख्य सेशन सैंडबॉक्स मोड में चलते हैं।
• होस्ट exec और एलिवेटेड टूल अस्वीकार किए जाते हैं या अनुमोदन-गेटेड हैं।
• लॉग सीक्रेट्स को रिडैक्ट करते हैं।
• गंभीर ऑडिट निष्कर्ष हल किए गए हैं।
• रोलबैक चरणों का परीक्षण और दस्तावेजीकरण किया गया है।