tools/call chạy qua engine firewall trước khi nó
đến được server thật. Trang này là bản đồ của bề mặt đó — gateway, verdict
theo từng cuộc gọi, quản lý skill, egress, và credential được mã hóa — với
các liên kết tới hướng dẫn how-to tập trung cho mỗi phần.
Mọi hành động quản lý ở đây được cấu hình từ console (hoặc REST API với
session/access token của bạn) và được kiểm soát bằng vai trò. Chỉ các cuộc
gọi relay
/v1/* và các route gateway của firewall mang theo một key
kiểu sk-orca-....1. Tại sao mcp security cần một gateway
Trỏ mười agent vào năm community MCP server trực tiếp và bạn nhận được điều tệ nhất của mọi thế giới: không có chính sách chung, không có dấu vết audit, credential được sao chép vào mười config agent, và một tool tênshell.exec
chỉ cách một redirect tới endpoint cloud-metadata của bạn. Gateway gom tất
cả thứ đó thành một kết nối được quản lý.
Một kết nối, mọi server
Các agent kết nối tới một endpoint duy nhất. Gateway tổng hợp các tool
của mọi server đã bật, có thể tiếp cận được dưới namespace
<server>.<tool>.Chính sách trên mọi cuộc gọi
Mỗi
tools/call được chính sách firewall của bạn đánh giá trước khi
dispatch.Credential được mã hóa
Secret xác thực server được mã hóa lúc nghỉ, masked khi đọc, và tiêm vào
lúc dispatch — chúng không bao giờ đến được mô hình hoặc client.
Egress được kiểm soát
Endpoint của một server đã đăng ký được xác thực đối với các dải IP riêng
và cloud-metadata theo mặc định. Với các đích theo từng tool, hãy áp dụng
danh sách deny egress SSRF baseline hoặc tự soạn các quy tắc host/CIDR
của riêng bạn.
2. Bốn khối xây dựng
Quản lý MCP trên OrcaRouter gồm bốn mảnh phối hợp. Chọn mảnh khớp với câu hỏi bạn đang cố trả lời.MCP gateway
MCP gateway
Một endpoint duy nhất mà các agent của bạn kết nối tới thay vì dial trực
tiếp các server. Nó tổng hợp các tool của mọi server đã đăng ký, được
đặt namespace
<server>.<tool>, và phơi bày lại input schema của mỗi
tool nguyên văn. Bắt đầu tại Kết nối một MCP server
và Xác thực; tham chiếu đầy đủ nằm trong
Firewall: MCP servers.Đánh giá theo từng cuộc gọi
Đánh giá theo từng cuộc gọi
Gateway chạy mỗi
tools/call qua firewall trên bề mặt mcp và trả về
một verdict — allow, audit, deny, sanitize, hoặc
pending_approval — trước khi dispatch. Xem
Allow-list các tool MCP và
Sanitize argument của tool.Quản lý skill
Quản lý skill
Các khả năng mà một agent tự cài đặt — skill, BYO MCP server, plugin —
được quét, gán một dải rủi ro, và được cấp một enforcement mode
(
allow / quarantine / block) xếp chồng lên trên mọi verdict quy
tắc. Xem Firewall: skills và
Phòng thủ rug-pull.Credential được mã hóa
Credential được mã hóa
Secret xác thực của mỗi server được mã hóa lúc nghỉ và masked khi đọc.
Xem Xác thực và
Xoay vòng credential.
3. Một tools/call được đánh giá như thế nào
Khi một agent gọi một tool qua gateway, cuộc gọi không đi thẳng tới server. Nó được đối chiếu với chính sách workspace của bạn, enforcement mode của skill sở hữu được áp dụng lên trên, và chỉ một verdictallow / audit /
sanitize mới đến được server thật.
| Verdict | Những gì agent thấy |
|---|---|
allow / audit | Được chuyển tiếp. audit cũng ghi log một sự kiện. |
sanitize | Được chuyển tiếp với các argument đã redact (không bao giờ là kết quả). |
deny / pending_approval | Trả về như một lỗi tool, nên agent có thể thích nghi thay vì crash. |
4. Đăng ký một server (một ví dụ cụ thể)
Bạn đăng ký mỗi server một lần. Một bản ghi server mang theo mộtname
(duy nhất theo workspace, không có .), một endpoint, một auth_mode
(none / bearer / oauth / basic), và các credential được mã hóa của
nó. Hãy làm điều này từ console — thao tác ghi yêu cầu Developer+.
ok / degraded / down):
github.* khi biết chính xác
github.create_issue chấp nhận cái gì. Hướng dẫn từ đầu đến cuối nằm trong
Kết nối một MCP server.
Secret không bao giờ được lưu dưới dạng plaintext.
auth_json được mã
hóa lúc nghỉ và masked khi đọc; trên một update, echo mask trở lại để giữ
giá trị đã lưu. Xem Xoay vòng credential.5. Kết nối một agent với gateway
Khi các server đã được đăng ký, trỏ bất kỳ MCP client nào vào gateway với một key có phạm vi firewall-gateway (một token không có phạm vi đó nhận 403):<server>.<tool>. Một SDK tự proxy các
cuộc gọi có thể đọc registry runtime từ
GET /api/v1/firewall/mcp_servers với cùng gateway token đó.
6. Khóa chặt những gì các tool có thể vươn tới
Các verdict theo từng cuộc gọi quản lý tool nào chạy; các kiểm soát egress quản lý nơi nó có thể vươn tới. Hai lớp phối hợp với nhau. Trước tiên, khi gateway kết nối tới endpoint của một server đã đăng ký, URL đó được xác thực đối với các dải riêng (RFC1918), loopback, link-local, và cloud-metadata theo mặc định — và host được phân giải DNS để một tên phân giải vào một dải bị block cũng bị từ chối. Vậy nên một BYO server trỏ tới169.254.169.254 hoặc một địa chỉ intranet bị từ chối trừ khi bạn đã
whitelist nó một cách tường minh.
Thứ hai, với các đích theo từng tool, một quy tắc egress mang theo một
danh sách allow/deny host/CIDR được đối chiếu với đích đi ra ngoài của cuộc
gọi trên bề mặt egress. Template use-case baseline xuất xưởng một quy
tắc deny egress dựng sẵn mà danh sách của nó đã bao gồm các dải riêng,
loopback, link-local, và cloud-metadata (bao gồm 169.254.169.254 và
metadata.google.internal), nên áp dụng nó cho bạn phòng thủ SSRF/metadata
mà không phải tự tay soạn CIDR.
7. Theo dõi nó: sự kiện, lần chạy, và bất thường
Mọi cuộc gọi được quản lý đều để lại một dấu vết. Sự kiện firewall ghi lại verdict, bề mặt, và quy tắc đã khớp; các lần chạy nhóm các cuộc gọi của một session; và feed bất thường gắn cờ các đột biến tốc độ và chi phí đối với một baseline đã học. Việc đọc cài đặt, chính sách, và các tool đã khám phá mở cho mọi Member; việc đọc event/run/aggregate yêu cầu Developer+.- Audit sự kiện MCP — những gì được ghi log và cách đọc nó.
- Danh sách kiểm tra độ tin cậy — một bước pre-flight trước khi bạn thả một agent lên một server mới.
8. Đi đâu tiếp theo
Kết nối một MCP server
Đăng ký, probe, và phơi bày một server qua gateway.
Allow-list các tool MCP
Default-deny một server và chỉ cho phép các tool bạn đã xem xét.
Phòng thủ rug-pull
Quản lý các server và skill thay đổi sau khi bạn đã phê duyệt chúng.
Firewall: MCP servers
Tham chiếu trường-và-route đầy đủ.
