Questa pagina è stata tradotta dall'API Cloud Translation.

Informazioni sugli account di servizio

Un account di servizio è un tipo speciale di account in Google Cloud che consente ai componenti e alle applicazioni di un sistema di interagire tra loro e con altre API. Per ulteriori informazioni vedi Informazioni sui servizi Google Cloud.

L'ambiente ibrido utilizza gli account di servizio Google Cloud per eseguire diverse attività, tra cui:

Invia dati di log e metriche
Richieste di tracciamento pull
Connettiti ad API Gateway per le richieste API amministrative
Esegui backup
Scaricare i bundle proxy

Anche se un account di servizio potrebbe eseguire tutte queste operazioni, Apigee consiglia di crei più account di servizio, ognuno dei quali è assegnato a un'attività specifica e ognuno con il proprio di autorizzazioni. Questo migliora la sicurezza compartimentando l'accesso e limitando ogni servizio l'ambito e i privilegi di accesso dell'account. Come per gli account utente, queste autorizzazioni vengono applicate assegnando uno o più ruoli all'account di servizio.

Service account e ruoli utilizzati dai componenti ibride

Per funzionare correttamente, Apigee Hybrid richiede la creazione di diversi account di servizio. Ogni account di servizio richiede un ruolo o più ruoli specifici che gli consentano di svolgere la sua funzione.

La tabella seguente descrive gli account di servizio per i componenti ibride:

Componente^*	Ruolo	Descrizione
`apigee-cassandra`	Storage Object Admin	Consente i backup di Cassandra in Google Cloud Storage, descritta in Backup e ripristino.
`apigee-logger`	Logs Writer	Consente la raccolta dei dati di logging, come descritto in Logging. Obbligatorio solo per non GKE delle installazioni di cluster.
`apigee-mart`	Nessun ruolo	Consente l'autenticazione del servizio MART. Questo account di servizio non deve avere un ruolo associate; di conseguenza, quando crei questo account di servizio, non assegnare un ruolo che le sono assegnati.
`apigee-metrics`	Monitoring Metric Writer	Consente la raccolta dei dati delle metriche, come descritto in Metriche raccolta
`apigee-org-admin`	Apigee Organization Admin	Consente di chiamare l'API getSyncAuthorization e API setSyncAuthorization. Non puoi creare questo account di servizio con lo strumento `create-service-account`.
`apigee-synchronizer`	Gestore del sincronizzatore Apigee	Consente al sincronizzatore di scaricare i bundle di proxy e i dati di configurazione dell'ambiente. Consente inoltre di utilizzare la funzionalità di traccia.
`apigee-udca`	Apigee Analytics Agent	Consente il trasferimento di dati di analisi, traccia e stato di implementazione al piano di gestione.
^* Questo nome viene utilizzato nel nome del file della chiave dell'account di servizio scaricata.

Oltre a creare gli account di servizio elencati in questa tabella, scarica anche e le relative chiavi private. In seguito, utilizzerai queste chiavi per generare token di accesso in modo da poter accedere ai le API Apigee.

Crea gli account di servizio

Esistono diversi modi per creare account di servizio, tra cui:

(Consigliato) Strumento create-service-account
Console Google Cloud
SDK gcloud

Ognuna di queste è descritta nelle sezioni seguenti.

Utilizzare lo strumento di creazione degli account di servizio

Lo strumento create-service-account (disponibile dopo scarica ed espandi apigeectl) crea gli account di servizio specifici dei componenti ibridi e assegna i ruoli richiesti per te. La di Google Cloud, inoltre, scarica automaticamente le chiavi degli account di servizio e le archivia sul computer locale della directory specificata.

NOTA: lo strumento create-service-account non può crea l'account di servizio apigee-org-admin. Per farlo, devi utilizzare Google Cloud o API gcloud.

Per creare account di servizio con lo strumento create-service-account:

