মূল বিষয়বস্তুতে যান

TenthMatrix WSL Proxy

API গেটওয়ে, CDN ও এন্টারপ্রাইজ WAF — প্রোডাক্ট সংক্ষিপ্ত বিবরণ

TenthMatrix WSL Proxy (WSLProxy) হলো TenthMatrix-এর সম্পূর্ণ API গেটওয়ে ও CDN এজ কন্ট্রোল প্লেন। এটি আপনার অরিজিনের সামনে থাকে এবং প্রতিটি রিকোয়েস্টে কী হবে তা ঠিক করে — রাউট, সুরক্ষা, ক্যাশ ও পর্যবেক্ষণ — লাইভ JSON ও MCP কনফিগ থেকে, প্রতিটি নিয়ম পরিবর্তনে nginx রিলোড ছাড়াই।

TenthMatrix WSL Proxy কী?

WSLProxy হলো OpenResty-ভিত্তিক একটি ডায়নামিক API গেটওয়ে ও রিভার্স প্রক্সি। অপারেটররা ভার্চুয়াল হোস্ট, রাউটিং নিয়ম, WAF নীতি, ক্যাশ, ট্রাফিক স্প্লিট ও এজ POP পরিচালনা করেন Admin UI, REST API, MCP টুল বা wslproxy-cli দিয়ে। দৈনন্দিন নিয়ম হট পাথে কার্যকর হয়; শুধু সার্ভার-স্তরের listen বা SSL ব্লক বদলালে nginx রিলোড হয়।

Watch the overview

প্রক্সি কীভাবে কাজ করে

একটি সলিউশন প্লেবুকের মতো: একবার মেলান, প্রতিটি রিকোয়েস্টে সিদ্ধান্ত নিন, তারপর প্রক্সি বা সুরক্ষা দিন। সাধারণ নিয়ম পরিবর্তনে কন্ট্রোল প্লেনকে কখনো এজ রিস্টার্ট করতে হয় না।

  1. ১. রিকোয়েস্ট POP-এ পৌঁছায়

    ব্রাউজার, API ও এজেন্ট TenthMatrix WSL Proxy এজে (Docker, বেয়ার-মেটাল Ansible POP, বা k3s Helm ingress) পৌঁছায়। OpenResty TLS গ্রহণ করে এবং Lua হট পাথে প্রবেশ করে।

  2. ২. রাউটিং নিয়ম মেলান

    gateway_ack.lua ভার্চুয়াল হোস্ট লোড করে এবং ডিস্ক বা Redis থেকে লাইভ নিয়ম মূল্যায়ন করে: path, IP, দেশ, JWT, S3, cookie এবং আরও। অগ্রাধিকার ও নির্দিষ্টতা বিজয়ী নির্বাচন করে — কোনো nginx রিলোড নয়।

  3. ৩. পাইপলাইন: রেট লিমিট → WAF → রেসপন্ড

    গেটওয়ে পাইপলাইন প্রথমে রেট লিমিট চালায়, তারপর WAF ইঞ্জিন (ধাপ + সিগনেচার), তারপর gateway_resp.lua রেসপন্স অ্যাকশন ও ব্যালান্সার টাইমআউট প্রয়োগ করে।

  4. ৪. ফলাফল নির্ধারণ করুন

    সাধারণ ফলাফল: upstream-এ 305 রিভার্স-প্রক্সি, 301/302 রিডাইরেক্ট, স্ট্যাটিক HTML ব্লক, CAPTCHA চ্যালেঞ্জ, বা সাপোর্ট ID হেডারসহ 403 WAF ব্লক।

  5. ৫. ব্যালান্স ও পর্যবেক্ষণ

    প্রক্সি রেসপন্সের জন্য balancer_by_lua weighted, RR, canary, sticky বা least-conn প্রয়োগ করে। হেলথ, মেট্রিক্স ও ট্রাফিক পরিসংখ্যান অপস ও AI লগ হুকে যায়।

  6. ৬. অপারেটর ও এজেন্ট কনফিগ চালায়

    মানুষ Admin UI / CLI ব্যবহার করে; এজেন্ট সার্ভার, নিয়ম ও WAF বাইন্ড CRUD করতে REST বা MCP টুল ব্যবহার করে — একই সারফেস, GitOps-বান্ধব pull/push।

