Dokumentation

Säkerhet via MCP och Chatt

Läs iakttagelser och agera på dem från Chatt eller din egen assistent, enligt portalens regler, och se varför vissa åtgärder alltid kräver en person.

Du kan läsa iakttagelserna under Säkerhet och agera på dem från chattassistenten eller från din egen assistent via CoRoid som MCP-server: Claude Code, Codex, Cursor eller en annan MCP-klient. Verktygen följer samma regler som portalen, så de ger samma svar och avvisar samma saker.

Läsa

Säkerhet har egna behörighetsomfång, så en anslutning som skapats för annat arbete ser inte iakttagelser. Verktygen kräver rollen Granskare och mcp.security.read. Inget av dem kräver godkännande. De följer CoRoid Säkerhets egna regler: du ser de projekt du kan se i portalen. En anslutning som är begränsad till vissa projekt måste ange ett av dem eller en iakttagelse i ett av dem.

VerktygVad det besvarar
get_security_overviewPer projekt: öppna iakttagelser efter allvarlighetsgrad, förfallna åtgärdsdatum, påståenden som ingen har bekräftat, testkod och hur många som väntar på dig
list_security_findingsIakttagelser efter projekt, typ, allvarlighetsgrad och status, först de som har utnyttjats och sedan efter allvarlighetsgrad; needsYou behåller bara dem som väntar på en person
list_security_needsBeslut som väntar på en person, med brådskande ärenden först, vart och ett med CoRoid:s svar och en länk som öppnar beslutet: samma lista som under Säkerhet → Beslut
get_security_findingEn iakttagelse: var den finns, om den har bekräftats, när den förfaller och dess åtgärdsarbete. Aldrig värdet på en hemlighet
get_security_settingsVarje skydd i ett projekt och hur kontrollerna tillämpar det: av, övervakar, upprätthåller eller kan inte köras, och varför, samt vad projektets konfiguration har valt
list_security_runsSäkerhets körningar, nyaste först, som de visas i körningsloggen: körs, väntar, slutförd, misslyckad eller ersatt, och varför en körning misslyckades
get_attack_surfaceVarje projekts ingångspunkter och hur många som väntar på att exponeringen ska bedömas; för ett projekt, varje ingångspunkt med vad koden visar och vad personer har beslutat, förslag på driftsättning och vad pull request-skyddet hittade
get_threat_modelVarje projekts hotmodellversion och vad som väntar på granskning; för ett projekt, modellen, förslaget som väntar och de senaste versionerna
list_security_packagesVarje projekts senaste beroendeinventeringar med antal installerade paket och sårbara paket; för ett projekt, paketen sida för sida, med sårbara först

Varje iakttagelse länkar till sin sida i CoRoid.

Agera på iakttagelser

De här verktygen agerar på iakttagelser. De kräver mcp.security.write och en ägare eller administratör, precis som i portalen.

VerktygVad det görGodkännande
start_security_fixÅtgärda, precis som i portalen: åtgärdsarbete för ett sårbart beroende, en uppgift med ett regressionstest för ett kodfynd eller en checklista för att rotera en läckt autentiseringsuppgift. Ett andra anrop till Åtgärda ger uppgifter om den redan skapade uppgiftenNej
run_security_scanSkanna ett projekt nu: allt som är aktiverat, beroenden, historik över hemligheter, attackyta, granskning (om den är aktiverad) eller sparade bevisNej
confirm_real_secretBekräfta att en läckt autentiseringsuppgift är äkta. Den förblir öppen tills någon intygar att den har roteratsNej
revoke_security_exceptionAvsluta ett undantag: iakttagelsen öppnas igenNej
dismiss_security_findingMarkera en iakttagelse som Inte ett problem, med en motiveringAlltid
add_security_exceptionAcceptera risken med en iakttagelse fram till ett datum, med en motiveringAlltid
attest_secret_rotatedIntyga att en läckt autentiseringsuppgift har roterats eller återkallats, vilket stänger iakttagelsen. CoRoid testar aldrig en autentiseringsuppgift som den hittarAlltid

Agera på attackytan och hotmodellen

De här kräver också mcp.security.write och en ägare eller administratör. När en kontroll i portalen både kan stärka och försvaga finns det två verktyg: det som stärker avvisar ändringar som skulle försvaga, så sådana ändringar måste alltid göras med verktyget som väntar på en person.

