Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[MASTG-TOOL-0015] Update drozer content and remove outdated references #2614

Open
wants to merge 5 commits into
base: master
Choose a base branch
from

Conversation

cyberMilosz
Copy link

This is the first PR triggered by #2598. It focuses on rewriting the tool page itself, making sure it's accurate and removing outdated references.

Further work will need to be done to restore drozer instructions that were removed from the main MASTG body. As a result, #2598 should stay open for now.

Copy link
Collaborator

@sushi2k sushi2k left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the pull request @cyberMilosz! This is a nice update for drozer. Please find a few comments and suggestions below. Let me know if any questions.

tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved

Before you can start using drozer, you'll also need the drozer agent that runs on the Android device itself. Download the latest drozer agent [from the GitHub releases page](https://github.com/FSecureLABS/drozer/releases/ "drozer GitHub releases") and install it with `adb install drozer.apk`.
## Installing drozer
Copy link
Collaborator

@sushi2k sushi2k Jun 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As part of the refactoring for the MASTG we would like to link to the tools documentation as much as possible to avoid redundancies. This is to avoid that if there are changes in the installation process that we have outdated information in the MASTG. Then it only need to be changed in the documentation of the tool. Can you therefore please remove the content of "## Installing drozer" till "### Example usage" and replace it with a short sentence and link where the installation information can be found? It seems it's mainly the readme.md in the drozer repo that has all this information available about the installation. So you might want to link to this file or another URL that you think is more appropriate.

The "### Example usage" should remain as it shows some basic usages.

- [Official drozer User Manual](https://labs.withsecure.com/tools/drozer "drozer User Manual")
- [drozer GitHub page](https://github.com/WithSecureLabs/drozer "GitHub repo - drozer")
- [drozer Agent GitHub page](https://github.com/WithSecureLabs/drozer "GitHub repo - drozer-agent")
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the same URL as the link before. I would suggest to remove it.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whoops, that second link is supposed to be https://github.com/WithSecureLabs/drozer-agent - will correct soon!


You can learn more about how intents are created by running `help intents`

#### Further information
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link is already used in "### Example usage". Can you remove this short section and merge it with "### Example usage"?

tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
@cyberMilosz
Copy link
Author

Thank you - will review ASAP and get back to you!

@sushi2k
Copy link
Collaborator

sushi2k commented Jun 3, 2024

@cyberMilosz You can just use the "Commit Suggestion" button if you agree to the proposed changes. Thanks!

@cpholguera cpholguera changed the title Update drozer tooling page (MASTG-TOOL-0015.md) [MASTG-TOOL-0015] Update drozer content and remove outdated references Jul 7, 2024
Copy link
Collaborator

@TheDauntless TheDauntless left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few additional suggested modifications. You can simply accept them directly in this PR and then we can merge everything :)

tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
tools/android/MASTG-TOOL-0015.md Outdated Show resolved Hide resolved
Co-authored-by: Jeroen Beckers <me.githbub@dauntless.be>
Co-authored-by: Sven <sven@bsddaemon.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants