Référence d'API — @nodefony/security — net

stable

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#

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#

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#

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#

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#

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