Endpoint regionali di Security Command Center

Questo documento spiega come utilizzare le risorse di Security Command Center quando è abilitata la residenza dei dati. Puoi abilitare la residenza dei dati per Security Command Center solo quando attivi il livello di servizio Standard o Premium di Security Command Center per un'organizzazione oppure quando attivi il livello di servizio Security Command Center Enterprise Center.

Risorse con controlli per la residenza dei dati

I seguenti tipi di risorse di Security Command Center sono soggetti ai controlli di residenza dei dati:

• Tutte le risorse di Model Armor
• Tutte le risorse di Google Security Operations
• Configurazioni di BigQuery Export
• Configurazioni dell'esportazione continua
• Risultati
• Configurazioni delle regole di disattivazione

Per lavorare con queste risorse a livello di programmazione o dalla riga di comando, devi utilizzare gli endpoint regionali per l'API Security Command Center. Per lavorare con queste risorse nella console Google Cloud , devi utilizzare la console giurisdizionale Google Cloud .

Per tutti gli altri tipi di risorse, utilizza gli endpoint API predefiniti e la Google Cloud console.

Informazioni sugli endpoint regionali

Gli endpoint regionali forniscono l'accesso alle risorse in una località specifica. Quando utilizzi un endpoint regionale, la tua richiesta viene indirizzata direttamente alla posizione dell'endpoint. Non puoi utilizzare un endpoint regionale per accedere alle risorse in altre posizioni.

L'utilizzo di un endpoint regionale ti consente di applicare i controlli di residenza dei dati per le tue risorse quando sono at-rest, in uso e in transito.

Security Command Center include più servizi. Per i tipi di risorse soggetti ai controlli di residenza dei dati, i seguenti servizi richiedono l'utilizzo di endpoint regionali:

API Model Armor

modelarmor.LOCATION.rep.googleapis.com

API Security Command Center

securitycenter.LOCATION.rep.googleapis.com

Google SecOps

Consulta la documentazione di riferimento di Google SecOps.

Sostituisci LOCATION con una località supportata per il servizio.

Per tutti gli altri tipi di risorse, devi utilizzare l'endpoint predefinito.

Informazioni sulla console Google Cloud giurisdizionale

La console Google Cloud giurisdizionale ti consente di abilitare la residenza dei dati quando attivi Security Command Center. Fornisce anche l'accesso alle risorse in una posizione specifica.

L'utilizzo della console Google Cloud giurisdizionale ti aiuta a applicare i controlli di residenza dei dati per le tue risorse quando sono at-rest, in uso e in transito.

Puoi utilizzare la console Google Cloud giurisdizionale per accedere solo ai tipi di risorse soggetti ai controlli della residenza dei dati. Per aprire la console, utilizza l'URL appropriato per la tua posizione:

Unione Europea

Utenti con identità federata: console.eu.cloud.google

Tutti gli altri utenti: console.eu.cloud.google.com

Regno dell'Arabia Saudita (KSA)

Utenti con identità federata: console.sa.cloud.google

Tutti gli altri utenti: console.sa.cloud.google.com

Stati Uniti

Utenti con identità federata: console.us.cloud.google

Tutti gli altri utenti: console.us.cloud.google.com

Per tutti gli altri tipi di risorse, devi utilizzare la console Google Cloud standard.

Località per gli endpoint regionali

Questa sezione elenca le località in cui sono disponibili endpoint regionali per l'API Security Command Center e i servizi correlati.

Località per l'API Security Command Center

L'API Security Command Center fornisce endpoint regionali e multiregionali nelle seguenti località:

Unione Europea

eu

Regno dell'Arabia Saudita (KSA)

me-central2

Stati Uniti

us

Località per l'API Model Armor

L'API Model Armor fornisce endpoint regionali nelle seguenti località:

Unione Europea

europe-west4: Paesi Bassi Bassi livelli di CO₂

Stati Uniti

us-central1: Iowa A basse emissioni di CO₂

us-east1: Carolina del Sud

us-east4: Virginia del Nord

us-west1: Oregon <

Asia Pacifico

