Automate with playbooks
The playbooks enable you to customize and automate GitGuardian behavior. They are accessible in your workspace settings.
If you need other playbooks, do not hesitate to submit your request here.
#
Auto-healing playbookThe auto-healing playbook automates the process of sharing the incident with the developer involved.
Whenever a new incident is detected, GitGuardian automatically turns on the sharing option of the incident and sends an email with the unique link to the developer involved, unless the developer is already a member of the workspace.
You can then choose which options would be automatically applied to the share link:
- the ability to submit feedback on the incident through the provided link with the
Feedback collection option
- the ability to resolve or ignore the incident directly via the provided link with the
Auto-healing option
The email sent automatically by GitGuardian is not customizable yet.
The emails are sent only to addresses considered as well formed and not matched by one of the exclude patterns aiming at detecting bots.
The auto-healing playbook is created by default by GitGuardian and is only accessible for workspaces under Business plan or in business trial. Only Owner and Managers of the workspace can activate or deactivate the playbook.
#
Auto-access granting playbookThe auto-access granting playbook automates the process of giving access to an incident's details in the GitGuardian dashboard, for members with Restricted and Member roles.
Not only does this apply for real-time detection whenever a new incident is raised, it also applies to all historical incidents the developer was involved in. GitGuardian will automatically give the involved user access to the incident details page in the dashboard, this is done by matching the commit author email against the dashboard user email. Here is a description of the flow:
GitGuardian does not send sign-up invitations to the commit authors, they need to be already Restricted members of the workspace.
#
Auto-resolution playbookThe auto-resolution playbook automatically closes incidents that have once been valid and that become invalid. This is in order to facilitate the remediation process.
Not only does this apply for real-time detection whenever an incident is re-checked as invalid, but it also applies to all historical incidents that are concerned.
Upon activation of the playbook, the user will be prompted with a message warning that N
historical incidents will be resolved when activating the playbook.
Eventually, note that incidents that are automatically closed by this playbook will display an audit log attributed to "GitGuardian Bot" for the corresponding action.