Skip to main content

Connect Your Curated Catalog to JFrog Artifactory

This guide covers how to connect your ActiveState Curated Catalog to a JFrog Artifactory remote repository. Once connected, developers in your organization can pull open source components directly from your secured catalog instead of the public internet.

Prerequisites​

  • JFrog Artifactory with admin access.
  • An ActiveState Curated Catalog with admin access to portal.activestate.com.

Setup steps​

Most of the steps below are the same regardless of language; only the package type you select, the repository key/URL you use, and a couple of per-language notes change. Select your language below for the full walkthrough.

  1. Log in to portal.activestate.com.
  2. Click Connect to Catalog from either the Curated Catalogs home page or the Catalog page for your Python catalog.
  3. Click Issue Registry Credentials if this is your first time creating credentials, or Rotate Password if you need new credentials.
  4. Save the username, password, and remote/proxy URL. You'll enter these in JFrog Artifactory.
    1. This is the only time the password is available in plaintext. If you lose it, you'll need to reissue registry credentials.
  5. Log in to your JFrog Platform instance.
  6. In the Administration module, select Repositories.
  7. Click Create a Repository and select Remote from the list.
  8. In the Select Package Type window, click the PyPI icon.
  9. In the Basic tab, enter the settings for the remote repository:
    1. Repository Key: a unique identifier for this repository (for example, activestate-python-remote).
    2. URL: the remote/proxy URL you saved in step 4.
    3. Registry URL (under PyPI Settings): the same remote/proxy URL you saved in step 4.
      1. This field is required. Without it, Artifactory defaults to indexing https://pypi.org, and every package request through this repository returns an empty index.
    4. User Name: the username you saved in step 4.
    5. Password/Access Token: the password you copied in step 4.
  10. Optional: In the Advanced tab, configure cache settings, network settings, user permissions, or other advanced options as needed.
  11. Optional: In the Replications tab, enable event replication if required.
  12. Test the connection.
    1. On the repository configuration page (before saving), click the Test button.
    2. If the test fails, verify URL format and credentials before proceeding.
  13. Click Create Remote Repository.

Equivalent API call:

curl -X PUT \
-H "Authorization: Bearer <jfrog-access-token>" \
-H "Content-Type: application/json" \
-d '{
"rclass": "remote",
"packageType": "pypi",
"url": "https://repo.activestate.com/<org-id>/pypi",
"pyPIRegistryUrl": "https://repo.activestate.com/<org-id>/pypi",
"username": "activestate-repos",
"password": "<access-token-from-step-4>",
"description": "ActiveState Python Curated Catalog"
}' \
"https://<your-instance>.jfrog.io/artifactory/api/repositories/<repo-key>"
warning

pyPIRegistryUrl is required when scripting this with the API. Without it, Artifactory defaults to https://pypi.org for its registry URL even though url points at the catalog, and every per-package request returns a real-looking but empty index. The UI wizard's Registry URL field under PyPI Settings sets this for you; if you're using the raw API, set it explicitly to the same value as url.

Get your JFrog access token​

  1. Log in to your JFrog Artifactory instance.
  2. Click your profile icon in the top-right corner.
  3. Select Set Me Up.
  4. Select the repository you created.
  5. Click Generate Token & Create Instructions, and follow the provided commands.

Configure pip to use JFrog Artifactory​

Create or edit pip.conf (pip.ini on Windows) at ~/.config/pip/pip.conf (Linux/macOS) or %APPDATA%\pip\pip.ini (Windows):

[global]
index-url = https://<jfrog-username>:<jfrog-access-token>@<your-instance>.jfrog.io/artifactory/api/pypi/<repo-key>/simple

Test package access​

python3 -m venv .venv
source .venv/bin/activate
pip install --index-url "https://<jfrog-username>:<jfrog-access-token>@<your-instance>.jfrog.io/artifactory/api/pypi/<repo-key>/simple" requests
python3 -c "import requests; print(requests.__version__)"

Test Package Access Through Artifactory UI​

note

ActiveState Curated components are not visible in the JFrog Artifactory WebUI until after you pull and cache those components.

  1. In JFrog, click on Platform at the top of the page.
  2. Click Artifacts in the left sidebar.
  3. Navigate to the tree view.
  4. Find your repository.
  5. Click to expand - packages should start appearing after your first request.

Further reading​

Support​

For Artifactory-specific issues: Consult JFrog documentation or support.

For ActiveState catalog issues: Contact ActiveState support with:

  • Artifactory version and edition
  • Repository configuration (screenshot)
  • Artifactory logs showing errors
  • Package name having issues
  • User permissions configuration