Codeঅর্থ
305upstream-এ রিভার্স প্রক্সি (প্রাথমিক গেটওয়ে পাথ)
301 / 302রিডাইরেক্ট
200 HTMLস্ট্যাটিক / ব্র্যান্ডেড ব্লক বা ইন্টারস্টিশিয়াল
CAPTCHAচালিয়ে যাওয়ার আগে চ্যালেঞ্জ
403 WAFX-WAF-* ও X-Support-ID হেডারসহ WAF দ্বারা ব্লক

প্রধান প্রোডাক্ট বৈশিষ্ট্য বিস্তারিত

নিয়ন্ত্রিত এজের জন্য যা দরকার সবকিছু: রাউটিং, নিরাপত্তা, CDN ক্যাশ, মাল্টি-POP ডেলিভারি, এবং এমন কন্ট্রোল প্লেন যা মানুষ ও এজেন্ট উভয়েই চালাতে পারে।

  • ডায়নামিক রাউটিং নিয়ম

    path, IP, দেশ, JWT claims, S3-ধাঁচের keys ও cookies-এ মেলান। অ্যাকশনের মধ্যে রিভার্স প্রক্সি, রিডাইরেক্ট, HTML রেসপন্স ও CAPTCHA আছে। নিয়মগুলো অগ্রাধিকার অনুযায়ী সাজানো এবং সমতায় নির্দিষ্টতা সিদ্ধান্ত নেয়, যাতে nginx রিস্টার্ট ছাড়াই সবচেয়ে নির্ভুল রাউট জেতে।

  • ট্রাফিক ইঞ্জিনিয়ারিং

    Weighted, round-robin, হেডার-ভিত্তিক canary, cookie sticky সেশন ও least-conn ব্যালান্সিং। canary সুস্থ দেখালে কন্ট্রোল প্লেন থেকে ব্যাকএন্ড প্রমোট বা রোলব্যাক করুন — অথবা এক অ্যাকশনেই ফিরিয়ে আনুন।

  • এন্টারপ্রাইজ WAF engine v2

    পলিসি প্যাক প্রতিটি ডোমেইন, সেবা ও রাউটে বাইন্ড হয়। ধাপগুলোর মধ্যে মেথড allow-list, filetype deny, IP/geo তালিকা, JWT অ্যালগরিদম নীতি, JSON body প্রোফাইল, ব্রুট-ফোর্স ভেলোসিটি ও OpenAPI পজিটিভ সিকিউরিটি — সাথে নিয়ন্ত্রিত অ্যাটাক সিগনেচার ও অ্যানোমালি স্কোরিং। ব্লকিং বা ট্রান্সপারেন্ট (মনিটর) মোড।

  • CDN ও এজ ক্যাশ

    এজ স্ট্যাটিক ক্যাশ, ঐচ্ছিক Docker blob ক্যাশ ও Varnish হুক আপনাকে অরিজিনের সামনে CDN-ধাঁচের স্তর দেয় — API গেটওয়ে ট্রাফিকের পাশাপাশি মার্কেটিং সাইট, API ডকুমেন্টেশন ও আর্টিফ্যাক্ট ডেলিভারির জন্য আদর্শ।

  • SSL ও HTTPS

    auto-ssl / Let’s Encrypt, প্রতি-ডোমেইন SSL JSON ও force-HTTPS নীতি, যাতে প্রতিটি ভার্চুয়াল হোস্ট POP-এ সঠিকভাবে TLS টার্মিনেট করতে পারে।

  • মাল্টি-POP + DNS

    এজ লোকেশন ঘোষণা করুন এবং নিরাপত্তা গার্ডরেলসহ Cloudflare A-records প্রভিশন করুন। একটি সাধারণ প্রোডাকশন প্যাটার্ন হলো public POP → k3s NodePort → wslproxy-ingress Helm → app pods।

  • কন্ট্রোল প্লেন

    React Admin ও Next.js ড্যাশবোর্ড, Swagger REST, Claude/Cursor-এর জন্য MCP টুল, এবং pull/push/diff/verify ওয়ার্কফ্লোর জন্য wslproxy-cli ইমেজ (ghcr.io/bwalia/wslproxy-cli)।

  • যেকোনো জায়গায় ডিপ্লয় করুন

    ল্যাবের জন্য Docker Compose, বেয়ার-মেটাল বা VM POP-এর জন্য Ansible, এবং k3s / Kubernetes-এর জন্য Helm ingress-controller চার্ট — সব এনভায়রনমেন্টে একটি প্রোডাক্ট সারফেস।

  • অবজার্ভেবিলিটি

    /health, /healthz, /ready, Prometheus /metrics, traffic stats, structured WAF security logs, and AI log analysis hooks for SRE teams.

