Внешний ИИ-шлюз экосистемы

Безопасный Python-шлюз, который предоставляет инструменты с ограниченными правами доступа MCP-совместимым клиентам-ассистентам, обеспечивая посреднический доступ к внешним системам, таким как Slack. Он демонстрирует изоляцию тенантов, делегированную авторизацию, подтверждение человеком для чувствительных операций записи, идемпотентное выполнение, проверку подписанных вебхуков, хранилище грантов с поддержкой отзыва и цепочку аудита на основе хеширования.

Это эталонная реализация для портфолио, а не production-провайдер идентификации. Разработческий адаптер аутентификации на основе заголовков должен быть заменён на middleware проверки OIDC, описанный в docs/security.md, перед развёртыванием.

Архитектура

Assistant / Slack client
          |
          v
  FastAPI edge + auth adapter
          |
          v
 Policy + tenant boundary ----> confirmation tokens
          |
          v
 Sandboxed tool registry -----> Slack / OpenAI / Claude adapters
          |
          +--------------------> idempotency store
          +--------------------> append-only hash-chained audit log

Related MCP server: MCP Tool Manager

Быстрый старт

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn ecosystem_gateway.app:app --reload

Список инструментов:

curl localhost:8000/mcp/tools \
  -H 'X-Subject: user-1' -H 'X-Tenant-Id: tenant-a' -H 'X-Roles: operator'

Запустите набор тестов с помощью pytest. Если токен Slack не настроен, коннекторы работают в безопасном песочном режиме и возвращают запрос, который они бы отправили.

Свойства безопасности

• Каждый субъект доступа и ключ идемпотентности изолированы в рамках тенанта.

• Политики инструментов сочетают принцип минимальных привилегий с делегированными областями доступа.

• Чувствительные операции записи требуют кратковременный токен, привязанный к субъекту, тенанту, инструменту и аргументам.

• Подписи вебхуков проверяются с использованием сравнения за постоянное время и отклоняют устаревшие запросы.

• Записи аудита образуют цепочку SHA-256, что делает удаление или изменение обнаружимым.

• Гранты OAuth поддерживают отзыв и никогда не раскрывают refresh-токены через результаты инструментов.

См. docs/security.md для производственного чек-листа по усилению безопасности и модели угроз.

Лицензия

MIT