Przejdź do treści

Powstrzymaj agentów AI przed wdrożeniem bez zgody

DueReason Gate w dwóch warstwach: polityka blokująca powłokę, zapis i wywołania MCP agenta oraz test po stronie docelowej na wypadek obejścia bramy.

Aktualizacja · 7 min czytania

W skrócie

  • Brama wewnątrz narzędzia agenta (Claude Code, Hermes, hook gita) blokuje pasujące polecenie powłoki, zapis pliku lub wywołanie MCP, dopóki złożony wniosek nie zostanie w pełni zatwierdzony, po czym zwraca podpisany grant.
  • Sama taka brama zatrzymuje tylko agenta: każdy z dostępem do powłoki na tej samej maszynie może ją ominąć. Drugą, wymaganą warstwą jest test po stronie docelowej -- wymagany status check na GitHubie albo duereason-gate verify -- który sam odmawia.
  • Ustawienia > Brama agentów generuje od razu trzy elementy: akcję i ścieżkę akceptacji, klucz API o minimalnym zakresie oraz politykę .duereason/gate.yml wraz z fragmentami instalacyjnymi dla używanego narzędzia.
  • Claude Code, Cursor, Hermes, OpenCode, Codex, Gemini CLI, Windsurf, ogólny hook git pre-push oraz samodzielne proxy MCP mają już dziś prawdziwy adapter duereason-gate w kodzie, a pakiet @duereason/gate jest opublikowany w npm, więc każdy z nich jest dziś instalowalny przez klienta.

Agent, który potrafi uruchamiać polecenia powłoki, zapisywać pliki lub wywoływać narzędzia MCP, może też uruchomić git tag v2.0.0 && git push --tags, terraform apply albo narzędzie zwrotu Stripe w chwili, gdy uzna to za kolejny krok. DueReason Gate stawia politykę przed dokładnie takimi wywołaniami, ograniczoną do tych, które sam wskażesz, więc agent najpierw pyta, zamiast najpierw działać. Ten przewodnik dotyczy wdrożeń; zatwierdzanie działań agentów AI opisuje ten sam dwuwarstwowy wzorzec dla płatności, usuwania danych i innych działań wyzwalanych przez agenta.

Dwie warstwy, obie wymagane

  1. Brama wewnątrz narzędzia. @duereason/gate odczytuje jedno znormalizowane zdarzenie na wywołanie narzędzia (polecenie powłoki, zapis/edycja pliku albo wywołanie MCP) z cienkiego adaptera właściwego dla danego narzędzia, dopasowuje je do polityki i albo przepuszcza niedopasowane wywołanie, albo blokuje je na czas złożenia i rozpatrzenia wniosku, albo wprost odmawia. To zabezpieczenie przed *agentem*: działa tylko tam, gdzie samo narzędzie zdecyduje się je wywołać.
  2. Weryfikacja po stronie docelowej. Każdy z dostępem do powłoki na maszynie, na której działa agent, może zakomentować hook, zmienić .duereason/gate.yml albo uruchomić skrypt wdrożeniowy bezpośrednio. System, który naprawdę wykonuje chronioną akcję, musi sam odmówić, gdy nic nie zatwierdziło dokładnie tego payloadu: wymagany status check na GitHubie, krok na początku joba wdrożeniowego albo duereason-gate verify dla CI innego niż GitHub Actions. Dokładne miejsca opisuje przewodnik o ochronie wdrożeń produkcyjnych. Wymagani recenzenci GitHub Environments rozwiązują pokrewny, ale inny problem; zob. porównanie z bramką akceptacji, gdzie każde z nich się kończy.

Sprzedawaj i dokumentuj obie warstwy. Sama pierwsza to wygoda, nie bezpieczeństwo.

Co działa w bramie już dziś

CLI pakietu @duereason/gate (duereason-gate) odczytuje plik polityki (.duereason/gate.yml, łączony z ~/.config/duereason/gate.yml) z regułami dopasowującymi polecenie, ścieżki plików albo serwer/narzędzie MCP wywołania do wyrażenia regularnego lub glob, i na tej podstawie renderuje wniosek DueReason -- tytuł, uzasadnienie i payload szablonowane z dopasowania, kontekstu gita i jawnej listy dozwolonych zmiennych środowiskowych. npm install -g @duereason/gate instaluje go, ten sam command widoczny w Ustawieniach > Brama agentów przy każdym narzędziu. duereason-gate install wpina prawdziwy adapter w mechanizm hooków samego narzędzia dla Claude Code, Cursor, Hermesa, OpenCode, Codex, Gemini CLI, Windsurf i git-hooks (hook pre-push dla wszystkiego, co potrafi tylko uruchamiać polecenia); duereason-gate mcp-proxy owija dowolny inny serwer MCP, tak by jego żądania tools/call były rozstrzygane w ten sam sposób. Narzędzie bez żadnego adaptera nadal owija polecenie, które chciało uruchomić, w duereason-gate exec: brama je rozstrzyga, uruchamia tylko gdy dozwolone i zgłasza prawdziwy kod wyjścia jako wynik wykonania.

Konfiguracja z konsoli

