I trasferimenti basati su agenti richiedono autorizzazioni IAM a livello di progetto per due entità distinte: un agente di servizio e un account agente di trasferimento.
Configura le autorizzazioni in questa pagina solo se il trasferimento coinvolge un file system, HDFS o uno spazio di archiviazione compatibile con S3. Se il trasferimento è senza agenti, non configurare i ruoli in questa pagina; vai direttamente a Configura l'accesso all'origine e alla destinazione.
I trasferimenti basati su agenti utilizzano le seguenti identità:
- Agente di servizio: un account di servizio gestito dal servizio utilizzato da Storage Transfer Service per coordinare le attività con gli agenti di trasferimento.
- Account agente di trasferimento: l' Google Cloud account utente o il servizio gestito dall'utente utilizzato per autenticare ed eseguire gli agenti di trasferimento sulle macchine o istanze client.
Per informazioni generali sulla concessione dei ruoli IAM, consulta Concessione, modifica e revoca dell'accesso alle risorse.
Autorizzazioni agente di servizio
Storage Transfer Service utilizza un agente di servizio per coordinare i trasferimenti basati su agenti.
Per consentire a Storage Transfer Service di coordinare il lavoro tra Google Cloud e i tuoi agenti di trasferimento, concedi il seguente ruolo all'agente di servizio nel progetto che esegue Storage Transfer Service:
- Agente Storage Transfer Service (
roles/storagetransfer.serviceAgent)
Ottieni l'indirizzo email dell'agente di servizio
Per concedere un ruolo al service agent, è necessario l'identificatore dell'indirizzo email del service agent. L'agente di servizio viene creato automaticamente la prima volta che crei un job di trasferimento, esegui i comandi di configurazione di gcloud transfer, visiti la pagina Storage Transfer nella console Google Cloud o chiami googleServiceAccounts.get.
Per ottenere l'indirizzo email dell'agente di servizio, chiama googleServiceAccounts.get:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storagetransfer./v1/googleServiceAccounts/PROJECT_ID"
In alternativa, vai alla
pagina di riferimento di googleServiceAccounts.get,
inserisci l'ID progetto in Parametri di richiesta nel riquadro Prova questo metodo
e fai clic su Esegui.
Copia il valore di accountEmail. L'indirizzo email utilizza il seguente formato:
project-PROJECT_NUMBER@storage-transfer-service..
Concedi il ruolo di service agent
Per concedere il ruolo Agente Storage Transfer Service:
Console Google Cloud
Nella console Google Cloud , vai alla pagina IAM del progetto che esegue Storage Transfer Service.
Fai clic su Concedi l'accesso.
Nel campo Nuove entità, inserisci l'indirizzo email del service agent.
Nell'elenco a discesa Seleziona un ruolo, cerca e seleziona Agente Storage Transfer Service (
roles/storagetransfer.serviceAgent).Fai clic su Salva.
gcloud
Esegui gcloud projects add-iam-policy-binding:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SERVICE_AGENT_EMAIL" \ --role="roles/storagetransfer.serviceAgent"
Sostituisci quanto segue:
- PROJECT_ID: il progetto che esegue Storage Transfer Service.
- SERVICE_AGENT_EMAIL: l'indirizzo email dell'agente di servizio.
Trasferisci le autorizzazioni dell'account dell'agente
Gli agenti di trasferimento vengono eseguiti sulle macchine client utilizzando le credenziali di un account utente o di un account di servizio gestito dall'utente:
- Un account utente utilizza le credenziali di un utente autenticato.
- Un account di servizio gestito dall'utente utilizza chiavi account di servizio o la federazione delle identità. Per creare un account di servizio, consulta Crea e gestisci i service account.
Per autorizzare gli agenti di trasferimento a connettersi a Storage Transfer Service, ricevere attività e registrare lo stato, assegna il seguente ruolo al progetto Google Cloud che ospita il tuo pool di agenti:
- Storage Transfer Agent (
roles/storagetransfer.transferAgent)
Per concedere questo ruolo:
Console Google Cloud
Nella console Google Cloud vai alla pagina IAM.
Assicurati di aver selezionato il progetto contenente il pool di agenti.
Fai clic su Concedi l'accesso.
Nel campo Nuove entità, inserisci l'identificatore dell'entità del tuo account utente o del account di servizio gestito dall'utente.
Nell'elenco a discesa Seleziona un ruolo, cerca e seleziona Agente Storage Transfer (
roles/storagetransfer.transferAgent).Fai clic su Salva.
gcloud
Esegui gcloud projects add-iam-policy-binding:
gcloud projects add-iam-policy-binding AGENT_POOL_PROJECT_ID \ --member="serviceAccount_OR_user:TRANSFER_AGENT_ACCOUNT" \ --role="roles/storagetransfer.transferAgent"
Sostituisci quanto segue:
- AGENT_POOL_PROJECT_ID: il progetto contenente il pool di agenti.
- serviceAccount_OR_user: specifica
serviceAccountse l'account dell'agente di trasferimento è un account di servizio ouserse gli agenti sono stati installati con un Account Google. Per un utente federato, sostituisci l'intero valore--membercon l'identificatoreprincipal://dell'utente; consulta Identificatori delle entità. - TRANSFER_AGENT_ACCOUNT: l'indirizzo email dell'account che esegue gli agenti di trasferimento.
Passaggi successivi
Dopo aver configurato le autorizzazioni del progetto, procedi con i seguenti passaggi di configurazione nell'ordine indicato:
- Crea un pool di agenti.
- Installa gli agenti di trasferimento nel tuo pool.
- Configura le autorizzazioni di accesso per i tuoi sistemi di archiviazione:
- Consulta il riferimento completo ai ruoli e alle autorizzazioni.