Privileged Access Manager (PAM) consente di creare diritti su un'organizzazione, una cartella o un progetto per fornire l'accesso temporaneo on demand alle risorseGoogle Cloud . Ogni diritto definisce i ruoli IAM (Identity and Access Management) da concedere, i richiedenti idonei, la durata massima dell'accesso e l'eventuale workflow di approvazione richiesto. I ruoli concessi da un entitlement seguono la gerarchia delle risorse Google Cloud, pertanto le risorse secondarie ereditano l'accesso concesso a livello principale.
Considerazioni sui diritti
Prima di creare un diritto, esamina i seguenti requisiti e vincoli:
- Ruoli e servizi supportati:
- Puoi aggiungere ruoli predefiniti o personalizzati solo per i servizi che supportano le condizioni IAM.
- Per i ruoli di base, sono supportati solo
Admin(roles/admin),Writer(roles/writer) eReader(roles/reader). I ruoli di base legacyOwner,EditoreViewernon sono supportati. - Non concedere ruoli di service agent nei diritti. Alcuni ruoli degli agenti di servizio contengono autorizzazioni molto potenti, che possono cambiare senza preavviso. Scegli invece un altro ruolo predefinito o crea un ruolo personalizzato con le autorizzazioni necessarie.
- Richiedenti e approvatori:
- Puoi aggiungere fino a 20 entità come richiedenti e fino a 20 entità per livello di approvazione come approvatori. Se aggiungi un gruppo come richiedente o approvatore, tutti i membri del gruppo possono richiedere o esaminare le concessioni, ma solo l'account individuale che richiede una concessione riceve privilegi elevati.
- Se le approvazioni automatiche sono abilitate per la risorsa, puoi aggiungere service account, identità degli agenti e identità dei pool di workload come approvatori (anteprima). Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
- Se è attivato il livello Security Command Center Premium o Enterprise, puoi configurare fino a due livelli di approvazione sequenziali per entitlement e richiedere fino a cinque approvazioni per livello (anteprima).
Gli approvatori di secondo livello ricevono una notifica dopo il completamento delle approvazioni di primo livello e la concessione diventa
activedopo la ricezione delle approvazioni di secondo livello. Se un approvatore rifiuta la richiesta, la concessione passa allo statodeniedsenza inviare notifiche ad altri approvatori.
- Accesso esistente: la creazione di un diritto non revoca le associazioni di ruoli IAM permanenti già esistenti per le entità. Per richiedere l'accesso just-in-time, rimuovi separatamente le associazioni di ruoli permanenti esistenti.
Prima di iniziare
Per ottenere le autorizzazioni necessarie per creare entitlement, chiedi all'amministratore di concederti i seguenti ruoli IAM nell'organizzazione, nella cartella o nel progetto per cui vuoi creare entitlement:
-
Crea i diritti per un'organizzazione:
- Amministratore Privileged Access Manager (
roles/privilegedaccessmanager.admin) - Security Admin (
roles/iam.securityAdmin)
- Amministratore Privileged Access Manager (
-
Crea per una cartella:
- Privileged Access Manager Admin (
roles/privilegedaccessmanager.admin) - Folder IAM Admin (
roles/resourcemanager.folderAdmin)
- Privileged Access Manager Admin (
-
Crea i diritti per un progetto:
- Privileged Access Manager Admin (
roles/privilegedaccessmanager.admin) - Project IAM Admin (
roles/resourcemanager.projectIamAdmin)
- Privileged Access Manager Admin (
-
Per visualizzare gli audit log:
Visualizzatore log (
roles/logs.viewer)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare diritti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare i diritti sono necessarie le seguenti autorizzazioni:
-
Per creare diritti e concessioni per un'organizzazione:
-
resourcemanager.organizations.get -
resourcemanager.organizations.setIamPolicy -
privilegedaccessmanager.entitlements.create
-
-
Per creare diritti e concessioni per una cartella:
-
resourcemanager.folders.get -
resourcemanager.folders.setIamPolicy -
privilegedaccessmanager.entitlements.create
-
-
Per creare diritti e concessioni per un progetto:
-
resourcemanager.projects.get -
resourcemanager.projects.setIamPolicy -
privilegedaccessmanager.entitlements.create
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Crea diritti
Console
Vai alla pagina Privileged Access Manager.
Seleziona l'organizzazione, la cartella o il progetto a cui vuoi applicare il diritto.
Fai clic sulla scheda Diritti.
Fai clic su Crea.
Nella sezione Dettagli diritto, inserisci i seguenti dettagli del diritto:
Un nome del diritto. Il nome di un diritto può contenere da 4 a 63 caratteri. Deve iniziare con una lettera minuscola e può contenere solo lettere minuscole, numeri e trattini.
Fino a 30 ruoli da concedere all'organizzazione, alla cartella o al progetto.
Puoi anche aggiungere condizioni IAM a questi ruoli nello stesso modo in cui aggiungi condizioni alle associazioni dei ruoli delle policy di autorizzazione.
La durata massima di una concessione. La durata massima che puoi impostare per un diritto è di 7 giorni.
Fai clic su Avanti.
Nella sezione Aggiungi richiedenti, inserisci fino a 20 entità richiedenti valide per il diritto.
Sono supportati tutti i tipi di entità, ad eccezione di
allUserseallAuthenticatedUsers. Puoi aggiungere più di 20 identità aggiungendole a un gruppo ed elencando il gruppo nel diritto.Scegli se le entità devono fornire una giustificazione per la richiesta di concessione.
Inserisci gli indirizzi email aggiuntivi degli utenti che devono ricevere una notifica quando il diritto è idoneo alla richiesta.
Le Google Identity associate al diritto, come approvatori e richiedenti, vengono informate automaticamente. Tuttavia, se vuoi inviare notifiche ad altre persone, puoi aggiungere i loro indirizzi email. Questo è particolarmente utile se utilizzi le identità della forza lavoro anziché gli Account Google.
Fai clic su Avanti.
Nella sezione Aggiungi approvatori, esegui una delle seguenti operazioni:
Per consentire l'assegnazione dei ruoli senza approvazione, seleziona Attiva l'accesso senza approvazioni.
Per richiedere le approvazioni:
- (Facoltativo) Per richiedere agli approvatori di inserire le giustificazioni per l'approvazione delle richieste, seleziona Giustificazione richiesta da parte degli approvatori.
Inserisci i dettagli dell'approvatore di primo livello:
Un elenco di approvatori per il diritto
Puoi aggiungere uno dei seguenti tipi di entità come approvatori:
Account Google
Gruppi Google
Domini Google Workspace
Identificatori dei pool di forza lavoro
Identificatori dei pool di workload
Service account e identità degli agenti
I service account, le identità degli agenti e gli identificatori dei pool di workload sono disponibili solo se i service account e le identità degli agenti sono autorizzati ad approvare le concessioni per questa risorsa. Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
Numero di approvazioni richieste
Se hai aggiunto un gruppo come approvatore, assicurati che il numero di approvazioni richieste sia inferiore o uguale al numero di entità nel gruppo. In caso contrario, le concessioni rimarranno bloccate per sempre nello stato
approval awaited.Indirizzi email degli approvatori per la notifica
(Facoltativo) Aggiungi i dettagli dell'approvatore di secondo livello:
Un elenco di approvatori per il diritto
Puoi aggiungere uno dei seguenti tipi di entità come approvatori:
Account Google
Gruppi Google
Domini Google Workspace
Identificatori dei pool di forza lavoro
Identificatori dei pool di workload
Service account e identità degli agenti
I service account, le identità degli agenti e gli identificatori dei pool di workload sono disponibili solo se i service account e le identità degli agenti sono autorizzati ad approvare le concessioni per questa risorsa. Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
Numero di approvazioni richieste
Se hai aggiunto un gruppo come approvatore, assicurati che il numero di approvazioni richieste sia inferiore o uguale al numero di entità nel gruppo. In caso contrario, le concessioni rimarranno bloccate per sempre nello stato
approval awaited.Indirizzi email degli approvatori per la notifica
Puoi aggiungere fino a 20 entità approvanti (identità o gruppi) per approvazione. Se vuoi aggiungere più di 20 approvatori, puoi farlo aggiungendoli a un gruppo ed elencando il gruppo come approvatore per il diritto.
Fai clic su Avanti.
Fai clic su Crea diritto.
La propagazione dei diritti appena creati potrebbe richiedere alcuni minuti prima che siano pronti per l'uso.
gcloud
Il comando gcloud alpha pam entitlements create crea un entitlement a livello di organizzazione, cartella o progetto.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
ENTITLEMENT_ID: l'ID del diritto da creare. Un ID deve avere una lunghezza compresa tra 4 e 63 caratteri e utilizzare i seguenti caratteri:[a-z0-9-]. Il primo carattere deve essere una lettera.RESOURCE_TYPE: (Facoltativo) Il tipo di risorsa a cui appartiene il diritto. Utilizza il valoreorganization,folderoproject.SCOPE: l'organizzazione, la cartella o il progetto in cui creare il diritto, nel formatoorganizations/ORGANIZATION_ID,folders/FOLDER_IDoprojects/PROJECT_ID. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.RESOURCE_MANAGER_RESOURCE_TYPE:Organization,FolderoProject, a seconda dell'ambito.ROLE: i ruoli da assegnare quando viene concesso un diritto.MAXIMUM_GRANT_DURATION: la durata massima per cui è possibile richiedere una concessione, in secondi, che termina con un suffissos. Ad esempio, per specificare 30 minuti, utilizza1800s. L'intervallo supportato è compreso tra 30 minuti (1800s) e 168 ore (604800s).-
REQUESTING_MEMBER: Soggetti che possono richiedere la concessione del diritto. Sono supportati tutti i tipi di entità, ad eccezione diallUserseallAuthenticatedUsers. -
APPROVING_MEMBER: entità che possono approvare la richiesta di entitlement. I tipi di entità validi sono i seguenti:- Utente
- Gruppo
- Dominio
- Identificatori dei pool di forza lavoro
- Identificatori dei pool di workload
Questa opzione è disponibile solo se i service account e le identità degli agenti sono autorizzati ad approvare le richieste di diritti per questa risorsa. Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
- Service account e identità degli agenti
Questa opzione è disponibile solo se i service account e le identità degli agenti sono autorizzati ad approvare le richieste di diritti per questa risorsa. Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
APPROVALS_NEEDED: il numero di approvatori necessari per approvare la richiesta di entitlement.Se hai aggiunto un gruppo come approvatore, assicurati che il numero di approvazioni richieste sia inferiore o uguale al numero di entità nel gruppo. In caso contrario, le concessioni rimarranno bloccate per sempre nello stato
approval awaited.APPROVER_EMAIL_ADDRESSES: (Facoltativo) Indirizzi email aggiuntivi da avvisare quando viene richiesta una concessione. Le identità Google associate agli approvatori delle concessioni vengono informate automaticamente. Tuttavia, potresti voler inviare una notifica a un insieme diverso di indirizzi email, soprattutto se utilizzi la federazione delle identità per la forza lavoro.ADMIN_EMAIL_ADDRESS: (Facoltativo) Indirizzi email aggiuntivi da notificare quando a un richiedente viene concesso l'accesso. Le Google Identity associate agli approvatori delle concessioni vengono informate automaticamente. Tuttavia, potresti voler inviare una notifica a un insieme diverso di indirizzi email, soprattutto se utilizzi la federazione delle identità per la forza lavoro.REQUESTER_EMAIL_ADDRESS: (Facoltativo) Indirizzi email aggiuntivi da avvisare quando questo diritto è disponibile per la richiesta. Le identità Google associate ai richiedenti della concessione vengono informate automaticamente. Tuttavia, potresti voler inviare una notifica a un insieme diverso di indirizzi email, soprattutto se utilizzi la federazione delle identità per la forza lavoro.CONDITION_EXPRESSION: (Facoltativo) L'espressione di condizione che specifica quando l'entità può utilizzare le autorizzazioni nel ruolo. Questa condizione si applica solo quando la concessione è attiva.
Salva i seguenti contenuti in un file denominato entitlement.yaml:
privilegedAccess: gcpIamAccess: resourceType: cloudresourcemanager.googleapis.com/RESOURCE_MANAGER_RESOURCE_TYPE resource: //cloudresourcemanager.googleapis.com/SCOPE roleBindings: - role: ROLE_1 conditionExpression: CONDITION_EXPRESSION_1 - role: ROLE_2 conditionExpression: CONDITION_EXPRESSION_2 maxRequestDuration: MAXIMUM_GRANT_DURATION eligibleUsers: - principals: - REQUESTING_MEMBER_1 - REQUESTING_MEMBER_2 approvalWorkflow: manualApprovals: requireApproverJustification: true steps: - approvalsNeeded: APPROVALS_NEEDED_1 approverEmailRecipients: - APPROVER_EMAIL_ADDRESSES_1 - APPROVER_EMAIL_ADDRESSES_2 approvers: - principals: - APPROVING_MEMBER_1 - APPROVING_MEMBER_2 - approvalsNeeded: APPROVALS_NEEDED_2 approverEmailRecipients: - APPROVER_EMAIL_ADDRESSES_3 - APPROVER_EMAIL_ADDRESSES_4 approvers: - principals: - APPROVING_MEMBER_3 - APPROVING_MEMBER_4 requesterJustificationConfig: unstructured: {} additionalNotificationTargets: adminEmailRecipients: - ADMIN_EMAIL_ADDRESS_1 - ADMIN_EMAIL_ADDRESS_2 requesterEmailRecipients: - REQUESTER_EMAIL_ADDRESS_1 - REQUESTER_EMAIL_ADDRESS_2
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud alpha pam entitlements create \ ENTITLEMENT_ID \ --entitlement-file=entitlement.yaml \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID
Windows (PowerShell)
gcloud alpha pam entitlements create ` ENTITLEMENT_ID ` --entitlement-file=entitlement.yaml ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID
Windows (cmd.exe)
gcloud alpha pam entitlements create ^ ENTITLEMENT_ID ^ --entitlement-file=entitlement.yaml ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID
Dovresti ricevere una risposta simile alla seguente:
Create request issued for: [ENTITLEMENT_ID]
Waiting for operation [projects/PROJECT_ID/locations/global/operations/OPERATION_ID] to complete...done.
Created entitlement [ENTITLEMENT_ID].
additionalNotificationTargets: {}
approvalWorkflow:
manualApprovals:
requireApproverJustification: true
steps:
- id: step-1
approvalsNeeded: 3
approvers:
- principals:
- user:alex@example.com
- group:dev-team@example.com
- id: step-2
approvalsNeeded: 1
approvers:
- principals:
- user:alex@example.com
createTime: '2024-04-09T02:39:37.011866832Z'
eligibleUsers:
- principals:
- user:bola@example.com
etag: 00000000000000000000000000000000000000000000000000000000000=
maxRequestDuration: 7200s
name: projects/my-project/locations/global/entitlements/ENTITLEMENT_ID
privilegedAccess:
gcpIamAccess:
resource: //cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID
resourceType: cloudresourcemanager.googleapis.com/Project
roleBindings:
- role: roles/storage.admin
id: hwarq_1
conditionExpression: "request.time.getHours() >= 8"
requesterJustificationConfig:
unstructured: {}
state: AVAILABLE
REST
Il metodo createEntitlement dell'API Privileged Access Manager crea un entitlement a livello di organizzazione, cartella o progetto.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
SCOPE: l'organizzazione, la cartella o il progetto in cui creare il diritto, nel formatoorganizations/ORGANIZATION_ID,folders/FOLDER_IDoprojects/PROJECT_ID. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.ENTITLEMENT_ID: l'ID del diritto da creare. Un ID deve avere una lunghezza compresa tra 4 e 63 caratteri e utilizzare i seguenti caratteri:[a-z0-9-]. Il primo carattere deve essere una lettera.RESOURCE_MANAGER_RESOURCE_TYPE:Organization,FolderoProject, a seconda dell'ambito.ROLE: i ruoli da assegnare quando viene concesso un diritto.MAXIMUM_GRANT_DURATION: la durata massima per cui è possibile richiedere una concessione, in secondi, che termina con un suffissos. Ad esempio, per specificare 30 minuti, utilizza1800s. L'intervallo supportato è compreso tra 30 minuti (1800s) e 168 ore (604800s).-
REQUESTING_MEMBER: entità che possono richiedere la concessione del diritto. Sono supportati tutti i tipi di entità, ad eccezione diallUserseallAuthenticatedUsers. -
APPROVING_MEMBER: entità che possono approvare la richiesta di entitlement. I tipi di entità validi sono i seguenti:- Utente
- Gruppo
- Dominio
- Identificatori dei pool di forza lavoro
- Identificatori dei pool di workload
Questa opzione è disponibile solo se i service account e le identità degli agenti sono autorizzati ad approvare le richieste di diritti per questa risorsa. Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
- Service account e identità degli agenti
Questa opzione è disponibile solo se i service account e le identità degli agenti sono autorizzati ad approvare le richieste di diritti per questa risorsa. Per maggiori dettagli, vedi Configura le impostazioni di Privileged Access Manager.
APPROVALS_NEEDED: il numero di approvatori necessari per approvare la richiesta di entitlement.Se hai aggiunto un gruppo come approvatore, assicurati che il numero di approvazioni richieste sia inferiore o uguale al numero di entità nel gruppo. In caso contrario, le concessioni rimarranno bloccate per sempre nello stato
approval awaited.APPROVER_EMAIL_ADDRESSES: (Facoltativo) Indirizzi email aggiuntivi da avvisare quando viene richiesta una concessione. Le Google Identity associate agli approvatori delle concessioni vengono informate automaticamente. Tuttavia, potresti voler inviare una notifica a un insieme diverso di indirizzi email, soprattutto se utilizzi la federazione delle identità per la forza lavoro.ADMIN_EMAIL_ADDRESS: (Facoltativo) Indirizzi email aggiuntivi da notificare quando a un richiedente viene concesso l'accesso. Le Google Identity associate agli approvatori delle concessioni vengono informate automaticamente. Tuttavia, potresti voler inviare una notifica a un insieme diverso di indirizzi email, soprattutto se utilizzi la federazione delle identità per la forza lavoro.REQUESTER_EMAIL_ADDRESS: (Facoltativo) Indirizzi email aggiuntivi da avvisare quando questo diritto è disponibile per la richiesta. Le Google Identity associate ai richiedenti della concessione vengono informate automaticamente. Tuttavia, potresti voler inviare una notifica a un insieme diverso di indirizzi email, soprattutto se utilizzi la federazione delle identità per la forza lavoro.CONDITION_EXPRESSION: (Facoltativo) L'espressione di condizione che specifica quando l'entità può utilizzare le autorizzazioni nel ruolo. Questa condizione si applica solo quando la concessione è attiva.
Metodo HTTP e URL:
POST https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/entitlements?entitlementId=ENTITLEMENT_ID
Corpo JSON della richiesta:
{
"privilegedAccess": {
"gcpIamAccess": {
"resourceType": "cloudresourcemanager.googleapis.com/RESOURCE_MANAGER_RESOURCE_TYPE",
"resource": "//cloudresourcemanager.googleapis.com/SCOPE",
"roleBindings": [
{
"role": "ROLE_1",
"conditionExpression": "CONDITION_EXPRESSION_1",
},
{
"role": "ROLE_2",
"conditionExpression": "CONDITION_EXPRESSION_2",
},
]
}
},
"maxRequestDuration": "MAXIMUM_GRANT_DURATION",
"eligibleUsers": [
{
"principals": [
"REQUESTING_MEMBER_1",
"REQUESTING_MEMBER_2",
...
]
}
],
"approvalWorkflow": {
"manualApprovals": {
"requireApproverJustification": true,
"steps": [
{
"approvers": [
{
"principals": [
"APPROVING_MEMBER_1",
"APPROVING_MEMBER_2",
]
}
],
"approvalsNeeded": APPROVALS_NEEDED_1,
"approverEmailRecipients": [
"APPROVER_EMAIL_ADDRESSES_1",
"APPROVER_EMAIL_ADDRESSES_2",
]
},
{
"approvers": [
{
"principals": [
"APPROVING_MEMBER_3",
"APPROVING_MEMBER_4",
]
}
],
"approvalsNeeded": APPROVALS_NEEDED_2,
"approverEmailRecipients": [
"APPROVER_EMAIL_ADDRESSES_3",
"APPROVER_EMAIL_ADDRESSES_4",
]
}
]
}
},
"requesterJustificationConfig": {
"unstructured": {
}
},
"additionalNotificationTargets": {
"adminEmailRecipients": [
"ADMIN_EMAIL_ADDRESS_1",
"ADMIN_EMAIL_ADDRESS_2",
],
"requesterEmailRecipients": [
"REQUESTER_EMAIL_ADDRESS_1",
"REQUESTER_EMAIL_ADDRESS_2",
]
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata",
"createTime": "2024-03-05T03:35:14.596739353Z",
"target": "projects/PROJECT_ID/locations/global/entitlements/ENTITLEMENT_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1beta"
},
"done": false
}
Per controllare l'avanzamento di un'operazione di creazione, puoi inviare una richiesta GET al seguente endpoint:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
Invia una richiesta GET al seguente endpoint per elencare tutte le operazioni:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
Puoi utilizzare Terraform per creare i diritti. Per saperne di più, consulta google_privileged_access_manager_entitlement nella documentazione di Terraform. La propagazione dei diritti appena creati potrebbe richiedere alcuni minuti prima che siano pronti per l'uso.
Config Connector
Puoi utilizzare Kubernetes Config Connector per creare i diritti. Per saperne di più, consulta PrivilegedAccessManagerEntitlement nella documentazione di Config Connector. La propagazione dei diritti appena creati potrebbe richiedere alcuni minuti prima che siano pronti per l'uso.