How do I best add a GUID as a data type?
To use a GUID (Globally Unique Identifier) as a search term in Spirion, you have two primary options depending on whether you are looking for one specific GUID or any string that follows the GUID format.
Option 1: Use a Keyword (For a Specific GUID)
If you are looking for one specific, known GUID (for example, 550e8400-e29b-41d4-a716-446655440000), use the Keyword data type.
- From the left side navigation menu navigate to Settings > Global Data Types.
- Click the CUSTOM DATA TYPES tab on the top of the page.
- Click the blue "Actions" button and select Add Custom Data Type from the drop-down menu.
- Under "Select Data Type" select Keyword.
- Name: Give it a descriptive name (for example, "Specific Project GUID").
- Keyword: Paste the exact GUID string.
Note: Keywords in Spirion are typically case-sensitive. Ensure the GUID in your search matches the casing (uppercase vs. lowercase) expected in your files.
Option 2: Use a Regular Expression (For Any GUID)
If you want to find any string that follows the standard GUID pattern (8-4-4-4-12 hexadecimal characters), use a Regular Expression (RegEx).
This is the most common way to find GUIDs because they follow a predictable structure:
- From the left side navigation menu navigate to Settings > Global Data Types.
- Click the CUSTOM DATA TYPES tab on the top of the page.
- Click the blue "Actions" button and select Add Custom Data Type from the drop-down menu.
- Under "Select Data Type" select Regular Expression.
- Name: "GUID Pattern".
- Regex: Use a pattern that matches the standard GUID format.
- Common example:
- To avoid matching random strings of characters, you may want to add word boundaries (
\b) to the start and end:
\b[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\b- To avoid matching random strings of characters, you may want to add word boundaries (
Which one should you choose?
- Use Keyword if you are searching for a specific "secret" or identifier that you already know.
- Use RegEx if you are trying to identify files that contain any unique identifiers, which is often a sign of database exports or system logs.
Important Considerations
- Case Sensitivity:
- GUIDs are often represented in all-caps or all-lowercase.
- RegEx is generally case-insensitive in Spirion by default, but Keywords are not.
- Braces:
- Some GUIDs are wrapped in curly braces (for example,
{550e8400-...}). - If your data includes these, ensure your Keyword includes them or update your Regular Expression to account for optional braces:
\{?[a-fA-F0-9]{8}-...\}?.
- Some GUIDs are wrapped in curly braces (for example,
- Performance:
- If you have a list of 100+ specific GUIDs to find, do not create 100 Keywords.
- Instead, use a Dictionary data type and upload the list as a text file.