Editing Custom Objects

Custom objects created by your organization can always be edited.

To edit a Custom Object:

  1. Navigate to ThreatStream > Analyze > Threat Models.
  2. Click the name of the Custom Object you want to edit.
  3. Click Actions > Edit.
    (Click the image to enlarge it.)

  4. In edit view, make changes to any of the fields listed below.

    Field Description
    TLP

    Select a TLP (Traffic Light Protocol) color to associate with the Custom Object.

    The TLP color provides a mechanism to communicate to consumers of the information whether further dissemination of this information is allowed; if yes, how freely can this information be distributed.

    To learn more about TLP, search for "Traffic Light Protocol" in your favorite search engine.
    Title

    Enter a meaningful name for the Custom Object.

    Custom object titles are associated with your organization. Therefore, you cannot create two Custom Objects with the same title within your organization. However, two Custom Objects with the same title can exist on ThreatStream as long as they belong to different organizations.

    Note: Titles must be 255 characters or less.
    Tags

    Enter a term that can be used to search for this entity later using search. To add private tags that are only visible to your organization, assign them the My Organization visibility setting. Tags assigned the Anomali Community visibility setting are visible to any user with access to the entity. Since organizations can decide whether users outside of their organization can add public tags to their data, the Anomali Community visibility setting is not available in all cases.

    Tagging is a quick and easy way to add metadata to threat intelligence. For example, you can add a tag to indicate the industry that the threat intelligence is associated with or a tag to indicate the Kill Chain phase stage.

    As you type the first few characters of the tag, the 20 most used tags in your organization from the previous seven days are displayed. Enable the Preferred Tags Only toggle to display and search though only the list of preferred tags. Alternatively, enter * to display preferred tags. For more information on configuring Preferred Tags, see Adding Preferred Tags to Intelligence.

    Note:  

    • Custom objects can contain up to 200 tags per organization. Tags added by other organizations do not count toward this limit.

    • Tags must be 2,000 characters or less.

    • You can remove any public tag added by other organizations to your Threat Model entities.

    Intelligence Initiative Add intelligence initiatives associated with the Custom Object. Click Add Intelligence Initiative to add an intelligence initiative to the Custom Object.

    Source Created

    Specify the date and time when the entity was created by its original source.

    Click Now to use the current time.

    Source Modified

    Specify the date and time when the entity was last modified by its original source.

    Click Now to use the current time.

    Aliases

    Enter other names that this Custom Object is known by.

    For example, Axiom is also known as Elderwood and Shell Crew.
    Source Locations

    Select source countries, regions, or administrative areas (US States and Washington DC only) associated with the Custom Object. Locations available for selection are defined by STIX 2.1.

    Note: Only organizations owning the Custom Objectcan add or delete source locations.
    Target Locations

    Select target countries, regions, or administrative areas (US States and Washington DC only) associated with the Custom Object. Locations available for selection are defined by STIX 2.1.

    Note: Only organizations owning the Custom Object can add or delete target locations.
    Target Industry

    Select target industries associated with the Custom Object. Target industry options available for selection are defined by the STIX 2.1 Industry Sector vocabulary.

    Note: Only organizations owning the Custom Object can add or delete target industries.
    Custom Fields

    Add, edit, or remove custom fields by modifying the JSON code associated with the Custom Object.

    Note: Modifications must result in valid JSON format. You cannot save the Custom Object if the Custom Fields section contains invalid JSON code.
    Description
    Description

    Enter a description for the threat model. You can enter a description by using the Rich Text or a Markdown editor or a pre-existing description template.

    The Rich Text editor enables you to add pre-formatted content. You can copy and paste content including images from .doc, docx, and .pdf files into the Rich Text editor. All formatting is preserved.

    Tip: To remove formatting from pasted text, select the text from which you want to remove formatting and click the "Clear Formatting" button.

    The Markdown editor enables you to use a markdown description.

    Note: Once a description has been saved, you can no longer switch between the rich text and markdown editors.

    If you want to use a pre-existing description template, select it from the Templates drop-down list. If none of the existing templates meet your need, you can create a new template. See Creating Description Templates From Threat Models for more information.

    Associations
    Observables

    Create associations with the Custom Object.

    To create associations with this Custom Object:

    1. Click Add for the type of entity you want to associate.

    2. Select the entities you want to add.

    3. (Optional) On the Details tab, define an SRO for the association. See Managing STIX Relationship Objects (SROs) for more information.

    4. Click Create Association.

    The associations have been created.
    Threat Bulletins
    Actors
    Attack Patterns
    Campaigns
    Courses of Action
    Custom Threat Models
    Identities
    Incidents
    Infrastructure
    Intrusion Sets
    Malware
    Signatures
    Tools
    TTPs
    Vulnerabilities
    Sandbox Reports
    Investigations
    Investigations Investigations associated with the Custom Object. To remove the Custom Object from an investigation, click on the investigation of your interest and delete the Custom Object from the investigation page. See Managing Entities on the Table View for details.
    Attachments
    Attachments

    Add file attachments or external reference URLs to the entity.

    To add attachments:

    1. Click Add File in the Actions menu.

    2. Drag and drop files of interest into the resulting window, or click the window to open your file explorer and browse for files.

      Note: You can include up to 15 files in a single upload. Each files must be 10 MB or less. In sum, selected files must be 100 MB or less.

    3. Click Attach.

    The files have been uploaded.

    To add an external reference:

    1. Click Add URL in the Actions menu.
    2. Enter a Title for the reference.
    3. Enter the URL corresponding to the reference.
    4. Click Attach.

    The external reference has been added.

    Note: Visibility is set when you publish entities. If you want to change the Visibility of a published entity, click Publish in the Actions menu and select a new Visibility. See Reviewing Threat Model Entities for Publication for more information.