fsecurelabs/needle-agent

The iOS Agent for the Needle Security Assessment Framework

Description

NeedleAgent is an open source iOS app complementary to needle, the iOS security testing framework. It allows needle to programmatically perform tasks natively on the device eliminating the need for third party tools. The agent plays the role of a server which listens for TCP connections coming from needle (or any other TCP client).

The agent has certain messages (opcodes) that it will respond to, and, like needle, it is designed to be easily extensible: adding an opcode to the agent only requires one method to be written.

Installation

See the Installation Guide in the main project Wiki for details.

Usage

Usage instructions (for both standard users and contributors) can be found in the main project Wiki.

License

Needle-Agent is released under a 3-clause BSD License. See the LICENSE file for full details.

Contact

Feel free to submit issues or ping us on Twitter - @mwrneedle, @lancinimarco

needle-agent's Issues

Needle Agent crashes when opening on JB iPhone 5c (9.0.2)

Issue

Expected behaviour

App should open.

Actual behaviour

Every time I click the app to launch it, it crashes.

Steps to reproduce

1. on a jailbroken iPhone 5c running iOS 9.0.2 install the NeedleAgent
2. try launching the NeedleAgent from the springboard
3. observe the app crash

Environment

tried manually installing Frida for 32 bit devices.
successfully installed the agent on a jailbroken iPhone 5s running the same iOS version (9.0.2)
perhaps it is an issue with iPhone 5c being a 32-bit arch?

Workstation Operating System

Device iOS Version

iPhone 5c
Jailbroken
iOS 9.0.2

app not installing

Issue

Error installing deb file

Iphone 5S iOS 10.2 Jail broken

Expected behaviour

Tell us what sho

uld happen.

Actual behaviour

Tell us what happens instead.

Steps to reproduce

Environment

Workstation Operating System

Device iOS Version

Naming Inconsistency

The name of Needle on the blog, and readme, is "Needle" or "NeedleAgent", however on the agent it is "needleAgent". It should probably be "NeedleAgent" or "Needle Agent", but "lowercaseUppercase" doesn't make sense.

Version Inconsistency

The version of Needle on Github is v1.0.0 however on the NeedleAgent UI it is V.1.0. The case of the V, and version format should be the same.

is this repo no longer supported?

Issue

Please open an issue in the main repo: https://github.com/mwrlabs/needle/issues