Blueprint: Building a MSEL
Overview
What is Blueprint?
Blueprint is a web application created to make the development of a Master Scenario Event List (MSEL) and events easier. With this application, it will further simplify the creation and visualization of the MSEL, allowing the user to select/define the simulated entities, attacks, timeframe, and regulators impacted by the scenario, etc. Additionally, it will leverage many advantages over the traditional method of using an excel spreadsheet by facitilating the collaboration between exercise designers belonging to multiple teams.
Additionally, Blueprint can be integrated with Player, Gallery, CITE and Steamfitter. Integrating Blueprint with these applications will automate the configuration process for an exercise.
In summary, Blueprint will allow users to view, edit, create, and approve events on the MSEL.
For installation, refer to these GitHub repositories.
Blueprint Permissions
To use Blueprint, a user must be assigned Content Developer permissions and be added to their respective team.
There are three levels of permissions in Blueprint that affect the way a user interacts with the Blueprint application and collaborates on the MSEL creation.
- System Admin: Can add users to a team, as well as assign the required permissions to users. Additionally, users with this permission can view, edit, create, and approve events on the MSEL.
- Content Developer: Can view, edit, create, and approve events on the MSEL.
- Facilitator: Manages the exercise, can advance moves, execute events, and check events as completed.
Most users will have the Content Developer permission, since that is all that is required to be able to create and collaborate with other teams on the MSEL creation.
Refer to this section Administrator Guide for more information on additional administrative actions.
User Guide
MSEL Catalog
The MSEL Catalog shows created MSELs. Here, users are able to select the desired MSEL to work on, as well as create or delete them.
The following image will show some important hotspots about the MSEL Catalog. Reference the number on the hotspot to know more about this section.
Add Blank MSEL
Hotspot 1:
One of the main features of Blueprint is the ability to be able to create a MSEL from scratch via the application. This feature is helpful for users since it will eliminate the hassle of using Excel spreadsheets and provide a more user-friendly application that will provide an easier visualization of the information.
Upload an Existing MSEL
Hotspot 2:
If creating a new MSEL from scratch is not desired, users can upload a pre-existing MSEL and continue editing it on the application by using this functionality. This is useful to share existing MSEL work without having to add the pieces of information to a blank MSEL one by one.
Filter Display
Types
Hotspot 3:
Users can use this filter to narrow down MSELs presented on the dashboard based on their categorization. Selections available are: All Types, Templates, and Not Templates.
Statuses
Hotspot 4:
Users can use this filter to narrow down MSELs presented on the dashboard based on their current status. Selections available are: All Statuses, Pending, Entered, Approved, and Completed.
Search
Hotspot 5:
This functionality will enable users to search for a specific MSEL, in case it is not presented at the top on the dashboard.
Manage MSEL
Hotspot 6:
Download
If users desire to have an offline copy of any desired MSEL, they will have the ability to download a copy to their devices by using the Download feature. If by any chance users don’t have an internet connection, this feature will be useful since they will be able to work offline on the MSEL and then upload the MSEL back to the application, so that other users can see any changes made. Although users can work on the MSEL offline, it is not recommended since they will be missing on all of the helpful features that Blueprint offers.
Upload
With the Upload feature, users can update the information from the MSEL Card with the new uploaded information. This feature will modify all the existing information with the one found on the .xlsx file.
Note: When engaging in the export and import process of MSELs from the Blueprint application, it is imperative to ensure that events and settings of the MSEL align with your particular preferences. It is worth noting that on occasion, during the import process of MSELs into the application, it may be necessary to reconfigure settings and specific fields.
Delete
With the Delete feature, users will be able to delete existing MSEL Cards. By deleting the MSEL Card, all the information that was included in the MSEL will be deleted too.
Copy
With the Copy feature, users will be able to create a copy of an existing MSEL Card. With this feature, users will be able to modify the copy, instead of the original. This is useful if the user isn't sure of any new changes or to have a foothold of the information that is needed, instead of creating a new MSEL from scratch.
MSEL Cards
Hotspot 7:
Click on the desire MSEL card to access its information. Here, users can also edit or update the existing information. Changes made will be seen live by other users without the need of sharing a new document every time.
Template Feature
Hotspot 8:
Checkbox used to identify and/or assign which MSELs should be a template.
MSEL Definition
After uploading or creating a MSEL, users will be given the ability to edit any desired information, as well as add additional information to the MSEL.
With this functionality, users can now edit the same MSEL, instead of each user having their own copy and then sending their edits to the individual responsible of recompiling all the edits. By allowing users to access the MSEL on-the-fly, this will ensure that everyone will have the same copy of the MSEL on the day of the live scenario.
Basic Information
On this tab, users will be able to edit and configure MSEL settings, as well as enable/disable integrations.
To edit the MSEL's basic information and configuration, follow these next steps:
- Navigate to the Info tab.
- Be sure to be in the Config section.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name of the MSEL | Hurricane Delta MSEL |
Description | String | Details and or characteristics of the MSEL | Hurricane Delta Fort Myers Scenario |
Start Date/Time | Datetime | Start date/time of the MSEL | 09/10/2024 20:00:00 |
End Date/Time | Datetime | End date/time of the MSEL | 10/10/2024 08:00:00 |
Is a Template | Boolean | Designate if this MSEL should be a system template | True |
Integrate Player | Boolean | Add Player integration functionality to the MSEL | True |
Integrate Gallery | Boolean | Add Gallery integration functionality to the MSEL | True |
Integrate CITE | Boolean | Add CITE integration functionality to the MSEL | True |
Select Scoring Model | Dropdown Text | Select a CITE Scoring Model | CISA NCISS |
Integrate Steamfitter | Boolean | Add Steamfitter integration functionality to the MSEL | False |
MSEL Status | Dropdown Text | Select MSEL status designation | Active |
Header Row Metadata (Height) | Integer | An integer value that defines the height of the header row when this MSEL is exported as an xlsx file | 30 |
To save these settings, click on the checkmark at the top.
Integrations:
- Gallery: Blueprint will add the collections, exhibits, cards, articles, teams, and users specified on the MSEL. To know more about this integration reference this section Gallery.
- CITE: Blueprint will add the evaluation, moves, actions, roles, teams, and users specified on the MSEL. To know more about this integration reference this section CITE.
- Player & Steamfitter: Blueprint will automate the adding of events specified on the MSEL, as well as configure exercise details in Player.
Note: Steamfitter integration is currently a work in progress.
Add Page
On this tab, users can add notes to the MSEL to be worked and accessed by other team members with appropriate permissions.
To add MSEL notes, follow these next steps:
- Navigate to the Info tab.
- Click on Add Page.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Page Name | String | Name of the Page | Core Planning Group Notes |
All MSEL users can view this page | Boolean | Enable other users who don't have elevated permissions to access this page | True |
Notes | Rich Text | Field to add page notes | Next meeting is on 12/7 at 0800 |
After all changes have been added, click on the checkmark to save the page.
Team Roles
On this tab, users will be able to add and assign teams, as well as their respective roles during an exercise to the MSEL. Assigned teams will be able to view and edit the MSEL.
Add a Team
To add a team to the MSEL, follow these steps:
- Navigate to the Teams tab.
- Click on the Add a Team section and then select the desired team to be added.
- After selecting the team, click on the + button.
Delete a Team
To delete a team from the MSEL, follow these steps:
- Navigate to the Teams tab.
- Select the desired team to be removed and click on the - button.
Now the team has been added to the MSEL and members will be able to view and edit the MSEL based on the role assigned to each team member.
The available roles are:
- Editor: Edit the events that they are assigned to, but not other events. They cannot delete them or create new ones.
- Approver: Can view and edit the MSEL, but will have the added feature of approving a MSEL.
- Move Editor: Can edit moves on the MSEL, as well as increment them during an exercise.
- Owner: Owner of the MSEL, can view and edit the MSEL, as well as perform all of the functionalities that the MSEL provides (e.g.: Add Teams, Add Integrations, Events, etc).
- Facilitator: Manages the exercise, can advance moves, execute events, and check events as completed.
- Viewer: Can view the MSEL, but can't do any edits to it.
- Gallery Observer: When Gallery integration is enabled, this role will allow a user to observe other team's progress on the Gallery application during an exercise.
- CITE Observer: When CITE integration is enabled, this role will allow a user to observe other team's progress on the CITE application during an exercise.
Data Fields
On this tab, users will be able to add data fields that are going to be used on the MSEL. These data fields can be compared to the column fields used on Excel spreadsheets.
As it can be seen, there are two categories of Data Fields.
- System Defined: Added by default in MSEL creation, since data fields under this category are essential for MSEL features to work.
- User Defined: These are added by the user on an as-needed basis.
Add a Data Field
To add a Data Field to the MSEL, follow these steps:
- Navigate to the Data Fields tab.
- Click on the + icon from the top left of the screen.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Display Order | Integer | Indicate the order of the data field | 1 |
Name | String | Name of the data field | Description |
Data Type | Dropdown Text | Data type for the data field | String |
Use Option List | Boolean | Add options to be selected when adding an event | True |
Display on the Events list | Boolean | Display this data field on the Events list tab | True |
Display on the Exercise View | Boolean | Display this data field on the Exercise View tab | True |
Display on "Avanced" edit tab | Boolean | Display this data field on the data field edit component Advanced tab | True |
Display for Content Developers and MSEL Owners ONLY!!! | Boolean | Display this data field for users who are Content Developers or MSEL Owners only | True |
Gallery Article Parameter | Dopdown Text | If using the Gallery integration, select the Gallery parameter that aligns with the data field | Description |
Column Metadata (Width) | Integer | Width of the column when displayed | 30 |
Cell Metadata (Color, Tint, Font-Weight) | String | Column color and font style | (Red, 20%, bold) |
After all desired configurations have been added, click Save.
Delete a Data Field
To delete a Data Field from the MSEL, follow these steps:
- Navigate to the Data Fields tab.
- Select the desired data field to be deleted and click on the Trash Can icon.
Edit a Data Field
To edit an existing Data Field, follow these steps:
- Navigate to the Data Fields tab.
- Select the data field to be edited and click on the Edit button to make any changes to the existing configurations.
- After making all the necessary changes, click on the checkmark to save them.
Search For a Data Field
To search for a specific Data Field, follow these steps:
- Navigate to the Data Fields tab.
- Click on the Search Bar and add the name of the data field desired.
Organizations
On this tab, users will be able to add all the related organizations that are going to be used on the MSEL, as well as on the live exercise. Here, organizations with their information are added. Additionally, users can create organizations from scratch or from a template.
Add an Organization Card From Scratch
To add an Organization Card from scratch, follow these steps:
- Navigate to the Organizations tab.
- Click on Add Organization.
- Select New Organization from the dropdown.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name of the organization | |
Short Name | String | Organization's short name, such as an acronym | TW |
Summary | String | Organization's short summary | Social media platform |
String | Organization's email contact | user@twitter.com | |
Description | Rich Text | Information, details, and characteristics of the organization | Twitter is a microblogging and social networking service on which users post and interact with messages known as "tweets", owned by American compnay Twitter, Inc. |
After all desired configurations have been added, click Save.
Add an Organization Card From Template
To create an organization from a template, follow these steps:
- Navigate to the Organizations tab.
- Click on Add Organization.
- Select the desired template to be used from the dropdown.
- Here, users will be able to edit all necessary information to create a new organization.
- After modifying the desired details, click Save.
Edit an Organization
To edit an existing organization, follow these steps:
- Navigate to the Organizations tab.
- Select the desired card to be edited and click on the Edit button next to the organization name.
- Here, users will be able to edit all necessary information.
- Click Save.
Delete an Organization
To delete an organization, follow these steps:
- Navigate to the Organizations tab.
- Select the desired card to be deleted and click on the Trash Can icon next to the organization name.
Search for an Organization
To search for a specific organization, follow these steps:
- Navigate to the Organizations tab.
- Click on the Search Bar and type the name of the desired organization.
Moves
On this tab, users will be able to add all the related exercise moves to the MSEL.
Add a Move
To add a move, follow these steps:
- Navigate to the Moves tab.
- Click on the + icon.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Move Number | Integer | Designated number for the move | 1 |
Start Date/Time | Datetime | Start date/time of the move real-time | 11/20/2023, 09:00:00 |
Move Description | String | Information, details, and characteristics of the move | Scene Setter |
Situation Date/Time | Datetime | Start date/time of the move exercise-time | 1/24/2024, 14:18:27 |
Situation Description | Rich Text | Information, details, and characteristics of the exercise | Huricane Delta has landed in Fort Myers |
After all desired configurations have been added, click Save.
Edit a Move
To edit the move's details, follow these steps:
- Navigate to the Moves tab.
- Select the move you want to edit and click on the Edit button for the corresponding move.
- Here, users will be able to edit all the desired details.
- Click Save.
Delete a Move
To delete a move from the MSEL, follow these steps:
- Navigate to the Moves tab.
- Select the move you want to delete and click on the Trash Can button for the corresponding move.
Search For a Move
To search for a specific move, follow these steps:
- Navigate to the Moves tab.
- Click on the Search Bar and type the name of the desired move.
Events
On this tab, users will be able to add all the related events to the MSEL.
Add an Event
To add a new event, follow these steps:
- Navigate to the Events tab.
- Click on the Hamburger icon found on the top left.
- Click on Add New Event.
On the Default tab, fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Control Number | String | Event control number, used to identify and categorize events | ADMIN-1 |
Description | String | Information, details, and characteristics of the event | STARTEX |
Status | Dropdown Text | Approval status of the event to be used on the MSEL | Approved |
Time | Datetime | Start date/time of the move real-time | 11/20/2023, 09:00:00 |
Move | Dropdown Text | Move number the event is part of | 1 |
Group | Integer | Groups events within a move, often times executed within the same time range | 1 |
Exericse Date | Datetime | Start date/time of the move exercise-time | 1/24/2024, 14:18:27 |
Type | String | Source type for the event | |
Delivery Method | Dropdown Text | How is the event going to be delivered to participants |
If not already completed on the previous tab, fill the fields from the Advanced tab following the Data Format Table specifications. This tab focuses on the MSEL's metadata and style.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Exericse Date/Time | Datetime | Start date/time of the move exercise-time | 1/24/2024, 14:18:27 |
Row Metadata | Integer | Defines the size of this event on the Events and Exercise View tabs | 15,199,21,133 |
If Gallery integration is enabled and not already completed on the Default tab, fill the fields from the Gallery tab following the Data Format Table specifications. This tab focuses on the Gallery fields necessary for the integration to work.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Description | String | Information, details, and characteristics of the event | STARTEX |
Status | Dropdown Text | Approval status of the event to be used on the MSEL | Approved |
Move | Dropdown Text | Move number the event is part of | 1 |
Group | Integer | Groups events within a move, often times executed within the same time range | 1 |
Exericse Date | Datetime | Start date/time of the move exercise-time | 1/24/2024, 14:18:27 |
Delivery Method | Dropdown Text | How is the event going to be delivered to participants | Gallery |
Title | String | Title of the event | Bank Consortium Falls Victim to Ransomware Attack |
From Org | Dropdown Text | Select the organization that sends this event | CC News |
To Org | Dropdown Text | Select the organization that receives this event | ALL |
After all desired configurations have been added, click Save.
Add Color to an Event
To add a color to an existing event, follow these steps:
- Navigate to the Events tab.
- Select the desired event to be edited and click on the Hamburger icon next to the event.
- Hover over Highlight.
- Here, users will be able to select the desired color.
Edit an Event
To edit the events's details, follow these steps:
- Navigate to the Events tab.
- Select the desired event to be edited and click on the Hamburger icon next to the event.
- Click on Edit.
- Here, users will be prompted the same event's edit component as when adding a new event.
- After doing all the necessary edits, click Save.
Delete an Event
To delete an event, follow these steps:
- Navigate to the Events tab.
- Select the desired event to be deleted and click on the Trash Can icon next to the event.
Search For an Event
To search for a specific event, follow these steps:
- Navigate to the Events tab.
- Click on the Search Bar and type the name of the desired event.
Exercise View
Whereas the Events tab is for MSEL Owners and Content Developers to add, edit, and delete MSEL events, the Exercise View tab is meant to be used to allow participants access to MSEL events on-the-fly in a read-only format. This will allow the tracking of current and future events to be executed during an exercise.
Integrations
Integrations to the following applications have been added to facilitate the extra configurations that should be done in each of these applications. With this functionality, no more repetitive steps are needed to be done in multiple applications.
CITE
If enabled, Blueprint will be able to push MSEL information to the CITE Application. For this, additional tabs will be added to the Blueprint side panel, which will be needed to be configured.
To enable the full CITE integration functionality the following tabs should be configured.
Team Roles
On the Teams tab, extra CITE configurations should be done on teams that have been added to the MSEL. To do so, follow these steps.
- Navigate to the Teams tab.
- Select the desired team, and click on it to expand its configurations.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
CITE Team Type | Dropdown Text | Classifies the team within a certain type | Individual Organization |
Team Email | String | Team's email contact | seicmu@cmu.edu |
CITE Actions
On this tab, CITE Actions can be added to be pushed from Blueprint. These actions will allow team members to customize their response by tracking tasks during the exercise.
Add a CITE Action
To add a CITE Action, follow these steps:
- Navigate to the CITE Actions tab.
- Click on the + icon.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Move | Dropdown Text | Select the move where this action should be displayed | 0 - Hurricane Delta Scene Setter |
Team | Dropdown Text | Select the team this action applies to | Conference of State Bank Supervisors |
Display Order | Integer | Indicates the order this action should be displayed on the CITE Dashboard | 1 |
Description of the Action | String | Information, details, and characteristics of the action | Assign users to roles |
After all desired configurations have been added, click Save.
Edit a CITE Action
To edit the CITE Action's details, follow these steps:
- Navigate to the CITE Actions tab.
- Select the desired action to be edited and click on the Edit icon next to the action.
- Here, users will be prompted the same action's edit component as when adding a new action.
- After doing all the necessary edits, click Save.
Delete a CITE Action
To delete a CITE Action, follow these steps:
- Navigate to the CITE Actions tab.
- Select the desired action to be deleted and click on the Trash Can icon next to the action.
Filter Actions by Team
To filter CITE Actions by teams, follow these steps:
- Navigate to the CITE Actions tab.
- On the Team dropdown, select the desired team to filter by.
Search For an Action
To search for a specific action, follow these steps:
- Navigate to the CITE Actions tab.
- Click on the Search Bar and type the name of the desired action.
CITE Roles
On this tab, CITE Roles can be added to be pushed from Blueprint. These roles will allow team members to customize their response by tracking their responsibilities during an exercise.
Add a CITE Role
To add a CITE Role, follow these steps:
- Navigate to the CITE Roles tab.
- Click on the + icon.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name of the role | Team Leader |
Team | Dropdown Text | Select the team this role applies to | Conference of State Bank Supervisors |
After all desired configurations have been added, click Save.
Edit a CITE Role
To edit the CITE Role's details, follow these steps:
- Navigate to the CITE Roles tab.
- Select the desired role to be edited and click on the Edit icon next to the role.
- Here, users will be prompted the same role's edit component as when adding a new role.
- After doing all the necessary edits, click Save.
Delete a CITE Role
To delete a CITE Role, follow these steps:
- Navigate to the CITE Roles tab.
- Select the desired role to be deleted and click on the Trash Can icon next to the role.
Filter Roles by Team
To filter Roles by team, follow these steps:
- Navigate to the CITE Roles tab.
- On the Team dropdown, select the desired team to filter by.
Search For a Role
To search for a specific role, follow these steps:
- Navigate to the CITE Roles tab.
- Click on the Search Bar and type the name of the desired role.
Gallery
If enabled, Blueprint will be able to push MSEL information to the Gallery application. For this, additional tabs will be added to the Blueprint side panel, which will be needed to be configured.
To enable the full Gallery integration functionality the following tabs should be configured.
Gallery Data Fields
On the Data Fields tab, additional data fields should be configured to be able to push MSEL information to Gallery.
Data fields that should be added are:
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Description | String | Information, details, and characteristics of the event | STARTEX |
Date Posted | Datetime | Date of when the event was posted | 1/24/2024, 14:18:27 |
Delivery Method | Dropdown Text | How is the event going to be delivered to participants | Gallery |
Name | String | Name of the event | Common Operating Picture 1 |
From Org | Dropdown Text | Select the organization that sends this event | CC News |
To Org | Dropdown Text | Select the organization that receives this event | ALL |
Summary | Rich Text | Complete information and details of the event | Bank XYZ has been affected by a ransomware attack... |
Card | Dropdown Text | Select the Gallery Card this event should be categorized with | Information Technology Sector |
Status | Dropdown Text | Approval status of the event to be used on the MSEL | Approved |
Source Type | Dropdown Text | Select from where the event's details come from | News |
Source Name | String | Add the author of the event | BBC News |
Move | Dropdown Text | Move number the event is part of | 1 |
Group | Integer | Groups events within a move, often times executed within the same time range | 1 |
Url | String | Provide a URL if more information is necessary for participants to access | www.bbcnews.com/ransomware-attack-xyzbank |
Open in a New Tab | Boolean | If a URL was provided, select this option if desired to open the URL in a new tab | True |
After adding these data fields, these should be mapped to their appropriate Gallery field. This can be done by selecting an option from the Gallery Article Parameter dropdown when adding/editing a data field.
Gallery Cards
On this tab, Gallery Cards can be added to be pushed from Blueprint. These are the different cards presented in the Gallery Wall and where different articles related to that card can be found.
Add a Gallery Card
To add a Gallery card, follow these steps:
- Navigate to the Gallery Cards tab.
- Click on the + icon.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name of the Gallery card | Energy Sector |
Card Description | String | Information, details, and characteristics of the Gallery card | The current state of the Energy Sector |
Move | Dropdown Text | Select the move where this Gallery card should be displayed | 0 |
After all desired configurations have been added, click Save.
Edit a Gallery Card
To edit the Gallery card's details, follow these steps:
- Navigate to the Gallery Cards tab.
- Select the desired card to be edited and click on the Edit icon next to the card.
- Here, users will be prompted the same card's edit component as when adding a new card.
- After doing all the necessary edits, click Save.
Delete a Gallery Card
To delete a Gallery card, follow these steps:
- Navigate to the Gallery Cards tab.
- Select the desired card to be deleted and click on the Trash Can icon next to the card.
Search For a Gallery Card
To search for a specific card, follow these steps:
- Navigate to the Gallery Cards tab.
- Click on the Search Bar and type the name of the desired card.
Player
If enabled, Blueprint will be able to push MSEL information to the Player application. For this, additional tabs will be added to the Blueprint side panel, which will be needed to be configured.
To enable the full Player integration functionality the following tabs should be configured.
Player Apps
On this tab, Player Apps configurations can be added to be pushed from Blueprint. These are the different applications accessible from the Player View.
Add a Player App
To add a Player App, follow these steps:
- Navigate to the Player Apps tab.
- Click on the + icon.
- Select an app template from the provided list.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name of the application | Chat |
Url | String | URL of the application | https://roundcube.hamilton.treasury.gov/ |
Icon Url | String | URL of the application's icon | https://roundcube.hamilton.treasury.gov/roundcube.png |
Embeddable | Boolean | Select whether the app should be embedded in Player's iframe | True |
Load in Background | Boolean | Select whether the app should load in the background | True |
After all desired configurations have been added, click Save.
Edit a Player App
To edit the Player app's details, follow these steps:
- Navigate to the Player Apps tab.
- Select the desired app to be edited and click on the Edit icon next to the app.
- Here, users will be prompted the same app's edit component as when adding a new app.
- After doing all the necessary edits, click Save.
Delete a Player App
To delete a Player App, follow these steps:
- Navigate to the Player Apps tab.
- Select the desired app to be deleted and click on the Trash Can icon next to the app.
Search For a Player App
To search for a specific app, follow these steps:
- Navigate to the Player Apps tab.
- Click on the Search Bar and type the name of the desired app.
Push Integrations
After adding all of the MSEL information and performing all of the configurations necessary, information from the different enabled integrations can be pushed to their respective applications.
To push MSEL information to their respective applications, follow these steps:
- Navigate to the Info tab.
- Click the Push Integrations button.
Remove Integrations
If desired, MSEL information can be removed after being pushed to their respective applications
To remove MSEL information from the applications, follow these steps:
- Navigate to the Info tab.
- Click the Remove Integrations button.
Administrator Guide
Teams
The following image shows the Teams Administration Page. Here, administrators can add, edit, and delete teams. To be able to use the Blueprint application, the administrator should assign a team to desired users.
Add a Team
Assuming that the user has been granted the appropriate permissions by the exercise administrator, follow these steps to add a team.
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Teams Administration View, click +.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name for the team | Carnegie Mellon University |
Short Name | String | Short name for the team | CMU |
After all desired configurations have been added, click Save.
Edit a Team
To edit the team's details, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Teams Administration View, select the team to be edited and click on the Edit Icon next to the team.
- Here, users will be prompted the same teams's edit component as when adding a new team.
- After doing all the necessary edits, click Save.
Delete a Team
To delete a team, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Teams Administration View, select the team to be deleted and click on the Trash Can Icon next to the team.
Search For a Team
To search for a specific team, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Teams Administration View, click on the Search Bar and type the name of the desired team.
Add/Remove Users From a Team
To configure a team for an exercise, administrators will need to add users to their respective teams. To do this, follow these steps.
- Select the team to be configured and click on it to expand its configuration details.
- Under the All Users tab, users that have not been assigned to the team will be shown. To add them to the team, click on Add User.
- Under the Team Users tab, users that have already been assigned to the team will be shown. To remove a user from the team, click on Remove.
Users
The following image shows the Users Administration Page. Here, administrators can add and delete users. Additionally, administrators will be able to assign the necessary permissions to each user.
The available permissions are:
- System Admin: Can use all administration privileges on the Blueprint application.
- Content Developer: Can view, edit, create, and approve events on the MSEL.
Add a User
Assuming that the user has been granted the appropriate permissions by the exercise administrator, follow these steps to add a user.
- Under the Users Administration View, click +.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
User ID | guid | Unique ID for the user | 9dd4e3d8-5098-4b0a-9216-697cda5553f8 |
User Name | String | User name identifier | user-2 |
Click Save represented by a user with a + sign and select the desired permissions to be assigned by clicking on the checkboxes next to the user.
Delete a User
To delete a user, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Users Administration View, select the user to be deleted and click on the Trash Can Icon next to the user.
Search For a User
To search for a specific user, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Users Administration View, click on the Search Bar and type the name of the desired user.
Organization Templates
The following image shows the Organization Templates Administration Page. Here, administrators can add and delete organization templates.
Add an Organization Template
Assuming that the user has been granted the appropriate permissions by the exercise administrator, follow these steps to add an organization template.
- Under the Organizations Administration View, click +.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Long Name | String | Add the complete name for the organization | Cybersecurity and Infrastructure Security Agency |
Short Name | String | Add a short name for the organization, such as an acronym | CISA |
Summary | String | Organization's short summary | Security agency |
String | Organization's email contact | john@cisa.gov | |
Description | Rich Text | Information, details, and characteristics of the organization | The Cybersecurity and Infrastructure Security Agency (CISA) is an agency of the DHS that is responsible for strengthening cybersecurity and infrastructure protection... |
After all desired configurations have been added, click Save.
Edit an Organization Template
To edit the organization template's details, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Organizations Administration View, select the organization to be edited and click on the Edit Icon next to the organization template.
- Here, users will be prompted the same organization's edit component as when adding a new organization template.
- After doing all the necessary edits, click Save.
Delete an Organization Template
To delete an organization template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Organizations Administration View, select the organization to be deleted and click on the Trash Can Icon next to the organization template.
Search For an Organization Template
To search for a specific organization template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Organizations Administration View, click on the Search Bar and type the name of the desired organization template.
Gallery Card Templates
The following image shows the Gallery Card Templates Administration Page. Here, administrators can add and delete Gallery card templates.
Add a Gallery Card Template
Assuming that the user has been granted the appropriate permissions by the exercise administrator, follow these steps to add a Gallery card template.
- Under the Gallery Cards Administration View, click +.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Gallery card name | Information Technology Sector |
Card Description | String | Information, details, and characteristics of the Gallery card | Status of the Information Technology Sector |
After all desired configurations have been added, click Save.
Edit a Gallery Card Template
To edit the Gallery card template's details, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Gallery Cards Administration View, select the card template to be edited and click on the Edit Icon next to the Gallery card template.
- Here, users will be prompted the same Gallery card's edit component as when adding a new card template.
- After doing all the necessary edits, click Save.
Delete a Gallery Card Template
To delete an Gallery card template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Gallery Cards Administration View, select the card template to be deleted and click on the Trash Can Icon next to the card template.
Search For a Gallery Card Template
To search for a specific Gallery card template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the Gallery Cards Administration View, click on the Search Bar and type the name of the desired card template.
CITE Actions Templates
The following image shows the CITE Action Templates Administration Page. Here, administrators can add and delete CITE action templates.
Add a CITE Action Template
Assuming that the user has been granted the appropriate permissions by the exercise administrator, follow these steps to add a CITE action template.
- Under the CITE Actions Administration View, click +.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Description of the Action | String | Information, details, and characteristics of the CITE action | Score the incident |
After all desired configurations have been added, click Save.
Edit a CITE Action Template
To edit the CITE action template's details, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the CITE Actions Administration View, select the action template to be edited and click on the Edit Icon next to the action template.
- Here, users will be prompted the same CITE action's edit component as when adding a new action template.
- After doing all the necessary edits, click Save.
Delete a CITE Action Template
To delete an CITE action template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the CITE Actions Administration View, select the action template to be deleted and click on the Trash Can Icon next to the action template.
Search For a CITE Action Template
To search for a specific CITE action template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the CITE Actions Administration View, click on the Search Bar and type the name of the desired action template.
CITE Roles
The following image shows the CITE Roles Templates Administration Page. Here, administrators can add and delete CITE roles templates.
Add a CITE Role Template
Assuming that the user has been granted the appropriate permissions by the exercise administrator, follow these steps to add a CITE role template.
- Under the CITE Roles Administration View, click +.
- Fill the fields as necessary following the Data Format Table specifications.
Data Format Table
Column | Data Type | Description | Example |
---|---|---|---|
Name | String | Name of the role | Reviewer |
After all desired configurations have been added, click Save.
Edit a CITE Role Template
To edit the CITE role template's details, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the CITE Roles Administration View, select the role template to be edited and click on the Edit Icon next to the role template.
- Here, users will be prompted the same CITE role's edit component as when adding a new role template.
- After doing all the necessary edits, click Save.
Delete a CITE Role Template
To delete a CITE role template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the CITE Roles Administration View, select the role template to be deleted and click on the Trash Can Icon next to the role template.
Search For a CITE Role Template
To search for a specific CITE role template, follow these steps:
- Click on the Settings Cog found in the top-right corner of the screen.
- Under the CITE Roles Administration View, click on the Search Bar and type the name of the desired role template.
Glossary
The following glossary provides a brief definition of key terms and concepts as they are used in the context of the Blueprint application.
- Approver Role: Can view and edit the MSEL, but will have the added feature of approving a MSEL.
- Blueprint: Web application created to make the development of a MSEL and events easier.
- CITE: Web application that allows multiple participants from different organizations to evaluate, score, and comment on cyber incidents.
- CITE Action: Series of steps to guide users on an appropriate course of action during an exercise.
- CITE Observer Role: When CITE integration is enabled, this role will allow a user to observe other team's progress on the CITE application during an exercise.
- CITE Role: Provide a set of responsibilities assigned to a user during an exercise.
- Content Developer Permission: Can view, edit, create, and approve events on the MSEL.
- Data Fields: Structured components containing essential information about the event's characterictics, context, and implications.
- Editor Role: Edit the events that they are assigned to, but not other events. They cannot delete them or create new ones.
- Events: Specific scenario events or messages within the scenario that prompt users to implement designated actions.
- Exercises: Structured and simulated activity designed to assess, train, or evaluate the capabilities, preparedness, and responses of individuals, teams, or organizations in dealing with various situations, especially emergencies or crisis scenarios.
- Facilitator Permission: Manages the exercise, can advance moves, execute events, and check events as completed.
- Gallery: Web application where participants receive incident information.
- Gallery Card: Groups articles into their respective categories, the categories can be defined in the administration panel.
- Gallery Observer Role: When Gallery integration is enabled, this role will allow a user to observe other team's progress on the Gallery application during an exercise.
- Move Editor: Can edit moves on the MSEL, as well as increment them during an exercise.
- Moves: A defined period of time during an exercise, in which a series of events are distributed for users to discuss and assess the current incident severity.
- MSEL: (Master Scenario Events List) provides a timeline for all expected events, affiliated users and organizations during an exercise.
- Organizations: Entities within an exercise with defined roles, responsibilities, and functions.
- Owner Role: Owner of the MSEL, can view and edit the MSEL, as well as perform all of the functionalities that the MSEL provides (e.g.: Add Teams, Add Integrations, Events, etc).
- Player: Centralized web interface where participants, teams, and administrators go to engage in a cyber event.
- Player Apps: List of applications accessible from the same Player view.
- Player View: These are the settings associated with building a view. A view can be edited, cloned, and deleted.
- Steamfitter: Gives content developers the ability to create scenarios consisting of a series of scheduled tasks, manual tasks, and events which run against virtual machines during an event.
- System Admin Permission: Can add users to a team, as well as assign the required permissions.
- System Defined Data Fields: Added by default in MSEL creation, since data fields under this category are essential for MSEL features to work.
- User Defined Data Fields: These are added by the user on an as-needed basis.
- Viewer Role: Can view the MSEL, but can't do any edits to it.