Integrations

Integrating with WizOS

WizOS, offered by Wiz, is a catalog of hardened container base images.

You can retrieve these images through Cloudsmith by configuring an upstream to the WizOS registry.

Upstream configuration

Form Field	Description
Name	A descriptive name for this upstream source. A shortened version of this name will be used for tagging cached packages retrieved from this upstream.
Priority	The weighting of the Upstream source. Upstream sources are selected for resolving requests by sequential order (1..n), followed by creation date.
Proxy URL	The URL for this upstream source. This must be a fully qualified URL including any path elements required to reach the root of the repository.
Proxy Only	Proxy requests through to upstream sources in order to match assets that are not present in this repository.
Cache and Proxy	Proxy the initial request for an asset through to the upstream source and then store (cache) resolved assets in this repository for future requests.
Authentication	Select the authentication method required by this upstream. If the upstream does not require credentials, select None from the dropdown.
Headers (optional, under Additional options)	Optional key-value headers that can be passed to upstreams with each request.
Verify SSL Certificates (under Additional options)	If enabled, SSL certificates are verified when requests are made to this upstream. We recommend leaving this enabled for all public sources to help mitigate Man-In-The-Middle (MITM) attacks.

Adding the WizOS registry as an upstream

You can integrate the WizOS registry into your Cloudsmith account by adding a WizOS upstream.

WizOS Registry credentials
To find your WizOS Registry credentials, sign in to your WizOS tenant, click Profile > Tenant Info, then in the General tab, scroll to the Wiz Registry Credentials section and select WizOS Registry.

In your Cloudsmith repository, go to the Sources tab.
If you have existing upstreams configured, click + Configure new upstream.
In the modal, select the Hardened images tab.
Click the WizOS Images card.
Select the Registry tier.
In the Name field, enter a descriptive name for the upstream.
In the Priority field, specify a priority for the upstream.

For more information about upstream priority, see Upstream concepts: Priority.
The Proxy URL field is pre-filled with the WizOS registry URL: https://registry.os.wiz.io.
Under Package delivery, select Cache and proxy.
Under Authentication, select Basic Auth and enter your WizOS Registry Username and Password.
Click Additional options.
(Optional) In the Headers section, add key-value headers to pass to the upstream with each request.
Click + Add upstream.

Your WizOS upstream appears on the Upstream registries section of the Sources tab.

Pull a WizOS image with Docker native tooling

To pull the wizos-base Docker image into Cloudsmith after you've configured your Cloudsmith upstream for WizOS:

Configure a Cloudsmith upstream for WizOS by using the instructions in Adding the WizOS registry as an upstream.
Ensure that Docker is installed on your system. For more information about installing Docker, see the Docker: Install Docker Engine documentation.
Open a terminal.
Log in to Docker using your Cloudsmith username and token:
bash
```
docker login docker.cloudsmith.io
```
Pull the WizOS wizos-base image by running the following command, replacing WORKSPACE and REPOSITORY with your Cloudsmith workspace and repository:
bash
```
docker pull docker.cloudsmith.io/WORKSPACE/REPOSITORY/wizos-base:latest
```
Check your Cloudsmith repository to find the newly added WizOS image.

Updated last week