在 .NET 中使用 Sqids 快速的為數(shù)字 ID 披上神秘短串，輕松隱藏敏感數(shù)字！
作者：大姚
本文大姚將帶領(lǐng)大家在 .NET 中使用 Sqids 快速的為數(shù)字 ID 披上神秘短串，從而輕松隱藏敏感數(shù)字，保護(hù)數(shù)據(jù)安全。
Sqids 介紹
Sqids 是一個(gè)基于 C# 編寫(xiě)、開(kāi)源的輕量級(jí)工具庫(kù)，它允許你從數(shù)字生成類(lèi)似 YouTube 的 ID。它可以將數(shù)字（如 127）編碼為字符串（如 yc3），然后你可以將這些字符串解碼回原始數(shù)字。當(dāng)你想要將數(shù)字（如順序數(shù)值 ID）混淆為看似隨機(jī)的字符串，以便在 URL 和其他地方使用時(shí)，Sqids 就非常派得上用場(chǎng)。
功能特點(diǎn)
- Sqids 生成的 ID 是唯一的，并且始終可以解碼回原始數(shù)字。
- 可以將多個(gè)數(shù)字捆綁成一個(gè) ID，然后可以將該 ID 解碼回相同的數(shù)字集。
- Sqids 生成的 ID 確保不包含常見(jiàn)的臟話，因此您可以在用戶可以看到的地方安全地使用這些 ID（例如在 URL 中）。
- .NET 7 及以上版本支持所有整數(shù)類(lèi)型（如 int、long、byte、short 等），而舊版本僅支持 int。
- 采用基于 span 的優(yōu)化實(shí)現(xiàn)，最小化內(nèi)存分配并最大化性能。
創(chuàng)建一個(gè)控制臺(tái)應(yīng)用
首先我們創(chuàng)建一個(gè)名為：SqidsExercise 的 .NET 9 控制臺(tái)應(yīng)用：
圖片
安裝 Sqids NuGet 包
在 NuGet 包管理器中搜索 Sqids 安裝：
圖片
簡(jiǎn)單使用示例
internal class Program
{
static void Main(string[] args)
{
// 使用默認(rèn)選項(xiàng)創(chuàng)建 SqidsEncoder 實(shí)例
var sqids = new SqidsEncoder<int>();
// 編碼單個(gè)數(shù)字
var id = sqids.Encode(99);
Console.WriteLine($"編碼單個(gè)數(shù)字: {id}"); // 輸出：Q8P
// 解碼單個(gè) ID
var number = sqids.Decode(id).Single();
Console.WriteLine($"解碼單個(gè) ID '{id}': {number}"); // 輸出：99
// 編碼多個(gè)數(shù)字
var ids = sqids.Encode(7, 8, 9);
Console.WriteLine($"編碼多個(gè)數(shù)字 7, 8, 9: {ids}"); // 輸出：ylrR3H
// 解碼多個(gè) ID
var numbers = sqids.Decode(ids);
Console.WriteLine($"解碼多個(gè) ID '{ids}': {string.Join(", ", numbers)}"); // 輸出：7, 8, 9
// 使用自定義選項(xiàng)創(chuàng)建 SqidsEncoder 實(shí)例
var customSqids = new SqidsEncoder<int>(new SqidsOptions
{
Alphabet = "mTHivO7hx3RAbr1f586SwjNnK2lgpcUVuG09BCtekZdJ4DYFPaWoMLQEsXIqyz",//自定義字母表（注意：字母表至少需要 3 個(gè)字符）
MinLength = 5,//最小長(zhǎng)度，默認(rèn)情況下，Sqids 使用盡可能少的字符來(lái)編碼給定的數(shù)字。但是，如果你想讓你的所有 ID 至少達(dá)到一定的長(zhǎng)度（例如，為了美觀），你可以通過(guò) MinLength 選項(xiàng)進(jìn)行配置：
BlockList = { "whatever", "else", "you", "want" } //自定義黑名單，Sqids 自帶一個(gè)大的默認(rèn)黑名單，這將確保常見(jiàn)的詛咒詞等永遠(yuǎn)不會(huì)出現(xiàn)在您的 ID 中。您可以像這樣向這個(gè)默認(rèn)黑名單添加額外項(xiàng)：
});
// 使用自定義 SqidsEncoder 編碼和解碼
var customId = customSqids.Encode(8899);
Console.WriteLine($"使用自定義 SqidsEncoder 編碼: {customId}"); // 輸出：i1uYg
var customNumber = customSqids.Decode(customId).Single();
Console.WriteLine($"使用自定義 SqidsEncoder 解碼: {customNumber}"); // 輸出：8899
}
}責(zé)任編輯：武曉燕
來(lái)源：
追逐時(shí)光者
