Security Monitor (Reference)

Security → Tutorial | Concept | How-to Guide |  Standards Compliance | Reference

Monitor Table Properties

The monitor displays results from @Server.GetAllConnections():

Runtime Access

Programmatic Monitoring

csharp

// Get all active connections
DataTable connections = @Server.GetAllConnections();

// Process connection data
foreach(DataRow row in connections.Rows)
{
    string user = row["UserName"].ToString();
    string ip = row["IP"].ToString();
    TimeSpan duration = (TimeSpan)row["ConnectionTime"];
    string process = row["ModuleName"].ToString();
    
    @Info.Trace($"User: {user} from {ip} via {process}");
}

Display Integration

csharp

// Show connections in DataGrid
DataGrid1.DataSource = @Server.GetAllConnections();
DataGrid1.Refresh();

Connection Types

Monitoring Use Cases

Active User Count

csharp

int activeUsers = @Server.GetAllConnections().Rows.Count;
@Tag.ActiveUserCount = activeUsers;

Session Duration Check

csharp

var connections = @Server.GetAllConnections();
foreach(DataRow row in connections.Rows)
{
    TimeSpan duration = (TimeSpan)row["ConnectionTime"];
    if (duration.TotalHours > 8)
    {
        // Alert for extended session
        @Alarm.LongSession = true;
    }
}

Concurrent User Limit

csharp

public void CheckUserLimit()
{
    int maxUsers = 10;
    int current = @Server.GetAllConnections().Rows.Count;
    
    if (current >= maxUsers)
    {
        @Tag.MaxUsersReached = true;
        // Prevent new logins
    }
}

Security Auditing

Log Connections

csharp

public void LogConnections()
{
    var connections = @Server.GetAllConnections();
    
    foreach(DataRow row in connections.Rows)
    {
        @Dataset.Query.AuditLog.Insert(
            DateTime.Now,
            row["UserName"],
            row["IP"],
            row["ModuleName"],
            row["ConnectionTime"]
        );
    }
}

Detect Suspicious Activity

csharp

// Check for multiple IPs per user
var connections = @Server.GetAllConnections();
var userIPs = new Dictionary<string, List<string>>();

foreach(DataRow row in connections.Rows)
{
    string user = row["UserName"].ToString();
    string ip = row["IP"].ToString();
    
    if (!userIPs.ContainsKey(user))
        userIPs[user] = new List<string>();
    
    if (!userIPs[user].Contains(ip))
        userIPs[user].Add(ip);
}

// Alert if user from multiple locations
foreach(var kvp in userIPs)
{
    if (kvp.Value.Count > 1)
    {
        @Alarm.MultipleLocationLogin = true;
    }
}

Best Practices

1. Regular monitoring - Check connections periodically
2. Set user limits - Enforce concurrent user restrictions
3. Log sessions - Maintain audit trail
4. Monitor duration - Track extended sessions
5. Check patterns - Identify unusual access
6. Document processes - Know expected connections
7. Alert on anomalies - Detect security issues

Troubleshooting

No connections shown:

• Verify runtime is active
• Check server connectivity
• Confirm monitor permissions
• Review server status

Unknown process:

• Check third-party integrations
• Review custom modules
• Verify client types
• Document all processes

Duplicate users:

• Check AllowShareUser policy
• Review session management
• Verify logout procedures
• Monitor IP addresses

In this section...