Skip to content

Add security automation failure documentation

Why is this change being made?

This updates the Secure sub-departments security triage documentation, so that it provides a way to check for automation failures. It also adds sections to the Composition Analysis that links to the manual processes outlined in the Secure page. The changes are being made after we discovered that the automation was not working as intended, and that the handbook made no mention on how we should verify this.

Screenshots

This shows the differences between the previous formatting and the one included in this MR.

Before

CA page before changes

After

CA handbook page with changes

Author and Reviewer Checklist

Please verify the check list and ensure to tick them off before the MR is merged.

  • Provided a concise title for this Merge Request (MR)
  • Added a description to this MR explaining the reasons for the proposed change, per say why, not just what
    • Copy/paste the Slack conversation to document it for later, or upload screenshots. Verify that no confidential data is added, and the content is SAFE
  • Assign reviewers for this MR to the correct Directly Responsible Individual/s (DRI)
    • If the DRI for the page/s being updated isn’t immediately clear, then assign it to one of the people listed in the Maintained by section on the page being edited
    • If your manager does not have merge rights, please ask someone to merge it AFTER it has been approved by your manager in #mr-buddies
    • The when to get approval handbook section explains the workflow in more detail
  • For transparency, share this MR with the audience that will be impacted.
    • Team: For changes that affect your direct team, share in your group Slack channel
    • Department: If the update affects your department, share the MR in your department Slack channel
    • Division: If the update affects your division, share the MR in your division Slack channel
    • Company: If the update affects all (or the majority of) GitLab team members, post an update in #whats-happening-at-gitlab linking to this MR

Commits

  • Add security automation failure documentation

  • Document process on checking for security automation failures.

  • Fix various markdown formatting errors caused by inconsistent indentation.

  • Add links to queries for Composition Analysis issues that are nearing SLA breach.


Edited by Oscar Tovar

Merge request reports