---
title: "Référence d'API — @nodefony/security — net"
source: docs/api/security/net.md
url: https://nodefony.github.io/nodefony-core/docs/api/security/net/
---


[Documentation](../../../) › [Référence d'API](../../) › [`@nodefony/security`](../) › net

> Générée depuis les déclarations de types publiées de `@nodefony/security` **10.0.0-beta.5** : exactement ce que reçoit une application qui l'installe. Cette page n'existe dans aucun dépôt — pour la corriger, on corrige le TSDoc du code.

## `@nodefony/security`

`import { … } from "@nodefony/security"` — 5 symboles.

### Fonctions (2)

#### `assertPublicUrl`

```ts
function assertPublicUrl(rawUrl: string, options?: IAssertPublicUrlOptions): Promise<IPublicUrlResult>
```

Valide qu'une URL sortante est sûre (anti-SSRF) : protocole autorisé, pas d'identifiants embarqués, hôte résolvable, et **toutes** les IP résolues publiques. Lève `SsrfError` (422) sinon.

#### `isBlockedAddress`

```ts
function isBlockedAddress(ip: string): boolean
```

Indique si une IP (littérale) est **non publique** (donc interdite comme cible sortante). Une IP syntaxiquement invalide est considérée bloquée (fail-closed).

### Interfaces (2)

#### `IAssertPublicUrlOptions`

```ts
interface IAssertPublicUrlOptions
```

Options de validation d'une URL sortante.

- `readonly allowPrivate?: boolean` — Autorise les cibles non publiques (dev/test only).
- `readonly allowHttp?: boolean` — Autorise `http:` en plus de `https:`.
- `readonly resolver?: DnsResolver` — Résolveur DNS (injectable pour les tests).

#### `IPublicUrlResult`

```ts
interface IPublicUrlResult
```

Résultat d'une validation SSRF réussie.

- `readonly url: URL` — URL validée (normalisée).
- `readonly addresses: string[]` — IP résolues, toutes publiques — à **pinner** à la connexion.

### Types (1)

#### `DnsResolver`

```ts
type DnsResolver = (hostname: string) => Promise<string[]>
```

Résolveur DNS injectable (testabilité) — renvoie toutes les IP d'un hôte.

---

[← Toutes les références d'API](../../)