WAF নিয়ম ও প্রয়োগ

WAF চলে OpenResty রিকোয়েস্ট পাথে (এন্টারপ্রাইজ NGINX WAF প্যাটার্ন দ্বারা অনুপ্রাণিত)। এটি ডিফল্টভাবে fail-open যাতে WAF বাগ সাইট ডাউন করতে না পারে, প্রতিটি ব্লকে ব্যাখ্যাযোগ্য, এবং সাধারণ v1 নিয়ম তালিকার সাথে ব্যাকওয়ার্ড কম্প্যাটিবল। গাইডেড ট্যুর ও বিস্তারিত জানতে নিচের সম্পর্কিত লেখা দেখুন — অথবা এই পৃষ্ঠার WAF ভিডিও দেখুন।

রিকোয়েস্ট-পাথ পাইপলাইন

  1. rewrite_by_lua: gateway_ack.lua রাউটিং নিয়ম নির্বাচন করে
  2. gateway_pipeline.execute(): rate-limit → WAF → continue
  3. waf_engine.inspect(): পলিসি লোড, বাইন্ডিং নির্ধারণ, ধাপ চালানো, তারপর সিগনেচার
  4. ব্লক হলে: 403 + X-WAF-Block, X-WAF-Rule, X-WAF-Violation, X-Support-ID

ধাপ পাইপলাইন (সিগনেচারের আগে)

Codeধাপবিবরণ
VIOL_METHODমেথড allow-listশুধু অনুমোদিত HTTP মেথড (যেমন GET, POST, HEAD, OPTIONS)।
VIOL_FILETYPEFiletype deny.env, .sql, .bak, .git, .pem-এর মতো সংবেদনশীল এক্সটেনশন ব্লক করুন।
VIOL_IP_DENY / VIOL_GEOIP তালিকা ও geoCIDR allow/deny করুন এবং IP2Location-ধাঁচের DB দিয়ে দেশ deny করুন।
VIOL_JWT_ALGJWT অ্যালগরিদম নীতিদুর্বল algs (none, HS256) deny করুন; প্রয়োজনে RS256/ES256 বাধ্যতামূলক করুন।
VIOL_JSON_SIZE / DEPTHJSON body প্রোফাইলপার্সার অপব্যবহার রোধে JSON গভীরতা ও body আকার সীমিত করুন।
VIOL_BRUTE_FORCEব্রুট-ফোর্স ভেলোসিটিIP-ভিত্তিক প্রতি-পাথ স্লাইডিং উইন্ডো (যেমন /api/login)।
VIOL_OPENAPI_*OpenAPI পজিটিভ সিকিউরিটিশুধু ঘোষিত path+method সারফেস (টেমপ্লেটেড পাথ) অনুমোদন করুন।

সিগনেচার নিয়ম ও গভর্নেন্স

প্রতিটি সিগনেচারের একটি স্থির ID (অ্যাড্রেসযোগ্য একক), বিভাগ/সেট, তীব্রতা, ম্যাচ লক্ষ্য (url, args, body, headers, cookies, UA, বা all), regex বা string প্যাটার্ন, অ্যাকশন (block বা monitor) এবং অ্যানোমালি স্কোর থাকে।

  • disable

    signatures.disable একটি নিয়ম সম্পূর্ণ এড়িয়ে যায়।

  • stage

    signatures.stage একটি টাইমস্ট্যাম্প পর্যন্ত শুধু অ্যালার্ম দেয় — নিরাপদ রোলআউট যা staged থাকাকালীন কখনো অ্যানোমালি স্কোরে যোগ হয় না।

  • সিগনেচার সেট

    প্রতিটি নিয়ম পুনরায় না লিখেই পুরো সেট (যেমন SET_SQLI) block ও alarm-এর মধ্যে টগল করুন।

  • অ্যানোমালি থ্রেশহোল্ড

    সঞ্চিত স্কোর ≥ থ্রেশহোল্ড হলে VIOL_ANOMALY_SCORE ওঠে, এমনকি কোনো একক সিগনেচার একা ব্লক না করলেও।

