Controllo dell'accesso con IAM

In questa pagina vengono descritti i ruoli IAM per Certificate Authority Service.

CA Service utilizza i ruoli IAM (Identity and Access Management) per il controllo dell'accesso. Con IAM, controlli l'accesso definendo chi (identità) ha quale accesso (ruolo) per quale risorsa. I ruoli IAM contengono un insieme di autorizzazioni che consentono agli utenti di eseguire azioni specifiche sulle risorse Google Cloud. Seguendo il principio del privilegio minimo concedendo a IAM ruoli, puoi proteggere l'integrità delle risorse di Certificate Authority Service e gestire la sicurezza del pool di CA e dell'infrastruttura a chiave pubblica generale (PKI) per trovare le regole.

Per scoprire come assegnare ruoli IAM a un account utente o di servizio, leggi Concessione, modifica e revoca dell'accesso alle risorse nella documentazione di IAM.

Ruoli predefiniti

La tabella seguente elenca i ruoli IAM predefiniti e le autorizzazioni associate a ciascuno di essi:

Ruolo Autorizzazioni Descrizione
Revisore servizio CA
roles/privateca.auditor
privateca.caPools.get
privateca.caPools.getIamPolicy
privateca.caPools.list
privateca.certificateAuthorities.list
privateca.certificateAuthorities.get
privateca.certificateTemplates.get
privateca.certificateTemplates.getIamPolicy
privateca.certificateTemplates.list
privateca.certificates.list
privateca.certificates.get
privateca.locations.get
privateca.locations.list
privateca.operations.get
privateca.operations.list
privateca.certificateRevocationLists.list
privateca.certificateRevocationLists.get
privateca.certificateRevocationLists.getIamPolicy
resourcemanager.projects.get
resourcemanager.projects.list
Il ruolo CA Service Auditor ha accesso di sola lettura a tutte le risorse del servizio CA e può recuperare ed elencare le proprietà del pool di CA, della CA, dei certificati, degli elenchi di revoche, dei criteri IAM e dei progetti. Ti consigliamo di assegnare questo ruolo a persone responsabili della convalida della sicurezza e delle operazioni del pool CA e che non hanno responsabilità quotidiane assegnate per amministrare il servizio.
Richiedente del certificato di servizio CA
roles/privateca.certificateRequester
privateca.certificates.create Un ruolo CA Service Certificate Requester può inviare richieste di certificato a un pool di CA. Ti consigliamo di concedere questo ruolo a utenti attendibili autorizzati a richiedere certificati.

Un utente con questo ruolo può richiedere certificati arbitrari soggetti ai criteri di emissione.

A differenza del ruolo Gestore certificati servizio di CA, questo ruolo non consente all'utente di ottenere o elencare il certificato appena emesso, né di ottenere informazioni sul pool di CA.
CA Service Workload Certificate Requester
roles/privateca.workloadCertificateRequester
privateca.certificates.createForSelf Un richiedente del certificato del carico di lavoro del servizio CA può richiedere certificati al servizio CA con l'identità del chiamante.
Gestore certificati servizio CA
roles/privateca.certificateManager
Tutte le autorizzazioni di roles/privateca.auditor, più:
privateca.certificates.create
Un gestore certificati del servizio CA può inviare richieste di emissione dei certificati a un pool di CA, ad esempio il richiedente del certificato del servizio CA. Inoltre, questo ruolo eredita anche le autorizzazioni del ruolo CA Service Auditor. Ti consigliamo di assegnare questo ruolo a persone responsabili della creazione, del monitoraggio e della revisione delle richieste di certificato in un pool di CA, ad esempio un gestore o un ingegnere capo.
Utente modello di certificato di servizio CA
roles/privateca.templateUser
privateca.certificateTemplates.get
privateca.certificateTemplates.list
privateca.certificateTemplates.use
Un utente modello di certificato di servizio CA può leggere, elencare e utilizzare modelli di certificato.
CA Service Operations Manager
roles/privateca.caManager
Tutte le autorizzazioni di roles/privateca.auditor, più:
privateca.certificates.update
privateca.caPools.create
privateca.caPools.delete
privateca.caPools.update
privateca.certificateAuthorities.create
privateca.certificateAuthorities.delete
privateca.certificateAuthorities.update
privateca.certificateRevocationLists.update
privateca.certificateTemplates.create
privateca.certificateTemplates.delete
privateca.certificateTemplates.update
privateca.certificates.update
privateca.operations.cancel
privateca.operations.delete
resourcemanager.projects.get
resourcemanager.projects.list
storage.buckets.create
Un CA Service Operation Manager può creare, aggiornare ed eliminare pool di CA e CA. Questo ruolo può anche revocare i certificati e creare bucket Cloud Storage. Inoltre, include le stesse funzionalità di CA Service Auditor. In questo ruolo, gli utenti sono responsabili della configurazione e del deployment dei pool di CA nell'organizzazione, nonché della configurazione dei criteri di emissione del pool di CA.

