<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>file system paths &#8211; Blue Lance</title>
	<atom:link href="https://bluelance.com/docs-tag/file-system-paths/feed/" rel="self" type="application/rss+xml" />
	<link>https://bluelance.com</link>
	<description></description>
	<lastBuildDate>Mon, 01 Jun 2026 18:47:23 +0000</lastBuildDate>
	<language>en-US</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.0</generator>

<image>
	<url>https://bluelance.com/wp-content/uploads/2025/11/fevicon-ic-1.png</url>
	<title>file system paths &#8211; Blue Lance</title>
	<link>https://bluelance.com</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>Defining Scan Targets</title>
		<link>https://bluelance.com/docs/defining-scan-targets/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:21:58 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15883</guid>

					<description><![CDATA[Scan targets define the file system paths that PII Scanner client agents will scan when a scan job is executed. Before creating your first scan job, it is important to plan which paths you want to scan, which agent has access to those paths, and which file types are in scope. This article covers how [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Scan targets define the file system paths that PII Scanner client agents will scan when a scan job is executed. Before creating your first scan job, it is important to plan which paths you want to scan, which agent has access to those paths, and which file types are in scope. This article covers how to configure scan targets and prepare them for use in scan jobs.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Understanding scan targets:</strong></p>



<p class="wp-block-paragraph">A scan target in PII Scanner consists of:</p>



<ul class="wp-block-list">
<li>A <strong>file system path</strong> — the directory, network share, or drive to be scanned</li>



<li>A <strong>client agent</strong> — the agent that will execute the scan against that path</li>



<li><strong>File type filters</strong> — optional limits on which file extensions are included in the scan</li>



<li><strong>PII classes</strong> — the sensitive data patterns to look for during the scan</li>
</ul>



<p class="wp-block-paragraph">Scan targets are not configured as standalone objects in the PII Scanner administrative interface — they are defined as part of each individual scan job. Planning your targets in advance makes job creation faster and more consistent.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Planning your scan targets:</strong></p>



<p class="wp-block-paragraph">Before creating scan jobs, work through the following planning steps with your administrator:</p>



<p class="wp-block-paragraph"><strong>1. Identify which file systems contain sensitive data:</strong></p>



<p class="wp-block-paragraph">Common locations that typically require scanning:</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Location Type</strong></td><td><strong>Examples</strong></td></tr><tr><td>File servers and network shares</td><td>\\fileserver01\shares\HR, \\fileserver01\shares\Finance</td></tr><tr><td>Local drives on servers</td><td>C:\Data, D:\Projects</td></tr><tr><td>Linux mount points</td><td>/mnt/shares/documents, /home/shared/data</td></tr><tr><td>Department-specific shares</td><td>Legal, Finance, HR, Executive directories</td></tr><tr><td>Archive or backup locations</td><td>Older data stores that may contain historical PII</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><strong>2. Identify which agent has access to each path:</strong></p>



<p class="wp-block-paragraph">Each scan job is executed by a single client agent. The selected agent must have:</p>



<ul class="wp-block-list">
<li>Network access to the target path</li>



<li>Read permissions on the target directory and all subdirectories</li>



<li>Sufficient resources (CPU, memory, disk I/O) to perform the scan without impacting other workloads</li>
</ul>



<p class="wp-block-paragraph"><strong>3. Determine which file types to include:</strong></p>



<p class="wp-block-paragraph">Scanning all file types provides the most complete coverage but increases scan time and resource usage. Consider filtering by extension for initial scans:</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Use Case</strong></td><td><strong>Recommended Extensions</strong></td></tr><tr><td>Office documents</td><td>*.docx, *.xlsx, *.pptx, *.pdf</td></tr><tr><td>Legacy Office formats</td><td>*.doc, *.xls, *.ppt</td></tr><tr><td>Text and data files</td><td>*.txt, *.csv, *.log</td></tr><tr><td>All common document types</td><td>*.docx, *.xlsx, *.pdf, *.txt, *.csv</td></tr><tr><td>Full scan (all types)</td><td>Leave the extension filter blank</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><strong>4. Confirm the LT Auditor <sup>MP</sup> target host:</strong></p>



<p class="wp-block-paragraph">All scan results are forwarded to LT Auditor <sup>MP</sup> via syslog. Confirm the LT Auditor <sup>MP</sup> target host is configured in the PII Scanner Server before creating scan jobs. See the Managing Target Hosts section below.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Configuring target hosts in the PII Scanner Server:</strong></p>



<p class="wp-block-paragraph">Before running any scans, configure where scan results will be sent — your LT Auditor <sup>MP</sup> syslog receiver.</p>



<p class="wp-block-paragraph">Log in to the PII Scanner Server web UI at:<br>https://&lt;PII_Scanner_Server_IP&gt;:52766</p>



<ol class="wp-block-list">
<li></li>



<li>Navigate to <strong>Admin → Target Hosts</strong></li>



<li>Click <strong>Add Target</strong></li>



<li>Configure the target host details:
<ul class="wp-block-list">
<li><strong>Name</strong> — a friendly identifier (e.g., Production LT Auditor <sup>MP</sup>)</li>



<li><strong>Target Server</strong> — the hostname or IP address of your LT Auditor <sup>MP</sup> server</li>



<li><strong>Port</strong> — the syslog port configured in LT Auditor <sup>MP</sup> (default: 514)</li>



<li><strong>Protocol</strong> — select UDP, TCP, or TLS</li>
</ul>
</li>
</ol>



<p class="wp-block-paragraph"><strong>Protocol options:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Protocol</strong></td><td><strong>Description</strong></td><td><strong>Recommended Use</strong></td></tr><tr><td>UDP</td><td>Fast, no delivery guarantee</td><td>High-volume, low-criticality environments</td></tr><tr><td>TCP</td><td>Reliable delivery, guaranteed</td><td>Production environments — recommended</td></tr><tr><td>TLS</td><td>Encrypted, secure transport</td><td>Production environments with strict security requirements</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><strong>Additional TLS configuration (if TLS is selected):</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Setting</strong></td><td><strong>Description</strong></td></tr><tr><td>Server Name</td><td>SNI hostname for certificate validation</td></tr><tr><td>Verify Certificate</td><td>Enable for production deployments</td></tr><tr><td>TLS Certificate Path</td><td>Optional CA bundle for server verification</td></tr><tr><td>Client TLS</td><td>Enable if mutual TLS is required</td></tr><tr><td>Client Certificate Path / Password</td><td>Required for mutual TLS authentication</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><strong>Example production target configuration:</strong></p>



<ul class="wp-block-list">
<li>Name: Production LT Auditor <sup>MP</sup></li>



<li>Host: ltauditor.yourcompany.com</li>



<li>Port: 6514</li>



<li>Protocol: TLS</li>



<li>Server Name: ltauditor.yourcompany.com</li>



<li>Verify Certificate: Yes</li>
</ul>



<ol start="5" class="wp-block-list">
<li>Click <strong>Save</strong></li>
</ol>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Configuring PII detection patterns:</strong></p>



<p class="wp-block-paragraph">PII Scanner uses regex-based patterns to identify sensitive data. Before running scans, review the available PII classes and confirm the right ones are enabled for your environment.</p>



<ol class="wp-block-list">
<li>In the PII Scanner Server web UI, navigate to <strong>Admin → PII Patterns</strong></li>



<li>Review the available PII classes:</li>
</ol>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>PII Class</strong></td><td><strong>Examples Detected</strong></td></tr><tr><td>Social Security Numbers</td><td>123-45-6789, 123456789</td></tr><tr><td>Credit Card Numbers</td><td>Visa, Mastercard, Amex, Discover formats</td></tr><tr><td>Email Addresses</td><td>user@domain.com</td></tr><tr><td>Phone Numbers</td><td>US and international formats</td></tr><tr><td>Dates of Birth</td><td>Common date formats</td></tr><tr><td>Medical Record Numbers</td><td>Common MRN formats</td></tr></tbody></table></figure>



<ol start="3" class="wp-block-list">
<li>Enable or disable individual PII classes using the <strong>Enabled</strong> toggle</li>



<li>Click the <strong>Edit</strong> icon to modify an existing pattern if needed</li>



<li>To add a custom pattern for organization-specific sensitive data:
<ul class="wp-block-list">
<li>Click <strong>Add Pattern</strong></li>



<li>Enter a descriptive name</li>



<li>Enter the regex pattern</li>



<li>Set the severity level</li>



<li>Click <strong>Save</strong></li>
</ul>
</li>
</ol>



<p class="wp-block-paragraph"><em>[Your administrator should review the default PII patterns and add any custom patterns required for your organization&#8217;s specific data types before running the first scan.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Managing client agents:</strong></p>



<p class="wp-block-paragraph">Before assigning agents to scan jobs, confirm all agents are online and healthy.</p>



<ol class="wp-block-list">
<li>Navigate to <strong>Admin → Clients</strong> in the PII Scanner Server web UI</li>



<li>Review the client list:</li>
</ol>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Indicator</strong></td><td><strong>Meaning</strong></td></tr><tr><td>● Online (Green)</td><td>Agent checked in within the last 5 minutes</td></tr><tr><td>● Offline (Red)</td><td>No communication in the last 5 minutes</td></tr></tbody></table></figure>



<ol start="3" class="wp-block-list">
<li><br>Review each agent&#8217;s details:<br>
<ul class="wp-block-list">
<li><strong>Name</strong> — the machine hostname</li>



<li><strong>IP Address</strong> — the last known IP address</li>



<li><strong>Last Seen</strong> — the timestamp of the last check-in</li>
</ul>
</li>



<li>If an agent shows as offline, check:<br>
<ul class="wp-block-list">
<li>The LTA-Scanner service is running on that machine</li>



<li>The agent&#8217;s config.json points to the correct server IP and port</li>



<li>No firewall is blocking port 52766 between the agent and the server</li>
</ul>
</li>



<li>To remove a decommissioned agent, click the <strong>Delete</strong> button next to it<br><br><br>A deleted agent will automatically re-register on its next poll cycle if it is still active.<br><br></li>
</ol>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Best practices:</strong></p>



<ul class="wp-block-list">
<li>Start with targeted, focused scans of your highest-risk directories before expanding to broader file system coverage</li>



<li>Assign scan jobs to the agent closest to the target path to minimize network traffic during scanning</li>



<li>Use file extension filters for initial scans to reduce scan time and focus on the most likely file types to contain PII</li>



<li>Avoid scheduling broad scans during peak business hours — large scans can generate significant disk I/O on the scanned machine</li>



<li>Confirm read permissions for the agent service account on all target paths before creating scan jobs to avoid permission errors mid-scan</li>



<li>Review and update PII detection patterns regularly to ensure they reflect current data types in use in your organization</li>



<li>Document your planned scan target inventory so the team has a clear picture of what is and is not in scope</li>
</ul>



<p class="wp-block-paragraph"><em>[Your administrator should maintain a record of all configured target hosts and PII patterns, and review them whenever compliance requirements or the monitored environment changes.]</em></p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
