Przejdź do treści

Przewodniki

Rejestr zagrożeń

Zagrożenie to coś, co może pójść źle w twoim systemie, zapisane razem z właścicielem i tym, co je mierzy. Rejestr leży obok polityki wydań, w hazards.yaml, więc przechodzi przegląd w pull requestach jak reszta projektu, a każdy przebieg zapisuje wersję, według której był czytany.

Pisanie rejestru

version: 1
hazards:
  - id: rag-leak
    title: A poisoned document makes the assistant disclose a customer's data
    systems: [support-bot]
    triggers: [a retrieved document carries an instruction]
    exposed: customers whose tickets the assistant reads
    severity: {level: 5, narrative: customer data leaves the company}
    occurrence: {level: 2}
    detectability: {level: 3}
    controls: [retrieved text is quoted, never obeyed]
    residual: Low while the leak ceiling holds; reviewed after every model change.
    owner: [email protected]
    review_by: 2026-12-01
    state: open
    measured_by: [no-leak]
    tested_by: [safety]

Każde zagrożenie wymienia w measured_by reguły, które je mierzą. Muszą to być sufity z release.yaml: reguła max: albo reguła max_failures: (Sufity ryzyka). Podłoga mierzy, jak często coś się udaje, więc zagrożenie mierzone podłogą zostaje odrzucone. systems i tested_by zawężają systemy i zestawy, z których czytane są dowody; bez nich liczą się wszystkie.

Dotkliwość, występowanie i wykrywalność to porządkowe oceny analizy przyczyn i skutków wad, od 1 do 5, nadane przez ludzi. Oloproof pokazuje je tak, jak je nadano, i nigdy ich nie łączy: nie ma liczby priorytetu ryzyka ani wyniku ryzyka resztkowego, bo iloczyn ocen porządkowych to precyzja, której nikt nie zmierzył. Ryzyko resztkowe to zdanie właściciela. state zagrożenia (open, mitigated, accepted lub closed) należy do zespołu i nigdy nie jest decyzją.

Sprawdzanie

oloproof hazards check

Sprawdzenie odrzuca rejestr, którego zagrożenia wymieniają regułę nieobecną w polityce albo podłogę, i kończy się kodem 2. W przeciwnym razie wypisuje każde zagrożenie z ocenami, właścicielem i stanem, zgłasza zaległy przegląd i czyta każdą regułę pomiarową przy ostatnim przebiegu każdego systemu na każdym zestawie, tak jak zdecydował silnik. Zagrożenie bez reguły pomiarowej jest oznaczone jako niezmierzone, a reguła, której żaden ostatni przebieg nie rozstrzygnął, jest wymieniona. --json zapisuje ten sam raport dla potoku.

Gdzie się pojawia

oloproof run zapisuje rejestr razem z przebiegiem, oloproof push przenosi go do twojej przestrzeni roboczej, a oloproof export zapisuje go obok pakietów, które czyta lokalny workbench. Strona Safety and risk pokazuje każde zagrożenie nad sufitami, z ocenami, środkami kontroli i stanem mierzących je sufitów, każdy z odnośnikiem do dowodów. Gdy rejestr się zmienił, a potem wrócił do poprzedniej postaci, bieżący jest rejestr zapisany przez najnowszy przebieg, a nie ten zapisany jako ostatni. Rekord decyzji wymienia rejestr zapisany przez jego przebieg; record verify przedstawia go jako słowo zespołu.

Co dalej

  • Sufity ryzyka opisuje reguły, którymi mierzy się zagrożenie.
  • Gating opisuje, jak sufit blokuje wydanie.