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

mssql_login documentation added. #18428

Merged
merged 5 commits into from Oct 13, 2023
Merged

mssql_login documentation added. #18428

merged 5 commits into from Oct 13, 2023

Conversation

AleksaZatezalo
Copy link
Contributor

@AleksaZatezalo AleksaZatezalo commented Oct 5, 2023

Working on auxilary scanner docs. Issue #12389. Added documentation for mssql_login.

Verification

Steps needed to make things work are as follows:

  • Start msfconsole
  • run msf> use scanner/mssql/mssql_login
  • run msf> info -d
  • Verify that you see proper documentation

@jheysel-r7 jheysel-r7 self-assigned this Oct 12, 2023
Copy link
Contributor

@jheysel-r7 jheysel-r7 left a comment

Choose a reason for hiding this comment

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

Thanks for the PR @AleksaZatezalo!! I've added a few suggestions around general formatting. I've also added a ### Setup section section under ## Vulnerable Application outlining how users can spin up a target to test this module.

One very useful tool when writing metasploit documentation is the tools/dev/msftidy_docs.rb. It can be run like so and provides important information with regards to formatting:

➜  metasploit-framework git:(1bd7d25088) ruby tools/dev/msftidy_docs.rb documentation/modules/auxiliary/scanner/mssql/mssql_login.md
documentation/modules/auxiliary/scanner/mssql/mssql_login.md - [WARNING] Please add a newline at the end of the file
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:3 - [WARNING] Spaces at EOL
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:6 - [WARNING] Instructional text not removed
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:9 - [WARNING] Should use single backquotes (`) for single line literals instead of triple backquotes (```)
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:10 - [WARNING] Should use single backquotes (`) for single line literals instead of triple backquotes (```)
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:11 - [WARNING] Should use single backquotes (`) for single line literals instead of triple backquotes (```)
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:15 - [WARNING] Spaces at EOL
documentation/modules/auxiliary/scanner/mssql/mssql_login.md:16 - [WARNING] Spaces at EOL

msftidy_docs.rb should always be run before submitting docs files. I've went ahead and applied the fixes to the above warnings.

@jheysel-r7 jheysel-r7 merged commit 718cdd9 into rapid7:master Oct 13, 2023
34 checks passed
@bwatters-r7 bwatters-r7 added docs rn-enhancement release notes enhancement labels Oct 19, 2023
@bwatters-r7
Copy link
Contributor

Release Notes

This PR adds documentation for the mssql_login module.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs rn-enhancement release notes enhancement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants