Skip to content
KitploitKITPLOIT
أدواتعمليات الاستغلالالمدونة
Log in
إرسال
أدواتعمليات الاستغلالالمدونة
إرسال

أدوات الاختراق واختبار الاختراق والأمن السيبراني لترسانتك الأمنية!

Kitploit هو دليل لأدوات الاختراق والأمن السيبراني واختبار الاختراق. اكتشف آخر تحديثات المشاريع للعثور على الثغرات وتحليل الأنظمة وأتمتة الاختبارات وتعزيز أمنك.

الخلاصاتاتصالالخصوصية© 2026 Kitploit

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
trufflehog — البحث عن بيانات الاعتماد المسربة والتحقق منها وتحليلها | Kitploit
أدوات/GitHubGitHub/trufflesecurity/trufflehog
ماسحات الثغرات الأمنيةالتحليل الديناميكي (عزل)تحليل الكودأمن السحابةDevSecOpsكشف الأسراراستخبارات التهديداتأمن سلسلة التوريدالاستجابة للحوادثالأفضل في DevSecOps #4
27.4k2.5k302منذ يوم واحدتمت المراجعة من قبل Kitploit
الأفضل في كشف الأسرار #2
الأفضل في أمن سلسلة التوريد #19
GitHubtrufflesecurity/trufflehog

trufflehog

البحث عن بيانات الاعتماد المسربة والتحقق منها وتحليلها

عرض المستودعالموقع الإلكتروني

الأكثر شعبية

عرض الكل →

اكتشف الأدوات الأكثر استخدامًا من قبل مجتمعنا.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 مجموعة أدوات OSINT المثالية: رسم بياني للتحقيق، وتقييم الثقة، وعائلات الأسماء المستعارة، وخريطة، وخط زمني، وتقارير. 49 وحدة، وأكثر من 400 موقع، دون الحاجة إلى مفاتيح API.

    1.0k
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # تطبيق GhostLock للتنفيذ بنقرة واحدة (CVE-2026-43499)

    645
  • 3

    looking-glass

    anonghosty/looking-glass

    منصة CSIRT تستقبل تقارير Shadowserver في MongoDB وتعيد عرضها كخرائط تفاعلية وتحليلات ونتائج وإرشادات ولوحات معلومات تنفيذية.

    420
  • 4

    jumpserver

    jumpserver/jumpserver

    JumpServer هي منصة مفتوحة المصدر لإدارة الامتيازات (PAM) توفر لفرق DevOps وتكنولوجيا المعلومات وصولًا آمنًا عند الطلب إلى نقاط نهاية SSH وRDP وKubernetes وقواعد البيانات وRemoteApp عبر متصفح الويب.

    388
  • 5

    ARTEX

    baarai/artex

    منصة اختبار اختراق مستقلة متعددة الوكلاء تعتمد على LLM، مع وكلاء تخطيط وتنفيذ، ومخططات للأصول والاستكشاف، وتسجيل حركة مرور MITM، وإعادة اختبار الثغرات.

    330
  • 6

    SafeLine

    chaitin/safeline

    WAF مستضافة ذاتيًا ووكيل عكسي يقوم بتصفية حركة المرور HTTP الضارة، ويمنع هجمات SQL injection و XSS وهجمات البوت، مع تحديد معدل الطلبات وتشفير HTML/JS الديناميكي.

    328

استكشف جميع الأدوات

تصفح مجموعتنا من الأدوات

عرض جميع الأدوات →
مشاركة
<p align="center">
  <img alt="GoReleaser Logo" src="https://assets.kitploit.com/production/public/readmes/3815/31dbdb577b88b3a967e2c18f9b0f3d4a7031dafe7e392c51320178aba6352603.png" height="140" />
  <h2 align="center">TruffleHog</h2>
  <p align="center">اكتشف بيانات الاعتماد المسربة.</p>
</p>

---

<div align="center">

