Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Tweak user stats display (#1387)

Leendert de Borsta45a468e359b
diff --git a/apps/server/AliasVault.Admin/Main/Models/UserUsageStatistics.cs b/apps/server/AliasVault.Admin/Main/Models/UserUsageStatistics.cs
index d56ed70d8..5141cad51 100644
--- a/apps/server/AliasVault.Admin/Main/Models/UserUsageStatistics.cs
+++ b/apps/server/AliasVault.Admin/Main/Models/UserUsageStatistics.cs
@@ -32,6 +32,12 @@ public class UserUsageStatistics
/// </summary>
public int TotalReceivedEmails { get; set; }
+ /// <summary>
+ /// Gets or sets the total number of emails received across all time (persistent counter).
+ /// This counter is never decremented, even when emails are deleted. Used for abuse detection.
+ /// </summary>
+ public int TotalEmailsReceivedPersistent { get; set; }
+
/// <summary>
/// Gets or sets the number of credentials created in the last 72 hours.
/// </summary>
diff --git a/apps/server/AliasVault.Admin/Main/Pages/Logging/Auth.razor b/apps/server/AliasVault.Admin/Main/Pages/Logging/Auth.razor
index c89405d66..6596f99d8 100644
--- a/apps/server/AliasVault.Admin/Main/Pages/Logging/Auth.razor
+++ b/apps/server/AliasVault.Admin/Main/Pages/Logging/Auth.razor
@@ -79,7 +79,16 @@ else
<SortableTableColumn>@log.Client</SortableTableColumn>
<SortableTableColumn>@log.EventType</SortableTableColumn>
<SortableTableColumn><StatusPill Enabled="log.IsSuccess" TextTrue="Success" TextFalse="@log.FailureReason.ToString()" /></SortableTableColumn>
- <SortableTableColumn>@log.IpAddress</SortableTableColumn>
+ <SortableTableColumn>
+ @if (!string.IsNullOrEmpty(log.IpAddress))
+ {
+ <a href="logging/[email protected](log.IpAddress)" class="cursor-pointer">@log.IpAddress</a>
+ }
+ else
+ {
+ <span>-</span>
+ }
+ </SortableTableColumn>
</SortableTableRow>
}
</SortableTable>
diff --git a/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/EmailClaimTable.razor b/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/EmailClaimTable.razor
index 8bc22f744..501158085 100644
--- a/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/EmailClaimTable.razor
+++ b/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/EmailClaimTable.razor
@@ -55,6 +55,12 @@ else
[Parameter]
public EventCallback<(Guid id, bool disabled)> OnEmailClaimStatusChanged { get; set; }
+ /// <summary>
+ /// Gets or sets the event callback for when the count changes.
+ /// </summary>
+ [Parameter]
+ public EventCallback OnCountChanged { get; set; }
+
/// <summary>
/// Gets or sets the list of email claims to display.
/// </summary>
@@ -132,6 +138,9 @@ else
EmailCount = emailCountDict.TryGetValue(x.Address, out var count) ? count : 0,
Disabled = x.Disabled
}).ToList();
+
+ // Notify parent that count has changed
+ await OnCountChanged.InvokeAsync();
}
private void HandleSortChanged((string column, SortDirection direction) sort)
@@ -234,4 +243,12 @@ Do you want to proceed with disabling all email claims?"))
_ => emailClaims
};
}
+
+ /// <summary>
+ /// Gets the total count of email claims (including disabled).
+ /// </summary>
+ public int GetTotalEmailClaimsCount()
+ {
+ return EmailClaimList.Count;
+ }
}
diff --git a/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/RelatedUsersTable.razor b/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/RelatedUsersTable.razor
new file mode 100644
index 000000000..533e1031c
--- /dev/null
+++ b/apps/server/AliasVault.Admin/Main/Pages/Users/View/Components/RelatedUsersTable.razor
@@ -0,0 +1,212 @@
+@using AliasVault.RazorComponents.Tables
+
+@if (IsLoading)
+{
+ <LoadingIndicator />
+}
+else if (RelatedUsers.Any())
+{
+ <SortableTable Columns="@_relatedUsersTableColumns" SortColumn="@SortColumn" SortDirection="@SortDirection" OnSortChanged="HandleSortChanged">
+ @foreach (var relatedUser in SortedRelatedUsersList)
+ {
+ <SortableTableRow>
+ <SortableTableColumn IsPrimary="true">
+ <a href="users/@relatedUser.UserId">@relatedUser.Username</a>
+ </SortableTableColumn>
+ <SortableTableColumn>@relatedUser.SharedIpAddresses.ToString("N0")</SortableTableColumn>
+ <SortableTableColumn>@relatedUser.MostRecentSharedIp</SortableTableColumn>
+ <SortableTableColumn>@relatedUser.RegistrationDate.ToString("yyyy-MM-dd HH:mm")</SortableTableColumn>
+ <SortableTableColumn><StatusPill Enabled="!relatedUser.IsBlocked" TextTrue="Active" TextFalse="Blocked" /></SortableTableColumn>
+ </SortableTableRow>
+ }
+ </SortableTable>
+
+ @if (TotalRelatedUsers > RelatedUsers.Count)
+ {
+ <div class="mt-2 text-sm text-gray-500 dark:text-gray-400">
+ Showing @RelatedUsers.Count of @TotalRelatedUsers related users (limited to top 20 by shared IP count)
+ </div>
+ }
+}
+else
+{
+ <div class="flex items-center justify-center py-8">
+ <div class="text-center">
+ <div class="text-gray-500 dark:text-gray-400">
+ <i class="fas fa-users text-4xl mb-4"></i>
+ </div>
+ <h3 class="text-lg font-medium text-gray-900 dark:text-white">No related users</h3>
+ <p class="text-sm text-gray-500 dark:text-gray-400">No other users found with shared IP addresses.</p>
+ </div>
+ </div>
+}
+
+@code {
+ /// <summary>
+ /// Gets or sets the user ID to find related users for.
+ /// </summary>
+ [Parameter]
+ public string UserId { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the event callback for when the count changes.
+ /// </summary>
+ [Parameter]
+ public EventCallback OnCountChanged { get; set; }
+
+ private List<RelatedUserInfo> RelatedUsers { get; set; } = [];
+ private int TotalRelatedUsers { get; set; } = 0;
+ private bool IsLoading { get; set; } = true;
+
+ private string SortColumn { get; set; } = "SharedIpAddresses";
+ private SortDirection SortDirection { get; set; } = SortDirection.Descending;
+
+ private readonly List<TableColumn> _relatedUsersTableColumns = [
+ new TableColumn { Title = "Username", PropertyName = "Username" },
+ new TableColumn { Title = "Shared IPs", PropertyName = "SharedIpAddresses" },
+ new TableColumn { Title = "Most Recent IP", PropertyName = "MostRecentSharedIp" },
+ new TableColumn { Title = "Registered", PropertyName = "RegistrationDate" },
+ new TableColumn { Title = "Status", PropertyName = "IsBlocked" },
+ ];
+
+ private IEnumerable<RelatedUserInfo> SortedRelatedUsersList => SortList(RelatedUsers, SortColumn, SortDirection);
+
+ /// <inheritdoc />
+ protected override async Task OnInitializedAsync()
+ {
+ IsLoading = true;
+ StateHasChanged();
+
+ await RefreshData();
+
+ IsLoading = false;
+ StateHasChanged();
+ }
+
+ /// <summary>
+ /// Refresh the related users data.
+ /// </summary>
+ private async Task RefreshData()
+ {
+ await using var dbContext = await DbContextFactory.CreateDbContextAsync();
+
+ if (string.IsNullOrEmpty(UserId))
+ {
+ RelatedUsers = [];
+ TotalRelatedUsers = 0;
+ return;
+ }
+
+ // Get distinct IP addresses from auth logs for this user (excluding fully anonymized IPs)
+ var userIpAddresses = await dbContext.AuthLogs
+ .Where(x => x.Username == dbContext.AliasVaultUsers
+ .Where(u => u.Id == UserId)
+ .Select(u => u.UserName)
+ .FirstOrDefault() && x.IpAddress != null && x.IpAddress != "xxx.xxx.xxx.xxx")
+ .Select(x => x.IpAddress!)
+ .Distinct()
+ .ToListAsync();
+
+ if (!userIpAddresses.Any())
+ {
+ RelatedUsers = [];
+ TotalRelatedUsers = 0;
+ return;
+ }
+
+ // Extract IP ranges (first 3 octets for IPv4)
+ var ipRanges = userIpAddresses
+ .Where(ip => ip.Split('.').Length == 4)
+ .Select(ip => string.Join(".", ip.Split('.').Take(3)))
+ .Distinct()
+ .ToList();
+
+ // Find other users with auth logs in the same IP ranges
+ var relatedUserData = await dbContext.AuthLogs
+ .Where(x => x.Username != null &&
+ x.IpAddress != null &&
+ x.IpAddress != "xxx.xxx.xxx.xxx" &&
+ ipRanges.Any(range => x.IpAddress.StartsWith(range)))
+ .GroupBy(x => x.Username)
+ .Select(g => new
+ {
+ Username = g.Key,
+ SharedIps = g.Select(x => x.IpAddress).Distinct().Where(ip => ip != null && userIpAddresses.Contains(ip)).Count(),
+ MostRecentSharedIp = g.Where(x => x.IpAddress != null && userIpAddresses.Contains(x.IpAddress)).OrderByDescending(x => x.Timestamp).Select(x => x.IpAddress).FirstOrDefault()
+ })
+ .Where(x => x.SharedIps > 0)
+ .ToListAsync();
+
+ // Get user details
+ var usernames = relatedUserData.Select(x => x.Username).Distinct().ToList();
+ var users = await dbContext.AliasVaultUsers
+ .Where(u => u.UserName != null && usernames.Contains(u.UserName) && u.Id != UserId)
+ .Select(u => new
+ {
+ u.Id,
+ u.UserName,
+ u.CreatedAt,
+ u.Blocked
+ })
+ .ToListAsync();
+
+ TotalRelatedUsers = users.Count;
+
+ // Combine the data
+ RelatedUsers = (from user in users
+ join data in relatedUserData on user.UserName equals data.Username
+ select new RelatedUserInfo
+ {
+ UserId = user.Id,
+ Username = user.UserName ?? "Unknown",
+ SharedIpAddresses = data.SharedIps,
+ MostRecentSharedIp = data.MostRecentSharedIp ?? "-",
+ RegistrationDate = user.CreatedAt,
+ IsBlocked = user.Blocked
+ })
+ .OrderByDescending(x => x.SharedIpAddresses)
+ .Take(20)
+ .ToList();
+
+ // Notify parent that count has changed
+ await OnCountChanged.InvokeAsync();
+ }
+
+ private void HandleSortChanged((string column, SortDirection direction) sort)
+ {
+ SortColumn = sort.column;
+ SortDirection = sort.direction;
+ StateHasChanged();
+ }
+
+ private static IEnumerable<RelatedUserInfo> SortList(List<RelatedUserInfo> relatedUsers, string sortColumn, SortDirection sortDirection)
+ {
+ return sortColumn switch
+ {
+ "Username" => SortableTable.SortListByProperty(relatedUsers, r => r.Username, sortDirection),
+ "SharedIpAddresses" => SortableTable.SortListByProperty(relatedUsers, r => r.SharedIpAddresses, sortDirection),
+ "MostRecentSharedIp" => SortableTable.SortListByProperty(relatedUsers, r => r.MostRecentSharedIp, sortDirection),
+ "RegistrationDate" => SortableTable.SortListByProperty(relatedUsers, r => r.RegistrationDate, sortDirection),
+ "IsBlocked" => SortableTable.SortListByProperty(relatedUsers, r => r.IsBlocked, sortDirection),
+ _ => relatedUsers
+ };
+ }
+
+ /// <summary>
+ /// Gets the count of related users found.
+ /// </summary>
+ public int GetRelatedUsersCount()
+ {
+ return TotalRelatedUsers;
+ }
+
+ private class RelatedUserInfo
+ {
+ public string UserId { get; set; } = string.Empty;
+ public string Username { get; set; } = string.Empty;
+ public int SharedIpAddresses { get; set; }
+ public string MostRecentSharedIp { get; set; } = string.Empty;
+ public DateTime RegistrationDate { get; set; }
+ public bool IsBlocked { get; set; }
+ }
+}
diff --git a/apps/server/AliasVault.Admin/Main/Pages/Users/View/Index.razor b/apps/server/AliasVault.Admin/Main/Pages/Users/View/Index.razor
index 06be786ff..3919f7b75 100644
--- a/apps/server/AliasVault.Admin/Main/Pages/Users/View/Index.razor
+++ b/apps/server/AliasVault.Admin/Main/Pages/Users/View/Index.razor
@@ -112,6 +112,10 @@ else
{
<div class="text-xs text-center text-green-500 dark:text-green-400">([email protected]("N0") in last 72h)</div>
}
+ @if (UserUsageStats.TotalEmailsReceivedPersistent > UserUsageStats.TotalReceivedEmails)
+ {
+ <div class="text-xs text-center text-orange-500 dark:text-orange-400" title="Persistent counter (never decremented, even when emails deleted)">(@UserUsageStats.TotalEmailsReceivedPersistent.ToString("N0") all-time)</div>
+ }
</div>
<div class="text-left">
<div class="text-xl text-center font-semibold text-gray-900 dark:text-white">@UserUsageStats.TotalEmailAttachments.ToString("N0")</div>
@@ -224,7 +228,7 @@ else
<div class="p-4 mb-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 sm:p-6 dark:bg-gray-800">
<div class="items-center">
<div>
- <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Vaults</h3>
+ <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Vaults (@VaultList.Count)</h3>
<VaultTable VaultList="@VaultList" OnMakeCurrent="@MakeCurrentAsync" />
</div>
@@ -234,7 +238,7 @@ else
<div class="p-4 mb-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 sm:p-6 dark:bg-gray-800">
<div class="items-center">
<div>
- <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Logged in devices</h3>
+ <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Logged in devices (@RefreshTokenList.Count)</h3>
<RefreshTokenTable RefreshTokenList="@RefreshTokenList" OnRevokeToken="@RevokeRefreshToken" OnRevokeAllTokens="@RevokeAllTokens" />
</div>
@@ -244,7 +248,7 @@ else
<div class="p-4 mb-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 sm:p-6 dark:bg-gray-800">
<div class="items-center">
<div>
- <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Recent authentication logs</h3>
+ <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Recent authentication logs (@AuthLogList.Count)</h3>
<p class="text-sm text-gray-500 dark:text-gray-400">
Shows the last 5 authentication attempts for this user. Click "View all auth logs" to see complete history.
</p>
@@ -256,13 +260,26 @@ else
<div class="p-4 mb-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 sm:p-6 dark:bg-gray-800">
<div class="items-center">
<div>
- <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Email claims</h3>
+ <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Related users (@RelatedUsersCount)</h3>
+ <p class="text-sm text-gray-500 dark:text-gray-400">
+ Other user accounts that have authenticated from the same IP addresses or IP ranges as this user.
+ This can help identify potential duplicate accounts or related users.
+ </p>
+ <RelatedUsersTable UserId="@Id" @ref="RelatedUsersTableRef" OnCountChanged="HandleCountChanged" />
+ </div>
+ </div>
+ </div>
+
+ <div class="p-4 mb-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 sm:p-6 dark:bg-gray-800">
+ <div class="items-center">
+ <div>
+ <h3 class="mb-1 text-xl font-bold text-gray-900 dark:text-white">Email claims (@EmailClaimsCount)</h3>
<p class="text-sm text-gray-500 dark:text-gray-400">
Email claims represent the email addresses that the user has (historically) used. Whenever a user deletes an email alias
the claim gets disabled and the server will reject all emails sent to that alias. A user can always re-enable
the claim by using it again. Email claims are permanently tied to a user and cannot be transferred to another user.
</p>
- <EmailClaimTable User="@User" />
+ <EmailClaimTable User="@User" @ref="EmailClaimTableRef" OnCountChanged="HandleCountChanged" />
</div>
</div>
</div>
@@ -290,6 +307,11 @@ else
private bool IsEditingUsername { get; set; }
private string NewUsername { get; set; } = string.Empty;
private string UsernameValidationError { get; set; } = string.Empty;
+ private RelatedUsersTable? RelatedUsersTableRef { get; set; }
+ private EmailClaimTable? EmailClaimTableRef { get; set; }
+
+ private int RelatedUsersCount => RelatedUsersTableRef?.GetRelatedUsersCount() ?? 0;
+ private int EmailClaimsCount => EmailClaimTableRef?.GetTotalEmailClaimsCount() ?? 0;
/// <inheritdoc />
protected override async Task OnInitializedAsync()
@@ -671,4 +693,12 @@ Do you want to proceed with the restoration?")) {
}
}
}
+
+ /// <summary>
+ /// Handle count changes from child components to trigger re-render.
+ /// </summary>
+ private void HandleCountChanged()
+ {
+ StateHasChanged();
+ }
}
diff --git a/apps/server/AliasVault.Admin/Services/StatisticsService.cs b/apps/server/AliasVault.Admin/Services/StatisticsService.cs
index f16b86915..5e90c8511 100644
--- a/apps/server/AliasVault.Admin/Services/StatisticsService.cs
+++ b/apps/server/AliasVault.Admin/Services/StatisticsService.cs
@@ -316,6 +316,10 @@ public class StatisticsService
.Where(e => e.EncryptionKey.UserId == userId)
.CountAsync();
+ // Get persistent emails received counter from user record (never decremented, even when emails are deleted)
+ var user = await context.AliasVaultUsers.FindAsync(userId);
+ stats.TotalEmailsReceivedPersistent = user?.EmailsReceived ?? 0;
+
// Get recent statistics (last 72 hours) - this is approximated since we don't have creation timestamps on individual credentials
// For recent credentials and email claims, we'll use vault versions created in the last 72h as a proxy
var recentVaultVersions = await context.Vaults