misp-book/managing-feeds
Déborah Servili 7c3244e188 add pictures 2017-02-17 16:02:16 +01:00
..
figures add pictures 2017-02-17 16:02:16 +01:00
README.md managing feed chapter (possibly WIP) 2017-02-17 15:59:51 +01:00

README.md

Managing feeds

/!\ You need to be at least %ROLE% to perform these actions. To do so, you first need to access the list of feeds, using the top menu.

List feeds menu

Adding feeds

Then select the add feed option on the side menu.

List feeds side menu

Here you will have access to a dynamic form. Let's check each field by order.

Add feed form

  • Enabled: Is the feed active or not
  • Name: Just a name to identify the feed
  • Provider: Name of the content provider

Input Source

  • Input Source: Where does the input come from

    • Network: hosted somewhere outside the platform
    • Local: Hosted on the local server. On this case, a new choice will appear:
    • Remove input after ingestion: As implied, if checked, the source is deleted after usage Remove Input
  • Url: Url of the feed, where it is located

  • The Source Format can be: Source Format

    • MISP Feed: The source points to a list of json formated like MISP events. Example: https://www.circl.lu/doc/misp/feed-osint

    • Freetext Parsed Feed: Freetext Parsed Feed

    • Target Event: Which will be the event getting updated with the data from the feed.

    • New Event Each Pull: A new event will be created each time the feed is pulled

    • Fixed Event: A unique event will be updated with the new data. This event is determined by the next field Target Event

    • Target Event ID: The id of the event where the data will be added (if not set, the field will be set the first time the feed is fetched)

    • Exclusion Regex: Add a regex pattern for detecting iocs that should be skipped (this can be useful to exclude any references to the actual report / feed for example)

    • Auto Publish: If checked, events created thanks to the feed will be automatically published

    • Override IDS Flag: If checked, the IDS flag will be set to false

    • Delta Merge: If checked, only data coming from the last fetch are kept, the old ones are deleted.

    • Simple CSV Parsed Feed: Simple CSV Parsed Feed

    • Target Event: Which will be the event getting updated with the data from the feed.

    • New Event Each Pull: A new event will be created each time the feed is pulled

    • Fixed Event: A unique event will be updated with the new data. This event is determined by the next field

    • Target Event ID: The id of the event where the data will be added (if not set, the field will be set the first time the feed is fetched)

    • Exclusion Regex: Add a regex pattern for detecting iocs that should be skipped (this can be useful to exclude any references to the actual report / feed for example)

    • Value field(s) in the CSV: Select one or several fields that should be parsed by the CSV parser and converted into MISP attributes

    • Delimiter: Set the default CSV delimiter (default = ",")

    • Auto Publish: If checked, events created thanks to the feed will be automatically published

    • Override IDS Flag: If checked, the IDS flag will be set to false

    • Delta Merge: If checked, only data coming from the last fetch are kept, the old ones are deleted.

  • Distribution: Define the distribution option that will be set on the event created by the feed

  • Default Tag: A default tag can be added to the created event(s)

  • Filter rules: Here you can define which tags or organisations are allowed or blocked. Filter rules

To add a tag (resp. organisation), first type it into the top middle (resp. bottom middle) text field . Then use the arrows that point to the outside to add it to the allowed or blocked tags (resp. organisations) list. Add Filter rules Add Filter rules To remove a tag (resp. organisation), select it in the list and click on the arrow pointing to the inside. Remove Filter rules Remove Filter rules