Course contentsShow
← Security
Lesson 1286 of 3,05226. Application Security - Supply ChainFree lesson

Scoping and Namespacing in Package Managers

Using scoped packages (@org/package) and private namespaces to prevent dependency confusion attacks.

Scoping and Namespacing in Package Managers

You'll learn how scoped packages and private namespaces defend against dependency confusion attacks.

What Are Scoped Packages?

Most modern package managers (npm, NuGet, Maven) support scoped packages — dependencies prefixed with an organization or namespace identifier. Instead of installing a package called utils, you'd install @mycompany/utils or com.mycompany.utils.

Think of it like email addresses: "admin" could refer to anyone, but "admin@mycompany.com" is unambiguous. Scoping creates a unique namespace that only your organization controls.

How Scoping Prevents Confusion Attacks

In a dependency confusion attack, attackers publish malicious packages with the same names as your internal dependencies to public repositories. Without scoping, the package manager might accidentally install the attacker's version instead of yours.

With scopes, your package manager configuration can enforce that:

  • @mycompany/* packages must come from your private repository
  • Unscoped packages come from public repositories
  • There's no ambiguity in resolution order

Example namespace formats:

  • npm: @mycompany/auth-library
  • Maven/Gradle: com.mycompany.auth-library
  • NuGet: MyCompany.AuthLibrary

Configuration and Enforcement

You configure your package manager to map scoped namespaces to specific registries. The @mycompany scope always resolves to your internal registry URL, making it impossible for an attacker on the public repository to substitute packages under your namespace — they simply don't have permission to publish there.

This creates an organizational boundary that attackers cannot cross.

Key Takeaway: Scoped packages and namespaces provide organizational ownership boundaries that prevent attackers from publishing packages that masquerade as your internal dependencies, effectively eliminating the confusion in dependency confusion attacks.