Questo ruolo non consente la creazione di certificati. A tale scopo, utilizza i ruoli CA Service Certificate Requester, CA Service Certificate Manager o CA Service Admin.
Amministratore servizio CA
roles/privateca.admin
Tutte le autorizzazioni da roles/privateca.certificateManager, e roles/privateca.caManager, più:
privateca.*.setIamPolicy
privateca.caPools.use
privateca.operations.cancel
privateca.operations.delete
privateca.resourcemanager.projects.get
privateca.resourcemanager.projects.list
storage.buckets.create
Il ruolo Amministratore servizio CA eredita le autorizzazioni dai ruoli Gestore operazioni servizio CA e Gestore certificati servizio CA. Questo ruolo può eseguire tutte le azioni all'interno del servizio CA. Un amministratore del servizio CA può impostare i criteri IAM per il pool di CA e creare bucket Cloud Storage. Ti consigliamo di assegnare raramente questo ruolo una volta configurato il servizio. Con questo ruolo, gli utenti possono svolgere tutti gli aspetti dell'amministrazione, tra cui l'assegnazione dei diritti ad altri e la gestione delle richieste di certificato in CA Service. Ti consigliamo di implementare un controllo e un accesso speciali a questo account del ruolo per impedirne l'accesso o l'utilizzo non autorizzati.

Ruolo Agente di servizio CA

Quando fornisci chiavi di firma Cloud KMS esistenti o bucket Cloud Storage durante la creazione della CA, all'account di servizio Agente di servizio CA (service-PROJECT_NUMBER@gcp-sa-privateca.iam.gserviceaccount.com) deve essere concesso accesso alla rispettiva risorsa.

Per Cloud KMS, roles/cloudkms.signerVerifier è necessario per utilizzare il chiave di firma e leggere la chiave pubblica. roles/viewer è necessario per monitorare la chiave per l'integrazione di Cloud Monitoring.

Per Cloud Storage, roles/storage.objectAdmin è necessario per scrivere il certificato CA e gli elenchi di revoche certificati (CRL) in un bucket. roles/storage.legacyBucketReader è obbligatoria per monitorare il bucket per l'integrazione di Cloud Monitoring. Per maggiori informazioni per informazioni, consulta Ruoli IAM per Cloud Storage.

Quando accedi al servizio tramite l'API, esegui i seguenti comandi.

  1. Creare un account di servizio con il ruolo Agente di servizio.

    gcloud

    gcloud beta services identity create --service=privateca.googleapis.com --project=PROJECT_ID
    

    Dove:

    • PROJECT_ID è l'identificatore univoco del progetto in cui viene creato il pool di CA.
  2. Concedi all'account di servizio i ruoli roles/cloudkms.signerVerifier e roles/viewer utilizzando il seguente comando gcloud.

    Se vengono fornite chiavi di firma Cloud KMS esistenti:

    gcloud

    gcloud kms keys add-iam-policy-binding 'CRYPTOKEY_NAME' \
      --keyring='KEYRING_NAME' \
      --location='LOCATION' \
      --member='serviceAccount:service-PROJECT_NUMBER@gcp-sa-privateca.iam.gserviceaccount.com' \
      --role='roles/cloudkms.signerVerifier'
    

    Dove:

    • "CRYPTOKEY_NAME" è il nome della chiave.
    • "KEYRING_NAME" è il nome del keyring.
    • "LOCATION" è la località Cloud KMS in cui hai creato il keyring.
    • "PROJECT_NUMBER" è il nome del tuo account di servizio.
    gcloud kms keys add-iam-policy-binding 'CRYPTOKEY_NAME' \
      --keyring='KEYRING_NAME' \
      --location='LOCATION' \
      --member='serviceAccount:service-PROJECT_NUMBER@gcp-sa-privateca.iam.gserviceaccount.com' \
      --role='roles/viewer'
    
  3. Concedi al tuo account di servizio roles/storage.objectAdmin e roles/storage.legacyBucketReader ruoli utilizzando i seguenti gcloud .

    Se vengono forniti bucket Cloud Storage esistenti:

    gcloud

    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
      --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-privateca.iam.gserviceaccount.com \
      --role=roles/storage.objectAdmin
    

    Dove:

    • BUCKET_NAME è il nome del tuo bucket Cloud Storage.
    • PROJECT_NUMBER è l'identificatore univoco del tuo service account.
    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
      --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-privateca.iam.gserviceaccount.com \
      --role=roles/storage.legacyBucketReader
    

