Configuration by Package Type

Public Registry Hostnames

This is the common hostname reference shared by every SASE provider's intercept rule, regardless of vendor. Add every HTTPS hostname your clients use for the package types you have enabled in Artifactory (Package Reroute remote repositories). Confirm the defaults below with TLS/SNI captures, package-manager docs, or your SASE provider's logs. Corporate mirrors and private edge caches use different hosts. Scope must stay aligned with Supported Package Types (GA) and your entitlements.

This list is not exhaustive. Public registry and CDN hostnames can change, so re-verify when upgrading clients or changing regions.

Ecosystem Overview

SASE intercept rules, SSL inspection, Artifactory remote repository layout, and client trust differ per ecosystem. This page summarizes npm and Python (PyPI) in detail and points to other topics for Docker and Hugging Face. It does not replace scripts/README.md for OS-specific variables, client versions, and tests—use that README as the source of truth for workstation configuration.

Configure each ecosystem you enable:

• npm (Node.js)
• Python (PyPI)
• RubyGems
• Cargo (Rust)
• Docker, Hugging Face, and other types

SASE: Patterns for Every Ecosystem

• Add the correct HTTPS hostnames for each client you intercept (see Public Registry Hostnames).

Important — Request method selection: The HTTP methods to include and exclude in the redirect rule differ per package ecosystem. Using the wrong methods (for example, redirecting POST) will break specific CLI commands. Configure methods exactly as specified in the npm and Python (PyPI) tables.