Ustawienia > Brama agentów (właściciel/administrator) zamienia ręczną wersję tego procesu w jedną stronę: wybierz Wdrożenia produkcyjne, Płatności, Usuwanie danych albo Niestandardowe, żeby wskazać akcję, którą już utworzono. Wybór szablonu tworzy jego akcję (ze schematem payloadu dopasowanym do polityki poniżej -- repozytorium/commit/środowisko/tag dla wdrożeń, kwota/waluta/klient dla płatności, baza danych/hash zapytania dla usunięć) oraz startową ścieżkę akceptacji, obie edytowalne później w tym samym edytorze ścieżek co każda inna. Strona wydaje następnie klucz API ograniczony dokładnie do approval:request, approval:read i action:read -- pokazany raz, jak każdy klucz DueReason -- oraz generuje politykę .duereason/gate.yml i polecenie instalacyjne dla wybranego narzędzia, gotowe do wklejenia.

Polityka wdrożenia produkcyjnego od początku do końca

```yaml rules:

  • match: tool: shell command: "^git tag (v[0-9][^\\s]*)" action: gate.production-deploy title: "Tag {{match.1}} na {{git.repo}}" reason: "Agent na gałęzi {{git.branch}} chce utworzyć tag wydania {{match.1}}." payload: repo: "{{git.repo}}" sha: "{{git.sha}}" environment: production tag: "{{match.1}}" mode: wait timeout: 1800

```

mode: wait blokuje turę agenta na maksymalnie 1800 sekund, podczas gdy wniosek jest rozpatrywany, a następnie zwraca podpisany, jednorazowy grant związany z dokładnie tym payloadem. mode: deny zamiast tego odpowiada od razu linkiem do konsoli -- dla narzędzia (Hermes, większość agentów czatowych), w którym blokowanie żywej tury na pół godziny jest gorsze niż po prostu ponowna próba agenta później. Zdarzenie niedopasowane do żadnej reguły jest dozwolone offline, bez żadnego wywołania sieciowego -- brama kosztuje Cię wniosek tylko dla wywołań, które sam wskazałeś.

Dlaczego test po stronie docelowej wciąż ma znaczenie

Wniosek zatwierdzony przez taką politykę tworzy grant: podpisany token związany z payloadem, który system wykonujący może sprawdzić offline wobec opublikowanych kluczy DueReason. duereason-gate verify --action gate.production-deploy --payload '{"repo":"acme/shop","sha":"abc123","environment":"production"}' uruchamia dokładnie ten sam test wyszukania i weryfikacji offline co wymagany status check na GitHubie, mimo że sam nigdy nie złożył wniosku, i kończy się niezerowym kodem z przyczyną, gdy nic nie zatwierdziło dokładnie tego payloadu. Umieść go jako pierwszy krok joba wdrożeniowego, nie tylko jako test pull requestu: reguła ochrony gałęzi zatrzymuje scalenie, nigdy późniejsze ręczne ponowne uruchomienie ani powrót do starszego commita.

Pytania

Czy instalacja adaptera Claude Code lub Hermes poszerza to, co agent może już robić?
Nie. Zgoda z bramy nie generuje żadnego wyjścia dla Claude Code (jego własny system uprawnień nadal działa) i zwraca None dla Hermesa (brak opinii, normalny przepływ narzędzi/zatwierdzeń jest nienaruszony). Brama może tylko dodatkowo zawęzić wywołanie, blokując je lub składając dla niego wniosek, gdy pasuje do polityki.
Co dzieje się z wywołaniem, którego polityka nie wymienia?
Jest dozwolone, offline, bez żadnego wywołania sieciowego. Brama kosztuje Cię wniosek tylko dla wywołań narzędzi faktycznie dopasowanych przez regułę.
Czy brama wewnątrz narzędzia wystarczy sama w sobie?
Nie. Każdy z dostępem do powłoki na tej samej maszynie może ominąć hook albo zmienić plik polityki. Brama zatrzymuje agenta; wymagany status check albo duereason-gate verify po stronie docelowej zatrzymuje samą akcję, niezależnie od tego, co działo się na maszynie agenta.
Co, jeśli moje narzędzie nie ma dedykowanego adaptera?
Owiń polecenie, które chciałeś uruchomić, w duereason-gate exec: brama je rozstrzyga, uruchamia tylko gdy dozwolone i zgłasza prawdziwy kod wyjścia jako wynik wykonania. Claude Code, Cursor, Hermes, OpenCode, Codex, Gemini CLI, Windsurf i git-hooks pokrywają już typowe przypadki, a samodzielne proxy MCP pokrywa dowolny inny serwer MCP.

Skonfiguruj Bramę agentów ze swojej konsoli

Ustawienia > Brama agentów tworzy akcję i ścieżkę akceptacji, wydaje ograniczony klucz API i generuje politykę oraz polecenie instalacyjne dla Twojego narzędzia na jednej stronie.

Przeczytaj dokumentację API

Źródła

Poradnik wyjaśnia przepisy tak, jak je rozumiemy; nie jest poradą prawną. Sprawdź tekst urzędowy i prawo krajowe, które może dodać obowiązki.

Zacznij z DueReason

Załóż bezpłatne konto, wypróbuj na żywo albo porozmawiaj z nami o swoim procesie.

Otrzymuj nowości o produkcie