[![Go Report Card](https://goreportcard.com/badge/github.com/trufflesecurity/trufflehog/v3)](https://goreportcard.com/report/github.com/trufflesecurity/trufflehog/v3)
[![License](https://img.shields.io/badge/license-AGPL--3.0-brightgreen)](/LICENSE)
[![Total Detectors](https://img.shields.io/github/directory-file-count/trufflesecurity/truffleHog/pkg/detectors?label=Total%20Detectors&type=dir)](/pkg/detectors)

</div>

---

# :mag_right: _الفحص الآن_

<div align="center">

<img src="https://raw.githubusercontent.com/trufflesecurity/trufflehog/HEAD/assets/scanning_logos.svg">

**...والمزيد**

لمعرفة المزيد عن TruffleHog وميزاته وقدراته، قم بزيارة [صفحة المنتج](https://trufflesecurity.com/trufflehog?gclid=CjwKCAjwouexBhAuEiwAtW_Zx5IW87JNj97Ci7heFnA5ar6-DuNzT2Y5nIl9DuZ-FOUqx0Qg3vb9nxoClcEQAvD_BwE).

</div>

# :globe_with_meridians: TruffleHog Enterprise

هل أنت مهتم بالمراقبة المستمرة لـ **Git وJira وSlack وConfluence وMicrosoft Teams وSharepoint (والمزيد)** بحثًا عن بيانات الاعتماد؟ لدينا منتج للمؤسسات يمكنه مساعدتك! اعرف المزيد على <https://trufflesecurity.com/trufflehog-enterprise>.

نستخدم الإيرادات من منتج المؤسسات لتمويل المزيد من المشاريع مفتوحة المصدر الرائعة التي يمكن للمجتمع بأكمله الاستفادة منها.

</div>

# ما هو TruffleHog 🐽

TruffleHog هو أقوى أداة لـ **اكتشاف** و**تصنيف** و**تحقق** و**تحليل** الأسرار. في هذا السياق، يشير مصطلح "سر" إلى بيانات اعتماد تستخدمها آلة لمصادقة نفسها أمام آلة أخرى. ويشمل ذلك مفاتيح API وكلمات مرور قواعد البيانات ومفاتيح التشفير الخاصة والمزيد.

## الاكتشاف 🔍

يمكن لـ TruffleHog البحث عن الأسرار في أماكن كثيرة، بما في ذلك Git والدردشات والويكي والسجلات ومنصات اختبار API ومخازن الكائنات وأنظمة الملفات والمزيد.

## التصنيف 📁

يصنّف TruffleHog أكثر من 800 نوع من الأسرار، ويربطها بالهوية المحددة التي تنتمي إليها. هل هو سر AWS؟ سر Stripe؟ سر Cloudflare؟ كلمة مرور Postgres؟ مفتاح SSL خاص؟ أحيانًا يكون من الصعب معرفة ذلك بالنظر إليه، لذلك يصنّف TruffleHog كل ما يجده.

## التحقق ✅

لكل سر يمكن لـ TruffleHog تصنيفه، يمكنه أيضًا تسجيل الدخول للتأكد مما إذا كان ذلك السر نشطًا أم لا. هذه الخطوة بالغة الأهمية لمعرفة ما إذا كان هناك خطر نشط حاضر أم لا.

## التحليل 🔬

بالنسبة لنحو 20 من أنواع بيانات الاعتماد الأكثر تسريبًا شيوعًا، بدلاً من إرسال طلب واحد للتحقق مما إذا كان السر يمكنه تسجيل الدخول، يمكن لـ TruffleHog إرسال طلبات كثيرة لمعرفة كل ما يمكن معرفته عن السر. من أنشأه؟ ما الموارد التي يمكنه الوصول إليها؟ ما الأذونات التي يمتلكها على تلك الموارد؟

# :loudspeaker: انضم إلى مجتمعنا

هل لديك أسئلة؟ ملاحظات؟ انضم إلى Slack أو Discord وتواصل معنا.

انضم إلى [مجتمع Slack](https://join.slack.com/t/trufflehog-community/shared_invite/zt-pw2qbi43-Aa86hkiimstfdKH9UCpPzQ)

انضم إلى [Secret Scanning Discord](https://discord.gg/8Hzbrnkr7E)

# :tv: عرض توضيحي

![GitHub scanning demo](https://storage.googleapis.com/truffle-demos/non-interactive.svg)

```bash
docker run --rm -it -v "$PWD:/pwd" trufflesecurity/trufflehog:latest github --org=trufflesecurity
```

# :floppy_disk: التثبيت

تتوفر عدة خيارات أمامك:

### مستخدمو MacOS

```bash
brew install trufflehog
```

### Docker:

<sub><i>_تأكد من تشغيل محرك Docker قبل تنفيذ الأوامر التالية:_</i></sub>

#### &nbsp;&nbsp;&nbsp;&nbsp;Unix

```bash
docker run --rm -it -v "$PWD:/pwd" trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
```

#### &nbsp;&nbsp;&nbsp;&nbsp;موجه أوامر Windows

```bash
docker run --rm -it -v "%cd:/=\%:/pwd" trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
```

#### &nbsp;&nbsp;&nbsp;&nbsp;Windows PowerShell

```bash
docker run --rm -it -v "${PWD}:/pwd" trufflesecurity/trufflehog github --repo https://github.com/trufflesecurity/test_keys
```

#### &nbsp;&nbsp;&nbsp;&nbsp;أجهزة Mac من نوع M1 وM2

```bash
docker run --platform linux/arm64 --rm -it -v "$PWD:/pwd" trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
```

### إصدارات ثنائية

```bash
Download and unpack from https://github.com/trufflesecurity/trufflehog/releases
```

### الترجمة من المصدر

```bash
git clone https://github.com/trufflesecurity/trufflehog.git
cd trufflehog; go install
```

### استخدام سكربت التثبيت

```bash
curl -sSfL https://raw.githubusercontent.com/trufflesecurity/trufflehog/main/scripts/install.sh | sh -s -- -b /usr/local/bin
```

### استخدام سكربت التثبيت، والتحقق من توقيع المجموع الاختباري (يتطلب تثبيت cosign)

```bash
curl -sSfL https://raw.githubusercontent.com/trufflesecurity/trufflehog/main/scripts/install.sh | sh -s -- -v -b /usr/local/bin
```

### استخدام سكربت التثبيت لتثبيت إصدار محدد

```bash
curl -sSfL https://raw.githubusercontent.com/trufflesecurity/trufflehog/main/scripts/install.sh | sh -s -- -b /usr/local/bin <ReleaseTag like v3.56.0>
```

# :closed_lock_with_key: التحقق من الملفات الناتجة

تُطبَّق المجاميع الاختبارية (checksums) على جميع الملفات الناتجة، ويُوقَّع ملف المجاميع الاختبارية الناتج باستخدام cosign.

تحتاج إلى الأداة التالية للتحقق من التوقيع:

- [Cosign](https://docs.sigstore.dev/cosign/system_config/installation/)

خطوات التحقق كما يلي:

1. نزّل ملفات المخرجات التي تريدها، والملفات التالية من صفحة [releases](https://github.com/trufflesecurity/trufflehog/releases).

   - trufflehog\_{version}\_checksums.txt
   - trufflehog\_{version}\_checksums.txt.pem
   - trufflehog\_{version}\_checksums.txt.sig

2. تحقق من التوقيع:

   ```shell
   cosign verify-blob <path to trufflehog_{version}_checksums.txt> \
   --certificate <path to trufflehog_{version}_checksums.txt.pem> \
   --signature <path to trufflehog_{version}_checksums.txt.sig> \
   --certificate-identity-regexp 'https://github\.com/trufflesecurity/trufflehog/\.github/workflows/.+' \
   --certificate-oidc-issuer "https://token.actions.githubusercontent.com"
   ```

3. بمجرد التأكد من صحة التوقيع، يمكنك المتابعة للتحقق من تطابق مجاميع SHA256 مع الملف التنفيذي الذي تم تنزيله:

   ```shell
   sha256sum --ignore-missing -c trufflehog_{version}_checksums.txt
   ```

استبدل `{version}` بإصدار الملفات التي تم تنزيلها

بدلاً من ذلك، إذا كنت تستخدم سكربت التثبيت، فمرّر الخيار `-v` لإجراء التحقق من التوقيع.
يتطلب ذلك تثبيت ثنائي Cosign قبل تشغيل سكربت التثبيت.

# :rocket: البدء السريع

## 1: فحص مستودع بحثًا عن الأسرار المُتحقَّق منها فقط

الأمر:

```bash
trufflehog git https://github.com/trufflesecurity/test_keys --results=verified
```

لا يوجد محتوى نصي في هذه الرسالة لترجمته. يبدو أنك أرسلت تعليمات الترجمة فقط دون النص المصدر (الجزء 29 من 110).

يرجى إرسال محتوى Markdown الفعلي الذي تريد ترجمته، وسأقوم بترجمته إلى العربية مع الالتزام بجميع القواعد المحددة.

```
🐷🔑🐷  TruffleHog. Unearth your secrets. 🐷🔑🐷

Found verified result 🐷🔑
Detector Type: AWS
Decoder Type: PLAIN
Raw result: AKIAYVP4CIPPERUVIFXG
Line: 4
Commit: fbc14303ffbf8fb1c2c1914e8dda7d0121633aca
File: keys
Email: counter <[email protected]>
Repository: https://github.com/trufflesecurity/test_keys
Timestamp: 2022-06-16 10:17:40 -0700 PDT
...
```

## 2: فحص مؤسسة GitHub بحثًا عن الأسرار المُتحقَّق منها فقط

```bash
trufflehog github --org=trufflesecurity --results=verified
```

## 3: فحص مؤسسة GitHub مع استبعاد المستودعات المؤرشفة

```bash
trufflehog github --org=trufflesecurity --exclude-archived
```

## 4: فحص مستودع GitHub بحثًا عن الأسرار المُتحقَّق منها فقط والحصول على مخرجات JSON

الأمر:

```bash
trufflehog git https://github.com/trufflesecurity/test_keys --results=verified --json
```

لا يوجد محتوى نصي في هذه الرسالة لترجمته. يبدو أنك أرسلت تعليمات الترجمة فقط دون النص المصدر (الجزء 29 من 110).

يرجى إرسال محتوى Markdown الفعلي الذي تريد ترجمته، وسأقوم بترجمته إلى العربية مع الالتزام بجميع القواعد المحددة.

```
{"SourceMetadata":{"Data":{"Git":{"commit":"fbc14303ffbf8fb1c2c1914e8dda7d0121633aca","file":"keys","email":"counter \[email protected]\u003e","repository":"https://github.com/trufflesecurity/test_keys","timestamp":"2022-06-16 10:17:40 -0700 PDT","line":4}}},"SourceID":0,"SourceType":16,"SourceName":"trufflehog - git","DetectorType":2,"DetectorName":"AWS","DecoderName":"PLAIN","Verified":true,"Raw":"AKIAYVP4CIPPERUVIFXG","Redacted":"AKIAYVP4CIPPERUVIFXG","ExtraData":{"account":"595918472158","arn":"arn:aws:iam::595918472158:user/canarytokens.com@@mirux23ppyky6hx3l6vclmhnj","user_id":"AIDAYVP4CIPPJ5M54LRCY"},"StructuredData":null}
...
```

يمكن لـ TruffleHog أيضًا إخراج [SARIF](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) باستخدام `--sarif` بدلاً من `--json`. يفهم فحص الشيفرة في GitHub صيغة SARIF أصلاً، لذا فإن رفعها يُظهر النتائج مباشرةً على فروقات طلبات السحب وفي علامة تبويب الأمان الخاصة بالمستودع، ويتتبع النتائج على أنها جديدة/مُصلحة عبر عمليات الفحص بدلاً من الإبلاغ عن النتيجة نفسها في كل تشغيل — راجع قسم [TruffleHog Github Action](#octocat-trufflehog-github-action) أدناه لمعرفة كيفية رفعها. لاحظ أنه، على عكس صيغ الإخراج الأخرى، تُخزَّن نتائج SARIF في الذاكرة طوال الفحص الكامل وتُكتب في النهاية، لأن SARIF يتطلب مستند JSON واحدًا بدلاً من تدفق — وهذا مناسب للفحوصات النموذجية، لكن الفحوصات التي تنتج عددًا كبيرًا جدًا من النتائج ستستهلك ذاكرة أكبر بشكل متناسب.

## 5: فحص مستودع GitHub + مشكلاته وطلبات السحب الخاصة به

```bash
trufflehog github --repo=https://github.com/trufflesecurity/test_keys --issue-comments --pr-comments
```

## 6: فحص دلو S3 للحصول على نتائج عالية الثقة (مُتحقَّق منها + غير معروفة)

```bash
trufflehog s3 --bucket=<bucket name> --results=verified,unknown
```

## 7: فحص حزم S3 باستخدام أدوار IAM

```bash
trufflehog s3 --role-arn=<iam role arn>
```

## 8: فحص مستودع GitHub باستخدام مصادقة SSH في Docker

```bash
docker run --rm -v "$HOME/.ssh:/root/.ssh:ro" trufflesecurity/trufflehog:latest git ssh://github.com/trufflesecurity/test_keys
```

## 9: فحص الملفات أو الدلائل الفردية

```bash
trufflehog filesystem path/to/file1.txt path/to/file2.txt path/to/dir
```

## 10: فحص مستودع git محلي

استنسخ مستودع git. على سبيل المثال مستودع [مفاتيح الاختبار](https://github.com/trufflesecurity/trufflehog/blob/main/git%40github.com%3Atrufflesecurity/test_keys.git).
```bash
git clone [email protected]:trufflesecurity/test_keys.git
```

شغّل trufflehog من الدليل الأصلي (خارج مستودع git).
```bash
trufflehog git file://test_keys --results=verified,unknown
```

للحماية من إعدادات git الخبيثة في الفحص المحلي (انظر CVE-2025-41390)، يقوم TruffleHog باستنساخ مستودعات git المحلية إلى دليل مؤقت قبل الفحص. يتبع هذا [أفضل ممارسات الأمان في Git](https://git-scm.com/docs/git#_security). إذا كنت تريد تحديد مسار مخصص لاستنساخ المستودع إليه (بدلاً من tmp)، يمكنك استخدام العلامة `--clone-path`. إذا كنت ترغب في تخطي عملية الاستنساخ المحلي وفحص المستودع مباشرةً (افعل هذا فقط للمستودعات الموثوقة)، يمكنك استخدام العلامة `--trust-local-git-config`.

## 11: فحص حزم GCS بحثًا عن الأسرار المُتحقَّق منها فقط

```bash
trufflehog gcs --project-id=<project-ID> --cloud-environment --results=verified
```

## 12: فحص صورة Docker بحثًا عن الأسرار المُتحقَّق منها فقط

استخدم العلامة `--image` عدة مرات لفحص صور متعددة.

```bash
# to scan from a remote registry
trufflehog docker --image trufflesecurity/secrets --results=verified

# to scan from the local docker daemon
trufflehog docker --image docker://new_image:tag --results=verified

# to scan from an image saved as a tarball
trufflehog docker --image file://path_to_image.tar --results=verified
```

## 13: الفحص في CI

اضبط علامة `--since-commit` على فرعك الافتراضي الذي يدمج فيه الأشخاص (مثل: "main"). اضبط علامة `--branch` على اسم فرع طلب السحب (PR) الخاص بك (مثل: "feature-1"). اعتمادًا على منصة CI/CD التي تستخدمها، يمكن سحب هذه القيمة ديناميكيًا (مثل: [CIRCLE_BRANCH في Circle CI](https://circleci.com/docs/variables/) و[TRAVIS_PULL_REQUEST_BRANCH في Travis CI](https://docs.travis-ci.com/user/environment-variables/)). إذا تم استنساخ المستودع وكان الفرع الهدف مُسحوبًا بالفعل أثناء سير عمل CI/CD، فإن `--branch HEAD` يجب أن يكون كافيًا. ستُرجع علامة `--fail` رمز خطأ 183 إذا تم العثور على بيانات اعتماد صالحة.

```bash
trufflehog git file://. --since-commit main --branch feature-1 --results=verified,unknown --fail
```

## 14: فحص مساحة عمل Postman

استخدم علامات `--workspace-id` و`--collection-id` و`--environment` عدة مرات لفحص أهداف متعددة.

```bash
trufflehog postman --token=<postman api token> --workspace-id=<workspace id>
```

## 15: فحص خادم Jenkins

```bash
trufflehog jenkins --url https://jenkins.example.com --username admin --password admin
```

## 16: فحص خادم Elasticsearch

### فحص عنقود محلي

هناك طريقتان للمصادقة على عنقود محلي باستخدام TruffleHog: (1) اسم المستخدم وكلمة المرور، (2) رمز الخدمة.

#### الاتصال بعنقود محلي باستخدام اسم المستخدم وكلمة المرور

```bash
trufflehog elasticsearch --nodes 192.168.14.3 192.168.14.4 --username truffle --password hog
```

#### الاتصال بعنقود محلي باستخدام رمز خدمة

```bash
trufflehog elasticsearch --nodes 192.168.14.3 192.168.14.4 --service-token ‘AAEWVaWM...Rva2VuaSDZ’
```

### فحص عنقود Elastic Cloud

لفحص عنقود على Elastic Cloud، ستحتاج إلى Cloud ID ومفتاح API.

```bash
trufflehog elasticsearch \
  --cloud-id 'search-prod:dXMtY2Vx...YjM1ODNlOWFiZGRlNjI0NA==' \
  --api-key 'MlVtVjBZ...ZSYlduYnF1djh3NG5FQQ=='
```

## 17. فحص مستودع GitHub بحثًا عن مراجع الكائنات عبر التفرعات (Cross Fork Object References) والالتزامات المحذوفة

سيقوم الأمر التالي بإحصاء الالتزامات المحذوفة والمخفية في مستودع GitHub ثم فحصها بحثًا عن الأسرار. هذه ميزة إصدار ألفا.

```bash
trufflehog github-experimental --repo https://github.com/<USER>/<REPO>.git --object-discovery
```

بالإضافة إلى مخرجات TruffleHog العادية، تُنشئ العلامة `--object-discovery` ملفين في دليل جديد `$HOME/.trufflehog`: `valid_hidden.txt` و`invalid.txt`. تُستخدم هذه الملفات لتتبع الحالة أثناء تعداد الـ commits، وكذلك لتزويد المستخدمين بقائمة كاملة بجميع الـ commits المخفية والمحذوفة (`valid_hidden.txt`). إذا كنت ترغب في إزالة هذه الملفات تلقائيًا بعد الفحص، يُرجى إضافة العلامة `--delete-cached-data`.

**ملاحظة**: يستغرق تعداد جميع الـ commits الصالحة على مستودع باستخدام هذه الطريقة ما بين 20 دقيقة وبضع ساعات، اعتمادًا على حجم مستودعك. أضفنا شريط تقدم لإبقائك على اطلاع بمدة التعداد. أما الفحص الفعلي للأسرار فيجري بسرعة فائقة.

لمزيد من المعلومات حول Cross Fork Object References، يُرجى [قراءة منشور مدونتنا](https://trufflesecurity.com/blog/anyone-can-access-deleted-and-private-repo-data-github).

## 18. فحص Hugging Face

### فحص نموذج أو مجموعة بيانات أو مساحة أو حاوية على Hugging Face

```bash
trufflehog huggingface \
    --model <model_id> \
    --dataset <dataset_id> \
    --space <space_id> \
    --bucket <bucket_id>
```

### فحص جميع النماذج ومجموعات البيانات والمساحات والحزم (Buckets) التابعة لمنظمة أو مستخدم على Hugging Face

```bash
trufflehog huggingface --org <orgname> --user <username>
```

(اختياريًا) عند فحص مؤسسة أو مستخدم، يمكنك تخطي فئة كاملة من الموارد باستخدام `--skip-all-models`، أو `--skip-all-datasets`، أو `--skip-all-spaces`، أو `--skip-all-buckets` أو تخطي مورد معين باستخدام `--ignore-models <model_id>`، أو `--ignore-datasets <dataset_id>`، أو `--ignore-spaces <space_id>`، أو `--ignore-buckets <bucket_id>`.

### فحص تعليقات المناقشات وطلبات السحب

```bash
trufflehog huggingface --model <model_id> --include-discussions --include-prs
```

## 19. فحص مدخلات stdin

```bash
aws s3 cp s3://example/gzipped/data.gz - | gunzip -c | trufflehog stdin
```

# :question: الأسئلة الشائعة

- كل ما أراه هو `🐷🔑🐷  TruffleHog. Unearth your secrets. 🐷🔑🐷` والبرنامج ينتهي، ما السبب؟
  - هذا يعني أنه لم يتم اكتشاف أي أسرار
- لماذا يستغرق الفحص وقتًا طويلاً عندما أفحص مؤسسة على GitHub
  - عمليات فحص GitHub غير المصادق عليها لها حدود معدل. لتحسين حدود المعدل لديك، أضف علامة `--token` مع رمز وصول شخصي
- تقول الرسالة أنه تم التحقق من مفتاح خاص، ماذا يعني ذلك؟
  - النتيجة المتحقق منها تعني أن TruffleHog أكد صلاحية بيانات الاعتماد عن طريق اختبارها مقابل واجهة برمجة تطبيقات الخدمة. بالنسبة للمفاتيح الخاصة، أكدنا أنه يمكن استخدام المفتاح مباشرةً لمصادقة SSH أو SSL. راجع منشور مدونة Driftwood لمعرفة المزيد [منشور المدونة](https://trufflesecurity.com/blog/driftwood-know-if-private-keys-are-sensitive/)
- هل هناك طريقة سهلة لتجاهل أسرار محددة؟
  - إذا كان المصدر المفحوص [يدعم أرقام الأسطر](https://github.com/trufflesecurity/trufflehog/blob/d6375ba92172fd830abb4247cca15e3176448c5d/pkg/engine/engine.go#L358-L365)، فيمكنك إضافة تعليق `trufflehog:ignore` على السطر الذي يحتوي على السر لتجاهل ذلك السر.
- هل يمكنني العثور على الأسرار التي تتضمن `trufflehog:ignore`؟
  - مرر `--no-ignore-tag` للإبلاغ عن النتائج حتى عندما يحمل سطرها تعليق `trufflehog:ignore`. هذا مفيد لمراجعة النتائج المقبولة سابقًا.

# :newspaper: ما الجديد في الإصدار v3؟

TruffleHog v3 هو إعادة كتابة كاملة بلغة Go مع العديد من الميزات القوية الجديدة.

- **أضفنا أكثر من 700 كاشف لبيانات الاعتماد يدعم التحقق النشط مقابل واجهات برمجة التطبيقات الخاصة بها**.
- أضفنا أيضًا **دعمًا أصليًا لفحص GitHub وGitLab وDocker وأنظمة الملفات وS3 وGCS وCircle CI وTravis CI**.
- **تحقق فوري من المفاتيح الخاصة** مقابل ملايين مستخدمي GitHub و**مليارات** شهادات TLS باستخدام تقنية [Driftwood](https://trufflesecurity.com/blog/driftwood) الخاصة بنا.
- فحص الملفات الثنائية والمستندات وتنسيقات الملفات الأخرى
- متاح كإجراء GitHub وخطاف pre-commit

## ما هو التحقق من بيانات الاعتماد؟

لكل بيانات اعتماد محتملة يتم اكتشافها، قمنا بتنفيذ التحقق البرمجي بعناية مقابل واجهة برمجة التطبيقات التي نعتقد أنها تنتمي إليها. يزيل التحقق الإيجابيات الكاذبة ويوفر ثلاث حالات للنتيجة:

- **verified**: تم تأكيد بيانات الاعتماد كصالحة ونشطة بواسطة اختبار واجهة برمجة التطبيقات
- **unverified**: تم اكتشاف بيانات الاعتماد ولكن لم يتم تأكيد صلاحيتها (قد تكون غير صالحة أو منتهية الصلاحية أو تم تعطيل التحقق)
- **unknown**: تمت محاولة التحقق ولكنها فشلت بسبب أخطاء، مثل فشل الشبكة أو واجهة برمجة التطبيقات

على سبيل المثال، يقوم [كاشف بيانات اعتماد AWS](https://github.com/trufflesecurity/trufflehog/blob/main/pkg/detectors/aws/access_keys/accesskey.go) بإجراء استدعاء واجهة برمجة التطبيقات `GetCallerIdentity` مقابل واجهة برمجة تطبيقات AWS للتحقق مما إذا كانت بيانات اعتماد AWS نشطة.

# :memo: الاستخدام

لدى TruffleHog أمر فرعي لكل مصدر بيانات قد ترغب في فحصه:

- git
- github
- gitlab
- huggingface
- docker
- s3
- filesystem (الملفات والمجلدات)
- syslog
- circleci
- travisci
- gcs (Google Cloud Storage)
- postman
- jenkins
- elasticsearch
- stdin
- multi-scan

يمكن أن يكون لكل أمر فرعي خيارات يمكنك رؤيتها باستخدام علامة `--help` المقدمة للأمر الفرعي:

```
$ trufflehog git --help
usage: TruffleHog [<flags>] <command> [<args> ...]

TruffleHog is a tool for finding credentials.


Flags:
  -h, --[no-]help                Show context-sensitive help (also try --help-long and --help-man).
      --log-level=0              Logging verbosity on a scale of 0 (info) to 5 (trace). Can be
                                 disabled with "-1".
      --[no-]profile             Enables profiling and sets a pprof and fgprof server on :18066.
  -j, --[no-]json                Output in JSON format.
      --[no-]json-legacy         Use the pre-v3.0 JSON format. Only works with git, gitlab,
                                 and github sources.
      --[no-]github-actions      Output in GitHub Actions format.
      --[no-]sarif               Output in SARIF format for upload to GitHub code scanning (e.g.
                                 via github/codeql-action/upload-sarif).
      --concurrency=12           Number of concurrent workers.
      --[no-]no-verification     Don't verify the results.
      --results=RESULTS          Specifies which type(s) of results to output: verified (confirmed
                                 valid by API), unknown (verification failed due to error),
                                 unverified (detected but not verified), filtered_unverified
                                 (unverified but would have been filtered out). Defaults to
                                 verified,unverified,unknown.
      --[no-]no-color            Disable colorized output
      --[no-]allow-verification-overlap
                                 Allow verification of similar credentials across detectors
      --[no-]filter-unverified   Only output first unverified result per chunk per detector if there
                                 are more than one results.
      --filter-entropy=FILTER-ENTROPY
                                 Filter unverified results with Shannon entropy. Start with 3.0.
      --config=CONFIG            Path to configuration file.
      --[no-]print-avg-detector-time
                                 Print the average time spent on each detector.
      --[no-]no-update           Don't check for updates.
      --[no-]fail                Exit with code 183 if results are found.
      --[no-]fail-on-scan-errors
                                 Exit with non-zero error code if an error occurs during the scan.
      --verifier=VERIFIER ...    Set custom verification endpoints.
      --[no-]custom-verifiers-only
                                 Only use custom verification endpoints.
      --detector-timeout=DETECTOR-TIMEOUT
                                 Maximum time to spend scanning chunks per detector (e.g., 30s).
      --archive-max-size=ARCHIVE-MAX-SIZE
                                 Maximum size of archive to scan. (Byte units eg. 512B, 2KB, 4MB)
      --archive-max-depth=ARCHIVE-MAX-DEPTH
                                 Maximum depth of archive to scan.
      --archive-timeout=ARCHIVE-TIMEOUT
                                 Maximum time to spend extracting an archive.
      --include-detectors="all"  Comma separated list of detector types to include. Protobuf name or
                                 IDs may be used, as well as ranges.
      --exclude-detectors=EXCLUDE-DETECTORS
                                 Comma separated list of detector types to exclude. Protobuf name
                                 or IDs may be used, as well as ranges. IDs defined here take
                                 precedence over the include list.
      --[no-]no-verification-cache
                                 Disable verification caching
      --[no-]force-skip-binaries
                                 Force skipping binaries.
      --[no-]force-skip-archives
                                 Force skipping archives.
      --[no-]skip-additional-refs
                                 Skip additional references.
      --user-agent-suffix=USER-AGENT-SUFFIX
                                 Suffix to add to User-Agent.
      --[no-]version             Show application version.

Commands:
help [<command>...]
    Show help.

git [<flags>] <uri>

    Find credentials in git repositories.

github [<flags>]
    Find credentials in GitHub repositories.

github-experimental --repo=REPO [<flags>]
    Run an experimental GitHub scan. Must specify at least one experimental sub-module to run:
    object-discovery.

gitlab --token=TOKEN [<flags>]
    Find credentials in GitLab repositories.

filesystem [<flags>] [<path>...]
    Find credentials in a filesystem.

s3 [<flags>]
    Find credentials in S3 buckets.

gcs [<flags>]
    Find credentials in GCS buckets.

syslog --format=FORMAT [<flags>]
    Scan syslog

circleci --token=TOKEN
    Scan CircleCI

docker [<flags>]
    Scan Docker Image


travisci --token=TOKEN
    Scan TravisCI

postman [<flags>]
    Scan Postman

elasticsearch [<flags>]
    Scan Elasticsearch

jenkins --url=URL [<flags>]
    Scan Jenkins

huggingface [<flags>]
    Find credentials in HuggingFace datasets, models, spaces and buckets.

stdin
    Find credentials from stdin.

multi-scan
    Find credentials in multiple sources defined in configuration.

json-enumerator [<path>...]
    Find credentials from a JSON enumerator input.

analyze
    Analyze API keys for fine-grained permissions information.
```

على سبيل المثال، لفحص مستودع `git`، ابدأ بـ

```
trufflehog git https://github.com/trufflesecurity/trufflehog.git
```

## الإعدادات

يدعم TruffleHog تعريف [كاشفات regex المخصصة](#custom-regex-detector-alpha)
ومصادر متعددة في ملف إعدادات يُقدَّم عبر العلامة `--config`.
يمكن استخدام كاشفات regex مع أي أمر فرعي، بينما المصادر المعرَّفة
في الإعدادات مخصصة فقط للأمر الفرعي `multi-scan`.

يمكن العثور على صيغة إعدادات المصادر في
[صفحة توثيق إعدادات المصادر](https://trufflesecurity.com/docs/connect-sources) الخاصة بـ Truffle Security.

مثال على إعدادات مصدر GitHub و[مرجع الخيارات](https://docs.trufflesecurity.com/github#Fvm1I):

```yaml
sources:
- connection:
    '@type': type.googleapis.com/sources.GitHub
    repositories:
    - https://github.com/trufflesecurity/test_keys.git
    unauthenticated: {}
  name: example config scan
  type: SOURCE_TYPE_GITHUB
  verify: true
```

يمكنك تعريف عدة اتصالات تحت المفتاح `sources` (انظر أعلاه)، وسيقوم TruffleHog بفحص جميع المصادر بشكل متزامن.

لعرض سجلات التصحيح لمصدر واحد فقط، أضف `debug: true` إليه. يكتب ذلك المصدر جميع سجلات التصحيح الخاصة به، بينما يحتفظ كل مصدر آخر بمستوى السجل العادي. هذا مفيد عندما يسيء أحد المصادر من بين العديد من المصادر التصرف:

```yaml
sources:
- connection:
    '@type': type.googleapis.com/sources.GitHub
    repositories:
    - https://github.com/trufflesecurity/test_keys.git
    unauthenticated: {}
  name: example config scan
  type: SOURCE_TYPE_GITHUB
  debug: true
```

لتفعيل سجلات التصحيح لكل مصدر، استخدم `--log-level=5` بدلاً من ذلك.

## S3

---

[Read more](https://github.com/trufflesecurity/trufflehog)
تنزيل الأداة