Autorizzazioni API

La tabella seguente elenca le autorizzazioni che l'utente che chiama deve disporre per chiamare ciascun metodo nell'API CA Service:

Autorizzazione Descrizione
privateca.caPools.create Crea un pool di autorità di certificazione (CA).
privateca.caPools.update Aggiorna un pool di CA.
privateca.caPools.list Elenca i pool di CA in un progetto.
privateca.caPools.get Recupera un pool di CA.
privateca.caPools.delete Elimina un pool di CA.
privateca.caPools.use Utilizza un pool di CA.
privateca.caPools.getIamPolicy Recupera il criterio IAM del pool di CA.
privateca.caPools.setIamPolicy Imposta un criterio IAM per il pool di CA.
privateca.certificateAuthorities.create Crea una CA.
privateca.certificateAuthorities.delete Pianificare l'eliminazione di una CA.
privateca.certificateAuthorities.get Richiedi una richiesta di firma di un certificato CA o CA.
privateca.certificateAuthorities.list Elenca le CA in un progetto.
privateca.certificateAuthorities.update Aggiornare una CA, inclusa l'attivazione, l'abilitazione, la disattivazione e il ripristino della CA.
privateca.certificates.create Richiesta di certificati al servizio CA.
privateca.certificates.createForSelf Richiesta di certificati al servizio CA con identità del chiamante.
privateca.certificates.get Ottieni un certificato e i relativi metadati.
privateca.certificates.list Elenca tutti i certificati in una CA.
privateca.certificates.update Aggiorna i metadati di un certificato, inclusa la revoca.
privateca.certificateRevocationLists.get Ottenere un elenco di revoche dei certificati (CRL) in una CA.
privateca.certificateRevocationLists.getIamPolicy Recupera il criterio IAM per una CRL.
privateca.certificateRevocationLists.list Elenca tutti i CRL in una CA.
privateca.certificateRevocationLists.setIamPolicy Imposta il criterio IAM per una CRL.
privateca.certificateRevocationLists.update Aggiorna un CRL.
privateca.certificateTemplates.create Crea un modello di certificato.
privateca.certificateTemplates.get Recupera un modello di certificato.
privateca.certificateTemplates.list Elenca tutti i modelli di certificato.
privateca.certificateTemplates.update Aggiorna un modello di certificato.
privateca.certificateTemplates.delete Elimina un modello di certificato.
privateca.certificateTemplates.getIamPolicy Ottieni criterio IAM per un modello di certificato.
privateca.certificateTemplates.setIamPolicy Imposta il criterio IAM per un modello di certificato.
privateca.certificateTemplates.use Utilizza un modello di certificato.
privateca.operations.cancel Annullare un'operazione a lunga esecuzione.
privateca.operations.delete Elimina un'operazione a lunga esecuzione.
privateca.operations.get Ottieni un'operazione a lunga esecuzione.
privateca.operations.list Elenca le operazioni a lunga esecuzione in un progetto.

Passaggi successivi

  • Scopri come IAM centralizza la gestione delle autorizzazioni e degli ambiti di accesso per le risorse Google Cloud.
  • Scopri come configurare i criteri IAM.