Skip to content

Commit aab372f

Browse files
committed
Clarify private-address policy for recursive lookup docs
Document that --allow-private-address only applies to explicit lookup/traverse targets, while recursive fetch steps always disallow private and localhost addresses. This updates both the lookup CLI docs and the @fedify/cli changelog entry for the recurse/private-address hardening. #608 (comment)
1 parent 764e68d commit aab372f

2 files changed

Lines changed: 6 additions & 1 deletion

File tree

CHANGES.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,8 @@ To be released.
3737
- Hardened `fedify lookup` by disallowing private/localhost document loads
3838
by default. For local-development workflows, `-p`/`--allow-private-address`
3939
(or `lookup.allowPrivateAddress = true` in config) can re-enable private
40-
address access for explicit lookup/traverse requests.
40+
address access for explicit lookup/traverse requests. This option does
41+
not apply to recursive fetches, which always disallow private addresses.
4142
[[#608]]
4243

4344
[#606]: https://github.com/fedify-dev/fedify/issues/606

docs/cli.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -530,6 +530,10 @@ and `quoteUri` are not accepted as short forms.
530530
> [!NOTE]
531531
> `--recurse` and [`-t`/`--traverse`](#t-traverse-traverse-the-collection)
532532
> are mutually exclusive.
533+
>
534+
> Recursive fetches always disallow private/localhost addresses for safety.
535+
> `-p`/`--allow-private-address` only applies to explicit lookup/traverse
536+
> targets, not to recursive steps.
533537
534538
### `--recurse-depth`: Set recursion depth limit
535539

0 commit comments

Comments
 (0)