Sensitive Data Redaction — Log'lardan token va maxfiy ma'lumotlarni olib tashlash
Axios logging interceptorlarida nozik ma'lumotlarni (tokens, parollar, API kalitlar) rekursiv tozalash (redaction): SENSITIVE_KEYS ro'yxati, headerlarni tozalash va GDPR/PCI DSS talablari.
110-dars
Sensitive Data Redaction — Log'lardan token va maxfiy ma'lumotlarni olib tashlash
Tarmoq so'rovlarini tahlil qilish, nosozliklarni aniqlash va ilova barqarorligini kuzatish uchun so'rov va javoblarni log qilish (logging) juda muhim amaliyotdir. Dasturchilar ko'pincha Axios interceptorlari orqali har bir so'rov va javobni konsolga (console.log) yoki monitoring xizmatlariga (Sentry, Datadog, LogRocket, CloudWatch) yozib boradilar.
Biroq, agar bu loglar tozalanmasa (redaction qilinmasa), foydalanuvchilarning parollari, to'lov kartalari ma'lumotlari, shaxsiy identifikatorlari (PII) hamda eng asosiysi — avtorizatsiya tokenlari ochiq holda log bazalarida saqlanib qoladi. Bu esa xavfsizlik insidentlariga va jiddiy qonunbuzarliklarga olib keladi.
1. Nima uchun Redaction (Yashirish) shart?
Xavfsizlik xatarlari (Security Vulnerabilities)
Foydalanuvchi tizimga kirayotganda yuboradigan password, unga berilgan access_token yoki to'lov paytidagi cvv kabi qiymatlar brauzer konsolida yoki tashqi serverlarda saqlanib qolsa:
- Brauzer kengaytmalari (malicious extensions) va XSS hujumlari orqali loglardan tokenlar o'g'irlanishi mumkin.
- Monitoring tizimiga kirish huquqiga ega bo'lgan har qanday texnik xodim yoki subpudratchi foydalanuvchilarning shaxsiy ma'lumotlarini ochiq ko'ra oladi.
- Ma'lumotlar bazasi yoki loglar sizib chiqqan (data breach) holatda maxfiy kalitlar darhol tajovuzkorlar qo'liga tushadi.
Qonunchilik va Standartlar (Compliance)
- GDPR (General Data Protection Regulation): Shaxsiy ma'lumotlarni ruxsatsiz yozib olish va himoyasiz saqlashni qat'iy cheklaydi.
- PCI DSS (Payment Card Industry Data Security Standard): Kredit karta raqamlari (PAN), CVV/CVC kodlari va PIN kodlarni loglarda ochiq matn ko'rinishida saqlashni qat'iyan taqiqlaydi.
- HIPAA: Tibbiy va shaxsiy salomatlik ma'lumotlarini to'liq himoyalashni talab qiladi.
[!CAUTION] Hech qachon ishlab chiqarish (production) muhitida tozalash qatlamisiz to'g'ridan-to'g'ri
console.log(config)yokiconsole.log(response)bajarmang! HeaderlardagiAuthorizationsarlavhasi birinchi bo'lib yashirilishi shart.
2. Redaction Oqimi (Architecure Flow)
Axios orqali yuborilayotgan yoki qabul qilinayotgan ma'lumotlar log tizimiga yetib bormasdan oldin maxsus sanitizatsiya filtri orqali o'tishi kerak:
flowchart TD
A["Axios Request / Response"] --> B["Logging Interceptor"]
B --> C["Redaction Engine (redactData)"]
C --> D{"Kalit maxfiymi?<br/>(SENSITIVE_KEYS)"}
D -- "Ha" --> E["Qiymatni almashtirish: [REDACTED]"]
D -- "Yo'q" --> F["Obyekt rekursiv tekshiriladi"]
E --> G["Sanitizatsiya qilingan obyekt"]
F --> G
G --> H["Xavfsiz Konsol / Monitoring Logi (Sentry, Datadog)"]
3. Qaysi Ma'lumotlarni Yashirish Kerak?
Yashirilishi shart bo'lgan kalitlar va sarlavhalar ikki toifaga bo'linadi:
- HTTP Sarlavhalari (Headers):
authorization(Bearer tokenlar)cookievaset-cookie(sessiya identifikatorlari)x-api-key,x-auth-token,proxy-authorization
- Payload va URL Query Parametrlari:
password,oldPassword,newPassword,confirmPasswordtoken,accessToken,refreshToken,idTokensecret,clientSecret,privateKey,apiKeycardNumber,cvv,cvc,securityCode,expiryDatessn,pin,passportNumber
4. Amaliyot: TypeScript Sanitizatsiya Moduli (redact.ts)
Obyektlar va massivlar ichma-ich (nested) joylashgan bo'lishi mumkin ({ data: { user: { credentials: { password: "secret" } } } }). Shuning uchun tozalash algoritmi rekursiv bo'lishi va siklik havolalarni (circular references) xavfsiz boshqarishi lozim.
// src/shared/api/utils/redact.ts
/**
* Yashirilishi kerak bo'lgan maxfiy kalitlar ro'yxati (kichik harflarda).
*/
export const SENSITIVE_KEYS = new Set<string>([
'authorization',
'cookie',
'set-cookie',
'x-api-key',
'x-auth-token',
'password',
'oldpassword',
'newpassword',
'confirmpassword',
'token',
'accesstoken',
'refreshtoken',
'idtoken',
'secret',
'clientsecret',
'apikey',
'privatekey',
'cardnumber',
'cvv',
'cvc',
'pin',
'ssn',
]);
const MASK_VALUE = '[REDACTED]';
/**
* Obyekt, massiv yoki primitiv qiymatlarni rekursiv ravishda tozalaydi.
* Siklik bog'lanishlarni (circular reference) cheksiz siklga kirmasligi uchun WeakSet bilan himoyalaydi.
*/
export function redactData(target: unknown, seen = new WeakSet<object>()): unknown {
// Primitiv turlar va null/undefined bo'lsa o'zgartirmay qaytaramiz
if (target === null || typeof target !== 'object') {
return target;
}
// Siklik bog'lanish tekshiruvi
if (seen.has(target)) {
return '[CIRCULAR]';
}
seen.add(target);
// Massivlarni rekursiv tozalash
if (Array.isArray(target)) {
return target.map((item) => redactData(item, seen));
}
// FormData yoki Blob kabi maxsus obyektlar
if (typeof FormData !== 'undefined' && target instanceof FormData) {
return '[FormData Object]';
}
// Obyekt maydonlarini tozalash
const cleanedObject: Record<string, unknown> = {};
for (const [key, value] of Object.entries(target)) {
const normalizedKey = key.toLowerCase().replace(/[-_]/g, '');
// Kalit maxfiy ro'yxatda mavjud bo'lsa yoki qisman mos kelsa
const isSensitive =
SENSITIVE_KEYS.has(normalizedKey) ||
Array.from(SENSITIVE_KEYS).some((s) => normalizedKey.includes(s));
if (isSensitive) {
cleanedObject[key] = MASK_VALUE;
} else {
cleanedObject[key] = redactData(value, seen);
}
}
return cleanedObject;
}
/**
* HTTP Sarlavhalarini xavfsiz tozalash uchun yordamchi funksiya.
*/
export function redactHeaders(headers: unknown): Record<string, unknown> {
if (!headers || typeof headers !== 'object') {
return {};
}
const result: Record<string, unknown> = {};
for (const [headerName, headerValue] of Object.entries(headers)) {
const lowerName = headerName.toLowerCase();
if (
lowerName === 'authorization' ||
lowerName === 'cookie' ||
lowerName === 'set-cookie' ||
lowerName.includes('token') ||
lowerName.includes('key') ||
lowerName.includes('secret')
) {
result[headerName] = MASK_VALUE;
} else {
result[headerName] = headerValue;
}
}
return result;
}
[!TIP]
normalizedKeyo'zgaruvchisi orqaliaccess_token,accessTokenyokiaccess-tokenkabi turli xil nomlangan maydonlar bir xil tekshiriladi va xatoliklar ehtimoli bartaraf etiladi.
5. Logging Interceptor'ga Ulab Qo'yish
Tozalash funksiyalarini tayyorlagandan so'ng, ularni bevosita Axios logging interceptoriga ulaymiz.
// src/shared/api/interceptors/loggerInterceptor.ts
import { AxiosInstance, InternalAxiosRequestConfig, AxiosResponse, AxiosError } from 'axios';
import { redactData, redactHeaders } from '../utils/redact';
export function attachSafeLogger(instance: AxiosInstance): void {
// 1. So'rovlarni xavfsiz log qilish
instance.interceptors.request.use(
(config: InternalAxiosRequestConfig) => {
const sanitizedHeaders = redactHeaders(config.headers);
const sanitizedBody = redactData(config.data);
console.groupCollapsed(`🌐 [API Request] ${config.method?.toUpperCase()} ${config.url}`);
console.log('Safe Headers:', sanitizedHeaders);
if (sanitizedBody) {
console.log('Safe Body:', sanitizedBody);
}
console.groupEnd();
return config;
},
(error: AxiosError) => {
console.error('❌ [API Request Error]:', error.message);
return Promise.reject(error);
}
);
// 2. Javoblarni xavfsiz log qilish
instance.interceptors.response.use(
(response: AxiosResponse) => {
const sanitizedHeaders = redactHeaders(response.headers);
const sanitizedData = redactData(response.data);
console.groupCollapsed(`✅ [API Response] ${response.status} ${response.config.url}`);
console.log('Safe Headers:', sanitizedHeaders);
console.log('Safe Data:', sanitizedData);
console.groupEnd();
return response;
},
(error: AxiosError) => {
if (error.response) {
const sanitizedData = redactData(error.response.data);
console.groupCollapsed(`⚠️ [API Error] ${error.response.status} ${error.config?.url}`);
console.log('Safe Error Data:', sanitizedData);
console.groupEnd();
} else {
console.error('🚫 [Network / Timeout Error]:', error.message);
}
return Promise.reject(error);
}
);
}
6. Xom Loglar (Raw) vs Redacted Loglar
Quyidagi jadvalda tozalashdan oldingi va keyingi log holati solishtirilgan:
| Ma'lumot maydoni | Xom (Tozalanmagan) Log ⚠️ | Xavfsiz (Redacted) Log ✅ | Xavfsizlik ta'siri |
|---|---|---|---|
Authorization |
Bearer eyJhbGciOi... |
[REDACTED] |
Token o'g'irlanishining oldi olinadi |
password |
MySecretP@ssw0rd! |
[REDACTED] |
Parol sizib chiqishini to'xtatadi |
cardNumber |
4111 2222 3333 4444 |
[REDACTED] |
PCI DSS talablariga moslik |
refreshToken |
dGhpcy1pcy1hLXJl... |
[REDACTED] |
Sessiyani uzoq muddat ushlab qolish xavfini yo'qotadi |
email |
[email protected] |
[email protected] |
Ruxsat etilgan, ammo PII sifatida sozlanishi mumkin |
7. Xulosa
Axios logging tizimida Sensitive Data Redaction qo'llash quyidagi asosiy afzalliklarni beradi:
- Axborot xavfsizligi: Tokenlar, parollar va to'lov rekvizitlari brauzer konsoli yoki tashqi log tizimlariga ochiq holda chiqib ketmaydi.
- Qonuniy talablarga muvofiqlik: GDPR va PCI DSS kabi qat'iy standartlar buzilmaydi.
- Toza arxitektura:
redactDatayordamida rekursiv va siklik xavfsizlik ta'minlanadi, dasturchi esa test va nosozliklarni bemalol tekshirish imkoniyatiga ega bo'ladi.