asia-southeast1: Singapore (supporta solo la residenza dei dati a riposo)

L'API Model Armor fornisce endpoint multiregionali nelle seguenti località:

Unione Europea

eu

Stati Uniti

us

Località per AI Protection

Per usufruire di tutti i vantaggi di AI Protection (anteprima), i workload di AI devono trovarsi in queste regioni:

Unione Europea

europe-west4: Paesi Bassi Bassi livelli di CO₂

Stati Uniti

us-central1: Iowa Bassi livelli di CO₂

us-east4: Virginia del Nord

us-west1: Oregon Bassi livelli di CO₂�

AI Protection fornisce endpoint multiregionali nelle seguenti località:

Unione Europea

eu

Stati Uniti

us

Le funzionalità disponibili variano in base alla regione. Per scoprire quali funzionalità sono o non sono disponibili nella tua regione, consulta la tabella seguente.

Località per Google SecOps

Consulta la pagina delle posizioni di Google SecOps.

Strumenti per gli endpoint regionali

Per gestire i tipi di risorse soggetti ai controlli di residenza dei dati, devi specificare un endpoint regionale quando crei un client o esegui un comando.

Per tutti gli altri tipi di risorse, devi utilizzare l'endpoint predefinito.

gcloud config set api_endpoint_overrides/SERVICE \
    https://SERVICE.LOCATION.rep.googleapis.com/

gcloud config unset api_endpoint_overrides/SERVICE

gcloud scc findings list ORGANIZATION_ID --location=LOCATION

gcloud scc findings list ORGANIZATION_ID --location=LOCATION

gcloud scc findings list ORGANIZATION_ID --location=LOCATION

provider "google" {
  alias                              = "securitycenter_v2_endpoint_us"
  security_center_v2_custom_endpoint = "https://securitycenter.us.rep.googleapis.com/v2/"
}

import (
	"context"
	"fmt"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"google.golang.org/api/option"
)

// createClientWithEndpoint creates a Security Command Center client for a
// regional endpoint.
func createClientWithEndpoint(repLocation string) error {
	// Assemble the regional endpoint URL using provided location.
	repEndpoint := fmt.Sprintf("securitycenter.%s.rep.googleapis.com:443", repLocation)
	// Instantiate client for regional endpoint. Use this client to access resources that
	// are subject to data residency controls, and that are located in the region
	// specified in repLocation.
	repCtx := context.Background()
	repClient, err := securitycenter.NewClient(repCtx, option.WithEndpoint(repEndpoint))
	if err != nil {
		return err
	}
	defer repClient.Close()

	return nil
}

import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.SecurityCenterSettings;
import java.io.IOException;

public class CreateClientWithEndpoint {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the value with the endpoint for the region in which your
    // Security Command Center data resides.
    String regionalEndpoint = "securitycenter.me-central2.rep.googleapis.com:443";
    SecurityCenterClient client = createClientWithEndpoint(regionalEndpoint);
    System.out.println("Client initiated with endpoint: " + client.getSettings().getEndpoint());
  }

  // Creates Security Command Center client for a regional endpoint.
  public static SecurityCenterClient createClientWithEndpoint(String regionalEndpoint)
      throws java.io.IOException {
    SecurityCenterSettings regionalSettings =
        SecurityCenterSettings.newBuilder().setEndpoint(regionalEndpoint).build();
    return SecurityCenterClient.create(regionalSettings);
  }
}

from google.cloud import securitycenter_v2


def create_client_with_endpoint(api_endpoint) -> securitycenter_v2.SecurityCenterClient:
    """
    Creates a Security Command Center client for a regional endpoint.
    Args:
        api_endpoint: the regional endpoint's hostname, like 'securitycenter.REGION.rep.googleapis.com'
    Returns:
        securitycenter_v2.SecurityCenterClient: returns a client for the regional endpoint
    """
    regional_client = securitycenter_v2.SecurityCenterClient(
        client_options={"api_endpoint": api_endpoint}
    )
    print(
        "Regional client initiated with endpoint: {}".format(
            regional_client.api_endpoint
        )
    )
    return regional_client