Argus-SAF: Argus स्थैतिक विश्लेषण ढांचा

यह Argus-SAF का आधिकारिक भंडार है।

Argus-SAF के साथ परीक्षण और खेलने के लिए, आप हमारे Argus-SAF-playground प्रोजेक्ट से फोर्क कर सकते हैं, जिसमें विभिन्न प्रकार के विश्लेषण करने के तरीके के डेमो कोड के साथ एक Argus-SAF संवर्धित प्रोजेक्ट के लिए बुनियादी सेटअप है।

Repository structure

Argus-SAF/
+--src/main/scala/org.argus.saf/Main.scala     Main class for argus-saf CLI.
+--jawa         Core static analysis data structures, "*.class"&"*.jawa" file managing, jawa compiler, class hierarchy, method body resolving, flow analysis, etc.
+--amandroid    Android resource parsers, information collector, decompiler, environment method builder, flow analysis, etc.
+--jnsaf        Java native interface analysis.
+--nativedroid  Annotation based analysis using angr symbolic execution engine.

Argus-SAF को लाइब्रेरी के रूप में प्राप्त करना

Jawa पर निर्भर करें build.sbt संपादित करके:

libraryDependencies += "com.github.arguslab" %% "jawa" % VERSION

Amandroid पर निर्भर करें build.sbt संपादित करके:

libraryDependencies += "com.github.arguslab" %% "amandroid" % VERSION

ध्यान दें: Amandroid पर निर्भरता स्वचालित रूप से Jawa को निर्भरता के रूप में जोड़ देगी। यदि आप Maven या Gradle का उपयोग करते हैं, तो आपको इसे संबंधित प्रारूप में अनुवाद करना चाहिए।

Argus-SAF CLI उपकरण प्राप्त करना

आवश्यकता: Java 10

1. binaries फ़ोल्डर पर जाएं।
2. argus-saf_***-version-assembly.jar डाउनलोड करें।
3. उपयोग प्राप्त करें:

$ java -jar argus-saf_***-version-assembly.jar

Argus-SAF विकसित करना

Argus-SAF विकास में भाग लेने के लिए, आपको निम्नलिखित करना होगा:

1. निम्नलिखित सॉफ़्टवेयर स्थापित करें:

   • IntelliJ IDEA 14 या उच्चतर जिसमें Scala प्लगइन का संगत संस्करण हो

2. इस भंडार को फोर्क करें और इसे अपने कंप्यूटर पर क्लोन करें

$ git clone https://github.com/arguslab/Argus-SAF.git

3. IntelliJ IDEA खोलें, File -> New -> Project from existing sources चुनें (प्रारंभिक विंडो से: Import Project), उस निर्देशिका पर इंगित करें जहाँ Argus-SAF भंडार है और फिर इसे SBT project के रूप में आयात करें।

4. जब आयात समाप्त हो जाए, तो Argus-SAF रेपो निर्देशिका पर जाएं और चलाएं

$ git checkout .idea

IDEA प्रोजेक्ट के लिए आर्टिफैक्ट और रन कॉन्फ़िगरेशन प्राप्त करने के लिए।

5. [वैकल्पिक] Argus-SAF को अधिक सुचारू रूप से बनाने के लिए आपको कंपाइलर प्रक्रिया को 2GB हीप आकार देना चाहिए।

   • यदि आप Scala Compile Server (डिफ़ॉल्ट) का उपयोग करते हैं: Settings > Languages & Frameworks > Scala Compile Server > JVM maximum heap size

   • यदि Scala Compile Server अक्षम है: Settings > Build, Execution, Deployment > Compiler > Build process heap size

6. कमांड लाइन से Argus-SAF बनाएं: Argus-SAF रेपो निर्देशिका पर जाएं और चलाएं

$ tools/bin/sbt clean compile test

7. फैट जार उत्पन्न करें: Argus-SAF रेपो निर्देशिका पर जाएं और चलाएं

$ tools/bin/sbt assembly

NativeDroid के साथ JN-Saf स्थापित करें

JN-Saf और NativeDroid स्थापित करें:

$ tools/scripts/install.sh

आप निम्न में से कोई एक स्थापित कर सकते हैं:

$ tools/scripts/install.sh jnsaf
$ tools/scripts/install.sh nativedroid

बेंचमार्क परीक्षण चलाएं

JN-Saf और NativeDroid स्थापित करने के बाद। चलाएं:

$ tools/scripts/benchmark_cli.sh droidbench
$ tools/scripts/benchmark_cli.sh iccbench
$ tools/scripts/benchmark_cli.sh nativeflowbench

मूल विश्लेषण के लिए JN-SAF लॉन्च करें

1. nativedroid स्थापित करें:

$ tools/scripts/install.sh nativedroid

2. nativedroid सर्वर प्रारंभ करें:

$ python nativedroid/nativedroid/server/native_droid_server.py /tmp/binaries nativedroid/nativedroid/data/sourceAndSinks/NativeSourcesAndSinks.txt nativedroid/data/sourceAndSinks/TaintSourcesAndSinks.txt

3. मूल विश्लेषण करने के लिए nativedroid सर्वर के साथ संचार करने हेतु NativeDroidClient.scala का उपयोग करें।

समस्या निवारण:

1. यदि Intellij में python कोड अनसुलझे आयात दिखाता है, तो आपको nativedroid फ़ोल्डर को पायथन मॉड्यूल के रूप में मैन्युअल रूप से आयात करना चाहिए और Python SDK सेट करना चाहिए। nativedroid को उसके आवश्यक पायथन पैकेजों के साथ स्थापित करने के लिए python virtualenv का उपयोग करने की अनुशंसा की जाती है।

Bazel बिल्ड

Bazel एकीकरण प्रगति पर है। अभी के लिए सभी BUILD फ़ाइलों को अनदेखा करें।

योगदान कैसे करें

Argus-SAF में योगदान करने के लिए, कृपया इस भंडार की अपनी फोर्क से हमें एक पुल अनुरोध भेजें!

Argus-SAF के निर्माण और विकास के बारे में अधिक जानकारी के लिए, कृपया हमारे योगदान दिशानिर्देश भी देखें। उत्कृष्ट विचार देने वाले लोगों को योगदानकर्ता में सूचीबद्ध किया गया है।

क्या योगदान करें

यदि आप नहीं जानते कि क्या योगदान करना है, तो आप help wanted लेबल वाले मुद्दा ट्रैकर की जांच कर सकते हैं, और Argus-SAF से स्वयं को गर्म करने में मदद के लिए एक दावा कर सकते हैं।