Skip to content

Add documentation for ipv6_neighbor_router_advertisement.rb see https… #20665

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.

Sign up for GitHub

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
+39 −0
Open

Add documentation for ipv6_neighbor_router_advertisement.rb see https… #20665

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions ...ation/modules/auxiliary/scanner/discovery/ipv6_neighbor_router_advertisement.md
View file
Open in desktop
Copy link
Contributor

@dledda-r7 dledda-r7 Nov 6, 2025

Choose a reason for hiding this comment

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

Can you please run our script to ensure the document is following the correct layout?

ruby tools/dev/msftidy_docs.rb documentation/modules/auxiliary/scanner/discovery/ipv6_neighbor_router_advertisement.md

Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
## Description

This module discovers IPv6 hosts on the local network by sending spoofed router advertisement packets and listening for neighbor solicitations.

## Target Environment

This module is designed to be used on a local network segment where IPv6 is enabled. It is effective for identifying hosts that are configured for IPv6 auto-configuration (SLAAC), as they will respond to the router advertisement. This is common in modern operating systems, including Windows, macOS, and various Linux distributions.
Copy link
Contributor

@dledda-r7 dledda-r7 Nov 6, 2025

Choose a reason for hiding this comment

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

Wouldbe useful attaching here a refernce to the IPv6 Neighbor Discovery Protocol?


## Verification Steps

1. Start `msfconsole`
2. Do: `use auxiliary/scanner/discovery/ipv6_neighbor_router_advertisement`
3. Do: `set RHOSTS fe80::%eth0` (or your network interface)
4. Do: `run`
5. The module will begin sending router advertisements and report any discovered hosts.

## Options

### TIMEOUT_NEIGHBOR

This option specifies the time in seconds to listen for a neighbor solicitation response after sending a router advertisement. The default value is `1`. Increasing this value may help discover slower hosts on the network, but it will also increase the module's execution time.

## Scenarios

### Discovering IPv6 Hosts on a Local Network

The primary use of this module is to identify active IPv6 hosts on the local network segment. This can be useful for building a target list for further scanning or assessment. The module uses the `pcap` library to listen for `icmp6` traffic and `capture.inject` to send the spoofed router advertisement, allowing it to operate at a low level on the network.

```
msf6 auxiliary(scanner/discovery/ipv6_neighbor_router_advertisement) > set RHOSTS fe80::%eth0
RHOSTS => fe80::%eth0
msf6 auxiliary(scanner/discovery/ipv6_neighbor_router_advertisement) > run

[*] Sending router advertisement...
[*] Listening for neighbor solicitation...
[+] |*| 2001:db8:1:1:c0a8:1:a2b3:c4d5
[*] Attempting to solicit link-local addresses...
[+] |*| fe80::c0a8:1:a2b3:c4d5 -> 00:0c:29:12:34:56
[*] Auxiliary module execution completed