Scarica ed espandi apigeectl (se non l'hai già fatto), come descritto in Scaricare e installare apigeectl.
Crea una directory per archiviare le chiavi degli account di servizio. Ad esempio:
```
mkdir ./service-accounts
```
Esegui questi comandi:
```
./tools/create-service-account apigee-metrics ./service-accounts
./tools/create-service-account apigee-synchronizer ./service-accounts
./tools/create-service-account apigee-udca ./service-accounts
./tools/create-service-account apigee-mart ./service-accounts
./tools/create-service-account apigee-cassandra ./service-accounts
./tools/create-service-account apigee-logger ./service-accounts
```
Questi comandi creano la maggior parte degli account richiesti e memorizzano le relative chiavi nella directory ./service-accounts. Questi comandi non creano Account di servizio apigee-org-admin.

Se questi comandi hanno esito negativo, assicurati di aver fatto riferimento a una directory esistente in cui archiviare e i file chiave.

Per ulteriori informazioni sull'utilizzo di create-service-account, consulta la documentazione di riferimento di create-service-account.
Crea l'account di servizio apigee-org-admin. A questo scopo, utilizza la classe console Google Cloud.

Utilizzare la console Google Cloud

Puoi creare account di servizio con la console Google Cloud.

Per creare account di servizio con la console Google Cloud:

Apri la console Google Cloud e accedi con l'account utente che hai creato. Passaggio 1: crea un account Google Cloud.
Seleziona il progetto che hai creato nel passaggio 2: creazione di un progetto Google Cloud.
Seleziona IAM e amministratore > Account di servizio.
La console mostra la visualizzazione Account di servizio. Questa visualizzazione mostra un elenco agli account di servizio del progetto. Nella maggior parte dei casi, non sono ancora presenti account, anche se nell'elenco potrebbero essere presenti service account predefiniti, a seconda di come hai creato il progetto.
Per creare un nuovo account di servizio, fai clic su + Crea account di servizio nella parte superiore della visualizzazione.
Viene visualizzata la visualizzazione Dettagli account di servizio.
Nel campo Nome account di servizio, inserisci il nome dell'account di servizio.
Apigee consiglia di utilizzare un nome che rifletta il ruolo dell'account di servizio; tu puoi impostare il nome dell'account di servizio in modo che sia lo stesso del componente che lo utilizza. Per Ad esempio, imposta il nome dell'account di servizio Writer log apigee-logger.

Per ulteriori informazioni sui nomi e sui ruoli degli account di servizio, consulta Account di servizio e ruoli utilizzati dai componenti ibride.

Quando inserisci un nome, Google Cloud genera per te un ID account di servizio univoco, strutturato come un indirizzo email, come illustrato nell'esempio seguente:

In via facoltativa, puoi aggiungere una descrizione nella Descrizione dell'account di servizio . Le descrizioni sono utili per ricordare per cosa viene utilizzato un determinato account di servizio.
Fai clic su Crea.
Google Cloud crea un nuovo account di servizio e mostra la visualizzazione Autorizzazioni account di servizio, come mostrato nell'esempio seguente:

Utilizza questa visualizzazione per assegnare un ruolo al nuovo account di servizio.
Fai clic sull'elenco a discesa Seleziona un ruolo.
Seleziona il ruolo per l'account di servizio, come descritto in Account di servizio e ruoli utilizzati dai componenti ibridi. Se I ruoli Apigee non vengono visualizzati nell'elenco a discesa. Aggiorna la pagina.
Ad esempio, per il componente di logging, seleziona il ruolo Scrittore di log.

Se necessario, inserisci il testo per filtrare l'elenco dei ruoli per nome. Ad esempio, per elencare solo i ruoli Apigee, inserisci "Apigee" nel campo del filtro, come mostrato nell'esempio seguente:

Puoi aggiungere più di un ruolo a un account di servizio, ma Apigee consiglia di utilizzare un solo ruolo per ciascuno degli account di servizio consigliati. Per cambiare i ruoli di un creato per l'account di servizio, utilizza il programma IAM e pannello di amministrazione nel in Google Cloud.

NOTA: se non vedi i ruoli elencati in Account di servizio consigliati, verifica con il tuo account Apigee di accertarti che il tuo account sia configurato correttamente e che è stato eseguito il provisioning dell'organizzazione.
Fai clic su Continua.
Google Cloud mostra la visualizzazione Concedi agli utenti l'accesso a questo account di servizio:
In Crea chiave (facoltativo), fai clic su Crea chiave.
Google Cloud ti offre la possibilità di scaricare una chiave JSON o P12:
Seleziona JSON (valore predefinito) e fai clic su Crea.
Google Cloud salva il file della chiave in formato JSON sul tuo computer locale e mostra una conferma al termine dell'operazione, come mostrato nell'esempio seguente:

In un secondo momento, utilizzerai alcune delle chiavi dell'account di servizio per configurare i servizi di runtime ibrida. Ad esempio, quando configuri il runtime ibrido, specificherai la località del servizio delle chiavi dell'account utilizzando le proprietà service_name.serviceAccountPath.
Queste chiavi vengono utilizzate dagli account di servizio per ottenere i token di accesso, che l'account di servizio e lo utilizza per effettuare richieste contro le API Apigee per tuo conto. (Ma non è da un po' ; per il momento, ricorda solo dove l'hai salvato.)
Ripeti i passaggi da 4 a 11 per ogni account di servizio elencato in Account di servizio e ruoli utilizzati dai componenti ibride (tranne l'account apigee-mart, che non ha alcun ruolo associato, quindi non assegnargli un ruolo).
Al termine, dovresti avere i seguenti account di servizio (oltre a quelli predefinite, se presenti):

Nella console Google Cloud, gli account di servizio sono indicati con un'icona .

Dopo aver creato un account di servizio, se vuoi aggiungere o rimuovere un ruolo, devi utilizzare le API IAM e Amministratore. Non puoi gestire i ruoli per gli account di servizio nella visualizzazione Account di servizio.

Utilizzare le API di creazione degli account di servizio gcloud

Puoi creare e gestire gli account di servizio con l'API Cloud Identity and Access Management.

Per ulteriori informazioni, consulta Creare e gestire gli account di servizio.