# Managing Engagements

Engagements are shown on the **Engagements** tab of the Runbooks module. This view displays the engagement title, associated test plan, related client, the date the engagement was last updated, and the progress of the engagement. In the "Actions" column, engagements can be viewed, edited, or deleted.

## **Engagement Status**

Engagements are identified as submitted, not submitted, or in progress.&#x20;

Progress is based on the completion of contained procedures, and progress is displayed in two locations:

* &#x20;On the **Engagements** tab as a progress bar:

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FEWyM4yt6FDvHBR3HAPCt%2Fimage.png?alt=media&#x26;token=a58ea0e0-980c-44b3-a05e-57d78b0d3448" alt="" width="563"><figcaption></figcaption></figure></div>

* Within the top toolbar of the engagement's home page:

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FjF3DlKGYe6CQj5ngENvM%2Fimage.png?alt=media&#x26;token=371aa1db-2acd-465c-bfe5-ded9f42f4d95" alt="" width="563"><figcaption></figcaption></figure></div>

Engagements completed but not submitted will display "Not Submitted" under the 100% progress bar.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FRvYJ6TbtZiW7cPS1L7Be%2Fimage.png?alt=media&#x26;token=1ca3e6e6-e3af-49c8-b9a7-a83f7575265a" alt=""><figcaption></figcaption></figure></div>

Engagements submitted become reports and are identified with a green checkmark and label. They will remain listed in Runbooks until deleted.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F0CuNM2r3ZxGR7xokA30C%2Fimage.png?alt=media&#x26;token=48c45e85-f751-4018-8b49-68732acb8567" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Only engagements that are in progress can be edited. Once an engagement is submitted and becomes a report, it cannot be edited.
{% endhint %}

## Updating Engagement Procedures

<mark style="background-color:yellow;">Step 1:</mark> Click **View** under an in-progress engagement's "Actions" column.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FUdrcmqlU9JklIKNEnscT%2Fimage.png?alt=media&#x26;token=5be31cbd-cc02-4400-848f-df7b34864abc" alt="" width="563"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> The engagement overview page provides information about the engagement and procedures. Click **View** under the "Actions" column of the procedure to update.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FbELoqCVwXkLQEGhbAjFI%2Fimage.png?alt=media&#x26;token=013bb648-08b9-46f5-a7fd-bb5e6b178f27" alt="" width="563"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Update the procedure status or finding severity by selecting the desired values from the pulldown menus.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FW2WZlHh8tS1Fn5XrpgtK%2Fimage.png?alt=media&#x26;token=89509388-9bad-4e49-b38a-aba885d81ae9" alt="" width="563"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> Add operators by clicking **Managing operators**. Assign an operator(s) for the red and blue teams. Click **Save**.&#x20;

When the runbook is submitted, these names appear on the test plan and become a report.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FdR9BHPZ73be50igTTzGK%2Fimage.png?alt=media&#x26;token=4f2b6750-819f-4792-a151-95b96b793f21" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
All engagement sections are in containers that can be collapsed or expanded for usability. \
\
![](https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FWQ6pW9hU7ZNfJJFb0pyu%2Fimage.png?alt=media\&token=2c730df0-6590-4a3e-b46b-e308ae6ae5ea)
{% endhint %}

<mark style="background-color:yellow;">Step 5:</mark> Run the procedure's execution steps. When completed, identify the outcomes for the blue and red teams from the provided options and enter an attack source in the provided box.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FgsxzXVs5kfhWfvujju97%2Fimage.png?alt=media&#x26;token=1d0796ff-5cd5-4cfa-8853-ae49c476e722" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 6:</mark> Add assets, procedure logs, attachments, and notes as needed to provide additional support and context.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FUuZDBoMaK9NHOtLbSrWr%2Fimage.png?alt=media&#x26;token=7b952c16-b5e1-4561-aedb-72390ce2d41a" alt="" width="563"><figcaption></figcaption></figure></div>

&#x20;<mark style="background-color:yellow;">Step 7:</mark> Scroll to the top of the page and click **Save**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FonyWhQXMkzDFGXsG9lyY%2Fimage.png?alt=media&#x26;token=7487bf10-cc2b-46da-bdc7-6fba113aa4c0" alt="" width="412"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 8:</mark> Click the page navigation aid at the top to continue the engagement.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FfagJO92pZYuUwIvyNFmv%2Fimage.png?alt=media&#x26;token=608481b3-b32f-40e4-9ece-ffc63357dddf" alt="" width="330"><figcaption></figcaption></figure></div>

Procedures can be viewed and edited on this page using the navigation icons at the top of the screen.