• Trust: Configure the SASE CA per client and OS before enabling inspection (see your SASE provider's guide, for example Before Step 2: Verify trust stores for your package clients).

npm Configuration

Intercept Settings for npm

Why POST Must Be Excluded for npm

The npm audit command sends POST requests to registry.npmjs.org. If POST requests are included in the redirect rule, npm audit is redirected to Artifactory, which will fail because:

• npm expects an HTTP 307 redirect to properly forward a POST request (preserving the method and body)
• Some SASE solutions (for example, Zscaler) return an HTTP 302 for POST requests, which causes the npm client to drop the POST body and fail

By excluding POST from the redirect rule, npm audit traffic passes through your SASE directly to registry.npmjs.org without interception, allowing it to function normally.

Commands Affected by Method Exclusion for npm

Testing (npm)

To verify npm traffic through PTC:

1. Redirect: Run npm install express --loglevel verbose (or another public package) with SASE redirect rules active. In the output, confirm GET requests go to your Artifactory hostname / npm remote repository API path after the redirect, not only to the public registry.
2. Artifactory: In the UI, confirm express (and deps) appear in the npm remote cache (e.g. npm-remote-registry).
3. Curation (optional): Curation > Audit shows an Approved entry for the package when Curation is enabled.
4. Blocked package (optional): npm install <blocked-package> should fail with a policy violation when blocking policies apply.
5. POST passthrough: npm audit should still reach the public registry (POST not redirected).

npm installs through PTC are verified when GET traffic reaches Artifactory and npm audit still works.

Python PyPI Configuration

Intercept Settings for Python

pip, Poetry, and uv mostly use GET for Simple API metadata and artifact downloads, but ecosystem tools evolve—if a command fails after enabling the redirect, inspect method and host in your SASE and adjust the rule or category.

Trust Stores and Clients for Python

Use scripts/README.md for REQUESTS_CA_BUNDLE, UV_NATIVE_TLS, SSL_CERT_FILE, and version-specific notes for pip, Poetry, and uv. The SASE trust-store guidance linked from Prerequisites also applies.

Strict SSL Certificate Validation in Python Tools

Python-based package tools use Python's built-in ssl module for HTTPS connections, which requires certificates to be RFC 5280 compliant. If your SASE provider uses an older certificate that doesn't meet these requirements, some Python-based tools may encounter TLS errors.

This is not tied to a specific Python version — it depends on the combination of the certificate in use and the OpenSSL version Python was compiled against.

Impact by tool:

Resolution: Ask your SASE provider administrator to update the CA certificate to an RFC 5280 compliant version. Most providers have issued updated certificates since mid-2024 — once updated, all tools listed above should work without any further configuration.

Configuring Artifactory to Support Poetry for PTC

Poetry version 1.7.0 or later is supported as a PyPI client for PTC. Earlier versions of Poetry are not supported. Because Poetry uses the PyPI Simple API with JSON responses, the Artifactory PyPI remote repository used as the PTC repo_key must have JSON indexing enabled.

To enable JSON indexing on your PyPI repository:

1. In the Administration module, navigate to Artifactory Settings > Packages Settings.
2. Under PyPI, select the Enable simple json format checkbox.
3. Click Save.

JSON indexing is enabled for Poetry and other JSON-aware PyPI clients using the PTC redirect path.

For full details on creating and configuring PyPI repositories and connecting Poetry to Artifactory, see PyPI Repositories in the JFrog documentation.

Locks and Reproducibility for Python

As with npm, CI that does not traverse PTC may resolve artifacts differently than developer laptops. Align requirements.txt, Poetry, uv.lock, and pip-tools workflows across teams; watch for strict pip install --require-hashes or offline installs that assume direct PyPI URLs.

Testing for Python

To verify PyPI traffic through PTC:

1. With your SASE and Artifactory configured for PyPI, run a public install, for example pip install requests or uv pip install requests (use the same tool your teams standardize on).
2. In Artifactory, confirm the package appears under the PyPI remote repository configured as the PTC repo_key.
3. If Curation is enabled on that remote, check Curation > Audit for an expected decision.

PyPI installs through PTC are verified when packages appear in Artifactory and optional Curation audit entries look correct.

RubyGems Configuration

Intercept Settings for RubyGems

Register RubyGems with Package Reroute

Create a RubyGems remote repository in Artifactory (package type: Gems, upstream URL: https://rubygems.org), then register it with the Package Reroute API:

curl -X PUT "https://<YOUR_ARTIFACTORY_URL>/artifactory/api/package-reroute/config/gems" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"repo_key": "<YOUR_GEMS_REMOTE_REPO_KEY>"}'

Where:

• <YOUR_ARTIFACTORY_URL>: Your JFrog Platform hostname (for example acme.jfrog.io)
• <TOKEN>: Admin JWT or Basic auth credentials
• <YOUR_GEMS_REMOTE_REPO_KEY>: The key of your RubyGems remote repository

Trust Stores and Clients for RubyGems

Ruby clients (gem, Bundler) use OpenSSL for HTTPS and read the SASE CA from the SSL_CERT_FILE environment variable.

Testing (RubyGems)

To verify RubyGems traffic through PTC:

1. With SASE redirect rules active, run gem install <package> --verbose. Confirm GET requests go to your Artifactory hostname after the redirect.
2. In Artifactory, confirm the gem appears in your RubyGems remote repository cache.
3. If Curation is enabled, confirm an Approved entry appears under Curation > Audit.

Cargo (Rust) Configuration

Intercept Settings for Cargo

index.crates.io serves the sparse registry index (Cargo 1.68 and later). After the redirect, Artifactory's config.json response points crate downloads directly at the Artifactory Cargo API — crates.io and static.crates.io must not be on the SASE intercept list. Redirecting those hosts to /artifactory/api/package-reroute returns HTTP 400 (unknown registry).

Register Cargo with Package Reroute

Create a Cargo remote repository in Artifactory (package type: Cargo, upstream URL: https://crates.io), then register it with the Package Reroute API:

curl -X PUT "https://<YOUR_ARTIFACTORY_URL>/artifactory/api/package-reroute/config/cargo" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"repo_key": "<YOUR_CARGO_REMOTE_REPO_KEY>"}'

Where:

• <YOUR_ARTIFACTORY_URL>: Your JFrog Platform hostname (for example acme.jfrog.io)
• <TOKEN>: Admin JWT or Basic auth credentials
• <YOUR_CARGO_REMOTE_REPO_KEY>: The key of your Cargo remote repository

Trust Stores and Clients for Cargo

Cargo uses Rust's native TLS implementation, which reads CA certificates from the OS trust store on all platforms. No additional environment variable or cert bundle configuration is required — standard OS-level trust (macOS Keychain, Windows Certificate Store, Linux system CA bundle) is sufficient when the SASE CA is installed at the OS level by your install scripts.

Testing (Cargo)

To verify Cargo traffic through PTC:

1. With SASE redirect rules active, run cargo fetch or cargo build on a project with crates.io dependencies. Confirm requests go to your Artifactory hostname.
2. In Artifactory, confirm the crate appears in your Cargo remote repository cache.
3. If Curation is enabled, confirm an Approved entry appears under Curation > Audit.

Docker, Hugging Face, and other types

Docker: Registry hostnames (Docker Hub, GHCR, and others) belong in your SASE intercept list when those clients are in scope. Container trust is not the host OS profile — see Containers and Virtual Environments on the workstation configuration page, and Docker’s Using Docker with Zscaler (written for Zscaler, but the same CA-trust pattern applies to any TLS-inspecting SASE proxy).

Docker — clients verified by JFrog

The table below lists Docker clients currently covered in this documentation.

crane is a registry CLI built on Google’s go-containerregistry library (it shares that library’s versioning). It is not a container engine. Any Go application or CLI that uses go-containerregistry v0.21.8 or later is supported the same way.

If your standard client is not listed, validate in your environment and confirm support with your JFrog team.

• Hugging Face: Use Hugging Face Repositories for remote repository layout and credentials. The PTC repo_key for huggingfaceml must be a Hugging Face remote repository. Add huggingface.co (and any CDN hosts your traces show) to your SASE intercept list when that traffic should be redirected. Important: the SASE redirect rule for Hugging Face must use GET only — do not include HEAD. This applies to all SASE providers (Zscaler, Netskope, Cloudflare, and others). Create a separate redirect rule or policy for huggingface.co distinct from npm/PyPI rules. Xet must be disabled on workstations using PTC for Hugging Face (HF_HUB_DISABLE_XET=1). For limitations (gated models, Xet, large-asset behavior), see Hugging Face models and registry limitations.

Frequently Asked Questions

This section provides answers to frequently asked questions about per-package-type configuration for Package Traffic Controller (PTC).

Related Topics

• Package Traffic Controller (PTC) overview
• Configure Artifactory for PTC
• Configure Zscaler ZIA
• Configure Netskope
• Limitations and Troubleshooting