বাইন্ডিং অগ্রাধিকার

সবচেয়ে নির্দিষ্টটি জেতে: route override → প্রতি-সার্ভার waf_mode_override → পলিসি ডিফল্ট enforcementMode (blocking বা transparent/monitor)। প্রতিটি ফাইন্ডিং রেকর্ড করে কোন বাইন্ডিং জিতেছে, যাতে লগ উত্তর দিতে পারে “এটি কেন ব্লক হলো?”

  • ব্লকিং

    লঙ্ঘন সাপোর্ট ID ও ঐচ্ছিক ব্র্যান্ডেড ব্লক পেজসহ 403 ফেরত দেয়।

  • ট্রান্সপারেন্ট / মনিটর

    লঙ্ঘন শুধু অ্যালার্ম ও লগ করে — ড্রাই-রান ও স্টেজিংয়ের জন্য আদর্শ।

Agents Gateway ও MCP Gateway

TenthMatrix, WSL Proxy-কে এজেন্ট যুগে প্রসারিত করছে। HTTP API-এর সামনে থাকা একই এজ নিয়ন্ত্রণ করবে এজেন্ট ও Model Context Protocol (MCP) ক্লায়েন্ট কীভাবে টুল ও ব্যাকএন্ডে পৌঁছায়।

  • In progress

    MCP Gateway (চলমান)

    বাহ্যিক MCP সার্ভারের সামনে একটি নিয়ন্ত্রিত প্রবেশদ্বার — auth ব্রিজিং, tool/method allow-deny তালিকা, tools/call-এর অডিট, এবং প্রতি-টুল রেট লিমিট। ক্লায়েন্ট কখনো upstream টোকেন রাখে না।

  • In progress

    Agents Gateway (চলমান)

    মাল্টি-এজেন্ট ট্রাফিকের জন্য নীতি, রাউটিং ও অবজার্ভেবিলিটি — যাতে এজেন্ট ফ্লিট আপনার API ও CDN ওয়ার্কলোডের মতো একই TenthMatrix WSL Proxy এজ দিয়ে অরিজিনে পৌঁছায়।

  • Available

    MCP ব্যবস্থাপনা সারফেস (উপলব্ধ)

    WSLProxy ইতিমধ্যে তার Admin সারফেস Claude, Cursor ও অন্যান্য এজেন্টের জন্য MCP টুল হিসেবে উন্মুক্ত করে — IDE না ছেড়েই নিয়ম কনফিগার করুন ও এজ পরীক্ষা করুন।

সলিউশন আর্কিটেকচার

ক্লায়েন্ট ও এজেন্ট TenthMatrix WSL Proxy POP-এ পৌঁছায়। এজ লাইভ নিয়ম মেলায়, WAF ও ক্যাশ প্রয়োগ করে, তারপর অরিজিনে ব্যালান্স করে। অপারেটররা সবকিছু Admin UI, REST, MCP বা CLI দিয়ে চালান।

  1. এজ POP

    OpenResty + Lua হট পাথ: নিয়ম মেলান, রেসপন্ড করুন, ব্যাকএন্ড ব্যালান্স করুন।

  2. লাইভ কনফিগ

    ডিস্ক বা Redis থেকে নিয়ম, WAF ও ট্রাফিক স্প্লিট — দৈনন্দিন পরিবর্তনে কোনো nginx রিলোড নয়।

  3. কন্ট্রোল প্লেন

    মানুষ ও এজেন্টের জন্য Admin UI, REST, MCP ও wslproxy-cli।

  4. অরিজিন

    API, k3s সেবা, স্ট্যাটিক সাইট, এবং ভবিষ্যতের MCP / এজেন্ট upstream।

প্রোডাক্ট সাইটে চালিয়ে যান

ডেমো, ডকুমেন্টেশন ও সর্বশেষ TenthMatrix WSL Proxy রিলিজের জন্য wslproxy.org দেখুন।

wslproxy.org

TenthMatrix WSL Proxy নিন

wslproxy.org-এ প্রোডাক্টটি দেখুন, TenthMatrix-এ WAF-এর বিস্তারিত বিশ্লেষণ পড়ুন, অথবা এজ, CDN, WAF ও এজেন্ট গেটওয়ে ডিপ্লয়মেন্ট নিয়ে আমাদের সাথে কথা বলুন।