Questa guida contiene tutte le procedure di configurazione necessarie per iniziare a utilizzare Enterprise Knowledge Graph.
Informazioni sulla Google Cloud consolle
La Google Cloud console è un'interfaccia utente web utilizzata per eseguire il provisioning, la configurazione, la gestione, e il monitoraggio dei sistemi che utilizzano Google Cloud prodotti. Utilizzala Google Cloud consolle per configurare e gestire le risorse di Enterprise Knowledge Graph.
Crea un progetto
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto.
Un progetto organizza tutte le tue Google Cloud risorse. Un progetto è costituito dai seguenti componenti:
- Un insieme di collaboratori
- API abilitate (e altre risorse)
- Strumenti di monitoraggio
- Dati di fatturazione
- Autenticazione e controlli di accesso
Puoi creare un progetto o più progetti. Puoi utilizzare i tuoi progetti per organizzare le tue Google Cloud risorse in una gerarchia di risorse. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.
Nella Google Cloud console, nella pagina di selezione del progetto, seleziona o crea un Google Cloud progetto.
Ruoli richiesti per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'resourcemanager.projects.createautorizzazione. Scopri come concedere i ruoli.
Abilita l'API
Devi abilitare l'API Enterprise Knowledge Graph per il tuo progetto. Per saperne di più sull'abilitazione delle API, consulta la documentazione di Service Usage.
Abilita l'API Enterprise Knowledge Graph.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai
creato il progetto, probabilmente hai già questa autorizzazione tramite il
ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il
ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin).
Scopri come concedere i ruoli.
Configura l'autenticazione
Qualsiasi applicazione client che utilizza l'API deve essere autenticata e deve avere accesso alle risorse richieste. Questa sezione descrive i concetti di autenticazione importanti e fornisce i passaggi per configurarla. Per saperne di più, consulta la panoramica dell'autenticazione.
Informazioni sugli account di servizio
Esistono diverse opzioni per l'autenticazione, ma ti consigliamo di utilizzare i service account per l'autenticazione e controllo dell'accesso. Un account di servizio fornisce le credenziali per le applicazioni, anziché per gli utenti finali. I progetti sono proprietari dei propri service account. Puoi creare molti service account per un progetto. Per saperne di più, consulta Service account.
Informazioni sui ruoli
Quando si chiama un'API, Google Cloud richiede che l'identità chiamante identity (qualsiasi persona, entità o processo applicabile e i relativi attributi definiti) disponga delle autorizzazioni appropriate. Puoi concedere le autorizzazioni concedendo i ruoli a un account di servizio. Per saperne di più, consulta la documentazione di Identity and Access Management (IAM).
Per provare l'API Enterprise Knowledge Graph, puoi utilizzare il ruolo Progetto > Proprietario nei passaggi seguenti. Il ruolo Progetto > Proprietario concede al account di servizio l'autorizzazione completa alle risorse del progetto. Se il tuo account di servizio non richiede autorizzazioni complete, specifica un ruolo più restrittivo utilizzando la Google Cloud console. Per un elenco di autorizzazioni e ruoli per Enterprise Knowledge Graph, consulta Autorizzazioni di Enterprise Knowledge Graph e Ruoli di Enterprise Knowledge Graph. Per informazioni sulla gestione delle autorizzazioni utilizzando i ruoli IAM, consulta Concessione dei ruoli ai service account.
Informazioni sulle chiavi dei account di servizio
I service account sono associati a una o più coppie di chiavi pubbliche o private. Quando crei una nuova coppia di chiavi, scarichi la chiave privata. Google Cloud CLI utilizza la chiave privata per generare le credenziali quando chiama l'API.
Crea un account di servizio e scarica il file della chiave privata
Crea un account di servizio:
-
Assicurati di disporre del ruolo IAM Creazione account di servizio
(
roles/iam.serviceAccountCreator) e del ruolo Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin). Scopri come concedere i ruoli. -
Nella Google Cloud console vai a Crea service account.
Vai a Crea service account - Seleziona il progetto.
-
Nel campo Nome service account, inserisci un nome. La Google Cloud console compila il campo ID service account in base a questo nome.
Nel campo Descrizione service account, inserisci una descrizione. Ad esempio,
Service account for quickstart. - Fai clic su Crea e continua.
-
Concedi il ruolo Progetto > Proprietario al account di servizio.
Per concedere il ruolo, individua l'elenco Seleziona un ruolo, quindi seleziona Project > Owner.
- Fai clic su Continua.
-
Fai clic su Fine per completare la creazione del account di servizio.
Non chiudere la finestra del browser. Lo utilizzerai nel prossimo passaggio.
Crea una chiave dell'account di servizio:
- Nella Google Cloud console, fai clic sull'indirizzo email del account di servizio che hai creato.
- Fai clic su Chiavi.
- Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
- Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
- Fai clic su Chiudi.