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

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

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

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

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
libsignal — موطن بروتوكول Signal وكذلك الأوليات التشفيرية الأخرى التي تجعل Signal ممكنًا. | Kitploit
أدوات/GitHubGitHub/signalapp/libsignal
أدوات التشفير/فك التشفيرإدارة الهويةالتشفيرالخصوصيةأمن الأجهزة
GitHubsignalapp/libsignal

libsignal

موطن بروتوكول Signal وكذلك الأوليات التشفيرية الأخرى التي تجعل Signal ممكنًا.

عرض المستودع
5.9k768177منذ يوم واحدتمت المراجعة من قبل Kitploit
مشاركة
# نظرة عامة

يحتوي libsignal على واجهات برمجة تطبيقات (APIs) مستقلة عن المنصة تستخدمها عملاء وخوادم Signal الرسمية، ومتاحة
كمكتبة Java أو Swift أو TypeScript. كُتبت التنفيذات الأساسية بلغة Rust:

- libsignal-protocol: ينفّذ بروتوكول Signal، بما في ذلك [خوارزمية Double Ratchet][]. بديل
  عن [libsignal-protocol-java][] و[libsignal-metadata-java][].
- signal-crypto: أوليات تشفيرية مثل AES-GCM. نستخدم أوليات [RustCrypto][] حيثما أمكن
  لكن لدينا أحيانًا احتياجات مختلفة.
- device-transfer: منطق الدعم لميزة النقل من جهاز إلى جهاز في Signal.
- attest: وظائف الإثبات عن بُعد لـ [SGX enclaves][] و[HSMs][] من جهة الخادم.
- zkgroup: وظائف [المجموعات ذات المعرفة الصفرية][] والميزات ذات الصلة المتاحة في Signal.
- zkcredential: تجريد لنوع بيانات الاعتماد ذات المعرفة الصفرية المستخدمة في zkgroup، استنادًا إلى الورقة البحثية "[The Signal Private Group System][]" لـ Chase وPerrin وZaverucha.
- poksho: أدوات مساعدة لتنفيذ إثباتات المعرفة الصفرية (مثل تلك المستخدمة في zkgroup)؛ وهو اختصار لـ "proof-of-knowledge, stateful-hash-object".
- account-keys: وظائف للاستخدام المتسق لـ [PINs][] ككلمات مرور في نظام الاسترداد الآمن للقيم (Secure Value Recovery) في Signal، بالإضافة إلى عمليات المفاتيح الأخرى على مستوى الحساب.
- usernames: وظائف لتوليد أسماء المستخدمين وتجزئتها وإثباتاتها.
- media: أدوات مساعدة لمعالجة الوسائط.

يُستخدم هذا المستودع من قِبل تطبيقات عميل Signal ([Android][] و[iOS][] و[Desktop][]) وكذلك
من جهة الخادم. الاستخدام خارج Signal غير مدعوم. على وجه الخصوص، فإن منتجات هذا المستودع
هي مكتبات Java وSwift وTypeScript التي تغلّف تنفيذات Rust الأساسية. جميع
واجهات برمجة التطبيقات والتنفيذات عرضة للتغيير دون إشعار، وكذلك طبقات "الجسر" الخاصة بـ JNI وC وإضافة Node.
ومع ذلك، فإن التغييرات غير المتوافقة مع الإصدارات السابقة على واجهات Java وSwift وTypeScript و
واجهات Rust غير الجسرية ستُعكس في رقم الإصدار على أساس بذل أفضل جهد، بما في ذلك
الزيادات في الحد الأدنى لإصدارات الأدوات المدعومة.

[Double Ratchet algorithm]: https://signal.org/docs/
[libsignal-protocol-java]: https://github.com/signalapp/libsignal-protocol-java
[libsignal-metadata-java]: https://github.com/signalapp/libsignal-metadata-java
[RustCrypto]: https://github.com/RustCrypto
[Noise protocol]: http://noiseprotocol.org/
[SGX enclaves]: https://www.intel.com/content/www/us/en/architecture-and-technology/software-guard-extensions.html
[HSMs]: https://en.wikipedia.org/wiki/Hardware_security_module
[zero-knowledge groups]: https://signal.org/blog/signal-private-group-system/
[The Signal Private Group System]: https://eprint.iacr.org/2019/1416.pdf
[PINs]: https://signal.org/blog/signal-pins/
[Android]: https://github.com/signalapp/Signal-Android
[iOS]: https://github.com/signalapp/Signal-iOS
[Desktop]: https://github.com/signalapp/Signal-Desktop


