Safeguard Docs
Integrations

Cloud provider catalog

How the Cloud tab's provider catalog works: which clouds have their own connector, which connect through a generic connector, and how to ask for the rest.

What it does

The Cloud tab of Integrations has a Cloud provider catalog under the deployment cards. It lists cloud providers from every region: the large public clouds, regional and sovereign clouds, developer clouds, edge and PaaS platforms, GPU clouds, telco clouds, object storage and private cloud platforms.

Every card says how Safeguard connects to that provider today. There are three kinds:

Card saysWhat it meansWhat the button does
Full connectorSafeguard has a connector for this provider's own API, and runs its compliance tests on itConnect opens the Connectors tab on that provider's connector
Standard connectorThere is no connector for this provider's API, but one of the generic connectors below works with the services it offersOne button per generic connector that fits, each opening that connector
Request accessNo connector fits yetRequest files a request with the provider's name filled in; it shows in your request history with a reference

The catalog is switched on per workspace, so yours may not show it yet. Ask your Safeguard contact to switch it on.

The generic connectors

These work with any provider that offers the matching service. A card lists only the ones that fit what that provider offers.

Generic connectorWorks withWhat you give Safeguard
Kubernetes (kubeconfig)Any Kubernetes cluster you run on that provider, managed or self-installedA kubeconfig that signs in with a token (service account token). Exec plugins and client certificates are not used
S3-compatible storageObject storage that speaks the S3 APIThe MinIO connector, pointed at the provider's own https:// endpoint, with an access key and secret key. It lists buckets and reads each bucket's policy, versioning and encryption
OpenStack APIsPublic and private clouds built on OpenStackThe OpenStack connector with a Keystone v3 application credential. It reads users and roles, security groups (Neutron), object containers (Swift) and volumes (Cinder)
Container registry (OCI)Any registry that speaks the Docker Registry v2 / OCI distribution APIThe OCI Registry card on Integrations, with the registry URL and a pull credential

Infrastructure as code: Terraform, CloudFormation, Helm and Kubernetes files can be scanned with the Safeguard CLI's IaC scan, whichever cloud they target. That is not shown as a connection on the cards. Safeguard does not read Terraform state files.

Public vs private

This does not apply to the catalog itself. Each connector it opens has its own page with its public and private options.

Supported auth methods

The catalog asks for no credential. The connector a card opens asks for its own; see the table above and each connector's page.

Permissions required

The catalog needs none. For the generic connectors:

ConnectorPermissionRequired?Why
KubernetesA service account that can get and list the resources the tests read (for example a read-only ClusterRole)RequiredThe tests only read the cluster
S3-compatible storageList buckets, and get each bucket's location, policy, versioning and encryptionRequiredThose are the only calls it makes
OpenStackAn application credential for a role that can read identity, network, object storage and block storageRequiredThe tests only read the project
OCI registryPull (read) access to the repositories you want scannedRequiredImages are pulled to scan them

What we never need: an owner, root or admin credential, or write access to your cloud.

Token types

CredentialWorks?Notes
Kubernetes service account token in a kubeconfigYesRead-only role recommended
Kubernetes kubeconfig with an exec plugin or client certificateNoUse a service account token instead
S3 access key and secret keyYesScoped to list and read bucket settings
OpenStack application credential (Keystone v3)YesRestrict it to a read-only role
OpenStack user name and passwordNoCreate an application credential instead
Registry pull token or robot accountYesPull access only

Expiry: set by your provider; replace a credential in its connector before it expires.

Step-by-step setup

In Safeguard

  1. Open Integrations and choose the Cloud tab.
  2. In Cloud provider catalog, search for the provider, or filter by Region, Category or Connection. The chips above the filters count every provider of each kind; select one to filter by it.
  3. On the provider's card:
    • Full connector: select Connect. The Connectors tab opens on that connector; follow its form.
    • Standard connector: select the generic connector you want (for example S3-compatible storage). Enter the provider's endpoint and a read-only credential.
    • Request access: select Request, say why you need it if you like, and send.

If your workspace does not have the connector a card would open, the card offers Request instead and says so.

Webhooks and triggers

The catalog has no webhooks. Each connector's page says how often it reads.

What we read and store

  • Read: the catalog reads nothing from your cloud. Each connector reads what its page lists.
  • Stored: a request stores the provider's name, your reason and the support ticket it files.
  • No customer data from this integration is sent to third-party LLMs.

Troubleshooting

What you seeCauseFix
A provider is missingIt is not in the catalog yetUse Request more under the deployment cards, or ask your Safeguard contact
Connect shows no matching connector on the Connectors tabThat connector is not offered to your workspaceAsk your Safeguard admin to enable it, or use Request
The S3-compatible connector cannot sign inThe endpoint is not https://, or the key cannot list bucketsUse the provider's S3 endpoint with https:// and a key with the list and get permissions above

Rotation and disconnect

  • Rotate: create a new credential with your provider, update it in the connector, then revoke the old one.
  • Disconnect: remove the connection from the connector it was made in, then revoke the credential with your provider.

Vendor references

On this page