0
# Tag & Taxonomy Management
1
2
Comprehensive tagging and classification system management including taxonomies, warning lists, custom tags, and hierarchical classification structures.
3
4
## Capabilities
5
6
### Tag Management
7
8
Create, manage, and apply tags for data classification and organization.
9
10
```python { .api }
11
def tags(self, **kwargs) -> list:
12
"""List available tags."""
13
14
def get_tag(self, tag_id: Union[int, str]) -> dict:
15
"""Get specific tag details."""
16
17
def add_tag(self, tag: Union['MISPTag', dict], **kwargs) -> dict:
18
"""Create new tag."""
19
20
def update_tag(self, tag: Union['MISPTag', dict], tag_id: Union[int, str] = None) -> dict:
21
"""Update existing tag."""
22
23
def delete_tag(self, tag_id: Union[int, str]) -> dict:
24
"""Delete tag."""
25
26
def enable_tag(self, tag_id: Union[int, str]) -> dict:
27
"""Enable tag usage."""
28
29
def disable_tag(self, tag_id: Union[int, str]) -> dict:
30
"""Disable tag usage."""
31
```
32
33
### Taxonomy Management
34
35
Manage structured classification taxonomies and their hierarchies.
36
37
```python { .api }
38
def taxonomies(self, **kwargs) -> list:
39
"""List available taxonomies."""
40
41
def get_taxonomy(self, taxonomy_id: Union[int, str]) -> dict:
42
"""Get specific taxonomy."""
43
44
def enable_taxonomy(self, taxonomy_id: Union[int, str]) -> dict:
45
"""Enable taxonomy."""
46
47
def disable_taxonomy(self, taxonomy_id: Union[int, str]) -> dict:
48
"""Disable taxonomy."""
49
50
def update_taxonomies(self) -> dict:
51
"""Update taxonomies from repository."""
52
```
53
54
### Warning Lists
55
56
Manage false positive prevention through warning lists.
57
58
```python { .api }
59
def warninglists(self, **kwargs) -> list:
60
"""Get warning lists."""
61
62
def get_warninglist(self, warninglist_id: Union[int, str]) -> dict:
63
"""Get specific warning list."""
64
65
def toggle_warninglist(self, warninglist_id: Union[int, str], enabled: bool = None) -> dict:
66
"""Enable or disable warning list."""
67
68
def update_warninglists(self) -> dict:
69
"""Update warning lists from repository."""
70
```
71
72
## Usage Examples
73
74
### Tag Operations
75
76
```python
77
from pymisp import PyMISP, MISPTag
78
79
misp = PyMISP('https://misp.example.com', 'your-api-key')
80
81
# Create custom tag
82
tag = MISPTag()
83
tag.name = 'custom:high-priority'
84
tag.colour = '#ff0000'
85
tag.exportable = True
86
87
misp.add_tag(tag)
88
89
# List all tags
90
tags = misp.tags()
91
92
# Apply tag to event
93
misp.tag(event_id, 'apt')
94
```
95
96
### Taxonomy Management
97
98
```python
99
# List taxonomies
100
taxonomies = misp.taxonomies()
101
102
# Enable specific taxonomy
103
misp.enable_taxonomy('admiralty-scale')
104
105
# Get taxonomy details
106
admiralty = misp.get_taxonomy('admiralty-scale')
107
```