# البناء

### تثبيت سلسلة الأدوات

لبناء أي شيء في هذا المستودع يجب أن يكون لديك [Rust](https://rust-lang.org) مثبتًا، بالإضافة
إلى إصدارات حديثة من Clang وlibclang و[CMake](https://cmake.org) وMake وprotoc وPython (3.11+)
وgit.

#### Linux/Debian

على نظام شبيه بـ Debian، يمكنك الحصول على هذه التبعيات الإضافية عبر `apt`:

```shell
$ apt-get install clang libclang-dev cmake make protobuf-compiler libprotobuf-dev python3 git
```

#### macOS

في macOS، لدينا نص برمجي مُصان بأفضل جهد ممكن لإعداد سلسلة أدوات Rust يمكنك تشغيله عبر:

```shell
$ bin/mac_setup.sh
```

## Rust

### البناء والاختبار الأول

يستخدم البناء حاليًا إصدارًا محددًا من مترجم Rust المستقر، والذي
سيتم تنزيله تلقائيًا بواسطة cargo. لبناء واختبار مكتبات
البروتوكول الأساسية:

```shell
$ cargo build
...
$ cargo test
...
```

### أدوات Rust الإضافية

يجب أن تُهيّئك الأدوات الأساسية المذكورة أعلاه لمعظم أعمال تطوير libsignal بلغة Rust.

مع مرور الوقت، قد تجد أنك بحاجة إلى بعض أدوات Rust الإضافية مثل `taplo` لتنسيق الشيفرة.

يجب عليك دائمًا تثبيت أي أدوات Rust تحتاجها والتي قد تؤثر على البناء من cargo بدلاً من مدير حزم نظامك
(مثل `apt` أو `brew`). تحتوي مديري الحزم أحيانًا على إصدارات قديمة من هذه الأدوات قد تُعطّل
البناء بسبب مشكلات عدم التوافق.

لتثبيت تبعيات Rust الإضافية الرئيسية المطابقة للإصدارات التي نستخدمها، يمكنك تشغيل الأوامر التالية:

```shell
$ cargo +stable install --version "$(cat acknowledgments/cargo-about-version)" --locked cargo-about
$ cargo +stable install --version "$(cat .taplo-cli-version)" --locked taplo-cli
$ cargo +stable install cargo-fuzz
```

## Java/Android

### إعداد / تهيئة سلسلة الأدوات

لبناء تطبيق Android يجب عليك تثبيت عدة حزم إضافية بما في ذلك JDK،
و Android NDK/SDK، وإضافة أهداف Android إلى مترجم Rust، باستخدام

```rustup target add armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android```

Our officially supported JDK version for Android builds is JDK 21, so be sure to install e.g. OpenJDK 21, and then point JAVA_HOME to it.

You can easily do this on macOS via:

```shell
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
```

On Linux, the way you do this varies by distribution. For Debian based distributions like Ubuntu, you can use:

```shell
sudo update-alternatives --config java
```

We also check-in a `.tools_version` file for use with runtime version managers.

### Building and Testing

To build the Java/Android ``jar`` and ``aar``, and run the tests:

```shell
$ cd java
$ ./gradlew test
$ ./gradlew build # إذا كنت بحاجة إلى مخرجات AAR
```

You can pass `-P debugLevelLogs` to Gradle to build without filtering out debug- and verbose-level
logs from Rust, and `-P jniTypeTagging` to enable additional checks in the Rust JNI bridging code.

Alternately, a build system using Docker is available:

```shell
$ cd java
$ make
```

When exposing new APIs to Java, you will need to run `cargo run -p libsignal-jni-native_kt` (or
`just generate-jni`) in addition to rebuilding.

### Use as a library

Signal publishes Java packages for its own use, under the names org.signal:libsignal-server,
org.signal:libsignal-client, and org.signal:libsignal-android. libsignal-client and libsignal-server
contain native libraries for Debian-flavored x86_64 Linux as well as Windows (x86_64) and macOS
(x86_64 and arm64). libsignal-android contains native libraries for armeabi-v7a, arm64-v8a, x86, and
x86_64 Android. These are located in a Maven repository at
https://build-artifacts.signal.org/libraries/maven/; for use from Gradle, add the following to your
`repositories` block:

```
maven {
  name = "SignalBuildArtifacts"
  // The "uri()" part is only necessary for Kotlin Gradle; Groovy Gradle accepts a bare string here.
  url = uri("https://build-artifacts.signal.org/libraries/maven/")
}
```

Older builds were published to [Maven Central](https://central.sonatype.org) instead.

When building for Android you need *both* libsignal-android and libsignal-client, but the Windows
and macOS libraries in libsignal-client won't automatically be excluded from your final app. You can
explicitly exclude them using `packaging`:

```
android {
  // ...
  packaging {
    resources {
      excludes += setOf("libsignal_jni*.dylib", "signal_jni*.dll")
    }
  }
  // ...
}
```

You can additionally exclude `libsignal_jni_testing.so` if you do not plan to use any of the APIs
intended for client testing.

### Testing a local build with Signal-Android

The Signal-Android gradle.properties file has a commented-out line to include libsignal as part of the build. Uncomment that and adjust the path; optionally, you can restrict the architectures you want to build for by adding `androidArchs=aarch64` to *libsignal's* gradle.properties. (The set of recognized architectures is in java/build_jni.sh.) If you're using an IDE, you'll need to re-import the Gradle structure at this point. When you're done, revert the changes to the Android app's gradle.properties and re-import once more.

Note that this does not import the *Rust* parts of the project into the IDE. Doing that in a multi-language IDE like IDEA is possible, but finicky; as of 2025 the most reliable way to do it is to open the Android project first, add the libsignal repo root directory as a Rust project second (only including the top-level directory), and only then make the changes to gradle.properties.


## Swift

To learn about the Swift build process see [``swift/README.md``](https://github.com/signalapp/libsignal/blob/main/swift)


## Node

You'll need Node installed to build. If you have [nvm][], you can run `nvm use` to select an
appropriate version automatically.

We use `pnpm` as our package manager, and a Python script to control building the Rust library, accessible as `pnpm run build`.

```shell
$ cd node
$ nvm use
$ npm install -g pnpm  # أو استخدم `npx pnpm`
$ pnpm install
$ pnpm run build
$ pnpm run tsc
$ pnpm run test
```

When testing changes locally, you can use `pnpm run build` to do an incremental rebuild of the Rust library. Alternately, `pnpm run build-with-debug-level-logs` will rebuild without filtering out debug- and verbose-level logs.

When exposing new APIs to Node, you will need to run `just generate-node` in
addition to rebuilding.

[nvm]: https://github.com/nvm-sh/nvm

### NPM

Signal publishes the NPM package `@signalapp/libsignal-client` for its own use, including native
libraries for Windows, macOS, and Debian-flavored Linux. Both x64 and arm64 builds are included for
all three platforms, but the arm64 builds for Windows and Linux are considered experimental, since
there are no official builds of Signal for those architectures.

### Testing a local build with Signal-Desktop

After running all the build commands above, adjust the `@signalapp/libsignal-client` dependency in the Desktop app's package.json to "link:path/to/libsignal/node" and run `pnpm install`. When you're done, revert the changes to package.json and run `pnpm install` again.


# Contributions

Signal does accept external contributions to this project. However unless the change is
simple and easily understood, for example fixing a bug or portability issue, adding a new
test, or improving performance, first open an issue to discuss your intended change as not
all changes can be accepted.

Contributions that will not be used directly by one of Signal's official client apps may still be
considered, but only if they do not pose an undue maintenance burden or conflict with the goals of
the project.

Signing a [CLA (Contributor License Agreement)](https://signal.org/cla/) is required for all contributions.

## Code Formatting and Acknowledgments

You can run the styler on the entire project by running:

```shell
فقط format-all
```

You can run more extensive tests as well as linters and clippy by running:

```shell
تحقق فقط من pre-commit
```

When making a PR that adjusts dependencies, you'll need to regenerate our acknowledgments files. See [``acknowledgments/README.md``](https://github.com/signalapp/libsignal/blob/main/acknowledgments).

# Legal things
## Cryptography Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on
the import, possession, use, and/or re-export to another country, of encryption software.  BEFORE using any encryption
software, please check your country's laws, regulations and policies concerning the import, possession, or use, and
re-export of encryption software, to see if this is permitted.  See <http://www.wassenaar.org/> for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as
Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing
cryptographic functions with asymmetric algorithms.  The form and manner of this distribution makes it eligible for
export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export
Administration Regulations, Section 740.13) for both object code and source code.

## License

Copyright 2020-2026 Signal Messenger, LLC

Licensed under the GNU AGPLv3: https://www.gnu.org/licenses/agpl-3.0.html
تنزيل الأداة

الأكثر شعبية

عرض الكل →

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

لا توجد بيانات شعبية بعد.

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

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

عرض جميع الأدوات →