VerktygVad det görGodkännande
raise_entry_point_exposureÖka exponeringen för ingångspunkter, fästa dem för granskningen eller ta med dem i omfattningen igenNej
lower_entry_point_exposureMinska exponeringen för ingångspunkter, ta bort en fästning eller utesluta dem från omfattningen med en motiveringAlltid
refresh_threat_modelLäs projektets kod på nytt; det som hittas väntar som ett förslagNej
add_threat_model_entriesLägg till poster i hotmodellenNej
accept_threat_model_proposalGodkänn det som föreslogs vid en ny genomläsning av kodenNej
update_threat_model_entriesÄndra en posts titel eller informationAlltid
remove_threat_model_entriesTa bort poster från hotmodellenAlltid
dismiss_threat_model_proposalAvvisa det som föreslogs vid en ny genomläsning av kodenAlltid
keep_security_proofSpara ett bevis som återskapade en iakttagelse som dess regressionstestNej

Ändra skydd

Ett skydds inställningar, för ett projekt eller organisationens standardinställning, hanteras med samma två verktyg: tighten_security_protection gör ett skydd starkare och avvisar ändringar som försvagar det, medan relax_security_protection gör det svagare eller låter ett projekt åter följa organisationens standardinställning, och väntar alltid på en person. En ändring försvagar skyddet om identifiering eller tillämpning sänks, en allvarlighetströskel höjs, färre åtgärds-PR:er får öppnas, granskningen stängs av eller körs mer sällan, skanningen av hemligheter läser mindre, sandlådans nätverk öppnas eller tillåter fler värdar, eller en ingångspunkt med värdet ”inte angivet” inte längre räknas som internetexponerad. ”Eget skanningskommando” anges under Kvalitetskontroll.

Kontaktpersoner och sårbarhetsrapportering

Ett projekts säkerhetskontaktpersoner har behörighet att hantera sårbarhetsinformation, vid sidan av ägare och administratörer: de ser åtgärderna som CoRoid håller privata för sårbarheter som ännu inte har offentliggjorts, publicerar eller kasserar dem, utarbetar säkerhetsråd från GitHub och registrerar rapporter till underhållarna av ett beroende. Via MCP och Chatt är dessa anrop för ägare och administratörer, och vart och ett väntar på en person: en kontaktperson kan offentliggöra sårbarheter, och ett offentliggörande kan inte tas tillbaka.

VerktygVad det görGodkännande
list_security_contactsEtt projekts säkerhetskontaktpersoner och vem som kan bli kontaktpersonNej
get_security_disclosureEn iakttagelses privata åtgärder (storlek och status, aldrig innehåll), dess säkerhetsråd från GitHub och rapporterna som skickats till underhållarna, för den som har behörighet att hantera sårbarhetsinformationNej
add_security_contactGör en projektmedlem till säkerhetskontaktpersonAlltid
remove_security_contactTa bort en säkerhetskontaktpersonAlltid
publish_private_fixPublicera en vilande åtgärd: iakttagelsen offentliggörs och en uppgift öppnas för dess pull requestAlltid
discard_private_fixKassera en vilande åtgärdAlltid
draft_github_security_advisoryUtarbeta ett säkerhetsråd från GitHub i repot, synligt för dess underhållareAlltid
record_maintainer_reportRegistrera var du rapporterade iakttagelsen till underhållarna av ett beroende. CoRoid skickar ingentingAlltid

Varför vissa åtgärder kräver en person

Att markera som Inte ett problem, acceptera en risk eller rotera en autentiseringsuppgift tar bort en iakttagelse från listan över öppna utan att åtgärda den; en mindre exponerad ingångspunkt och en mindre hotmodell tar bort något från det som granskningen omfattar. En assistent ska inte kunna göra det på egen hand, så de här verktygen väntar alltid på en person, oavsett anslutningens inställningar:

  • Från en MCP-klient väntar anropet på en ägare eller administratör i Inställningar → Anslutningar → CoRoid MCP-server → Godkännanden, och de får en avisering. Förfrågan löper ut efter 10 minuter.
  • I Chatt ber assistenten dig att bekräfta i chatten innan den agerar.

I godkännandet står det med tydliga ord vad som händer, baserat på CoRoids egen dokumentation av fyndet: ”Markera bristande åtkomstkontroll i src/routes/admin.ts:76 (Shop) Inte ett problem”, följt av anledningen inom citattecken. Orden runt anledningen kommer från CoRoid, aldrig från assistenten, och värdet på en inloggningsuppgift visas aldrig: CoRoid sparar det inte.