Skip to main content

Repository Management

Repository Managers overview

The top-level container lists the repository managers configured with Repository Firewall. Repository Managers are added with a unique identifier when they connect to the Firewall service.

See the Repository Firewall Guided Setup for details on connecting a repository manager.

From this view, repository managers are administered at a high level.

  • Set Firewall policies, results access control, and quarantine for proxy repositories

  • Configure namespace protection for hosted repositories

Navigate to the overview

  1. Select Orgs and Policies from the left navigation

  2. Select Repository Managers from the organization navigator

Configuration

List of the connected repository managers with their repositories in a nested table. The filters are used to limit the list displayed. Selecting a proxy repository will open the Repository Results view for that proxy.

Repositories are removed using the trashcan icon. This action does not delete the repository from the repository manager.

Policy

Policies are inherited from the root organization. Policy actions may be overridden for repository managers for policies enabled at the root organization.

Firewall policies may be added for all repository managers at this level. These policies would not be scoped to organizations or applications.

Namespace Confusion Protection

List of namespaces protected for all repositories. See Namespace Confusion Protection

Access

Access control for who may view repository results and manage the Firewall configuration.

Single repository manager view

Access the Firewall details for a single repository manager from the left-hand menu. This view lets you manage the configuring for a specific repository manager.

  1. When the complete listing of repository managers is not displayed, selecting the Repository Managers title will drop down the complete listing of repository managers.

  2. Selecting a single repository manager in the list will navigate to this repository manager's view.

single_repo_manager.png

Edit the repository manager label

The unique identifier for any repository manager may be modified with a human-recognizable name for easier identification. We recommend using a name common to users in your organization.

  1. Select the pencil icon on the right of the repository instance to Edit the name.

  2. Edit the Repository Manager Name to a meaningful identifier

  3. Select Update to save

repo-mgm-edit-name.png

Single repository manager sections

The single repository manager view has the same sections as the overview page, however they are scoped to the single repository. This provides for granular access control of individual repository manager's configuration as well as allows for policies to be scoped to the single repository manager.

  • Configuration - Filter by repository name or format; remove a repository from configuration.

  • Policies - Set policies scoped to this specific repository manager; override actions and notifications on inherited policies.

  • Namespace Confusion Protection - configure namespaces used in this repository manager.

  • Access - allow access to repository results and configuration for this repository manager.

Single repository manager actions

The single repository manager view provides the actions menu for only this repository manager.

Repository Manager ID to Clipboard

The unique repository manager ID can be used to identify the instance in log files in IQ Server or in Nexus Repository even after the repository manager name has been set to a human-readable name.

Edit Repository Manager Name

Opens the Edit repository manager name dialog as shown above.

Delete [Repository Manager name]

Used to remove the repository manager from the IQ Server configuration.

Screenshot_2024-02-15_at_6_36_45_PM.png

Single repository manager navigation

Breadcrumbs in the top navigation can be used to return to higher levels in the repository managers hierarchy. When navigating to the repository results, the back navigation will return to this view.

When in the single repository manager view the side navigation will include the proxy and hosted repositories for this repository manager. The side menu can be expanded or collapsed.

  • The proxy repository may be selected to view the repository configuration page for that proxy

  • Hosted repositories may be selected to view the hosted repository configuration page

Proxy repository configuration page

Use this summary page for proxy repository configuration to manage access to individual proxy reports and to apply policies to specific repositories. Similar to the rest of the hierarchy, access control and policy are inherent from; the Root Organization, the Repository Managers container, as well as the configuration set on the specific repository manager where the proxy is configured.

  • Follow the best practice to enable or override enforcement of policies managed at the root organization or the Repository Managers container. Enable enforcement that does not apply to all proxy repositories.

  • Set policies on a specific proxy repository that are an exception to the rest of the organization's governance policy

  • Use the access controls on the specific repository for fine-tuned access to a single proxy

  • Set violation notifications unique to this repository such as from a testing environment

Hosted repository configuration page

Use the hosted repository configuration page to configure access to the repository firewall configuration including selecting the namespaces found within the repository. The hosted repository is analyzed for the namespaces used by the components within it. Namespace protection can be enabled and disabled using a toggle.

See Namespace Confusion Protection