Per configurare l'accesso privato a un'istanza di Contact Center AI Platform (CCAI Platform), devi configurarla per l'accesso privato al momento della creazione. In questo modo, l'accesso all'istanza da internet viene bloccato. Puoi quindi configurare una connessione Private Service Connect, che utilizza il tuo indirizzo IP interno per accedere all'istanza. In questo modo, il traffico rimane privato e all'interno diGoogle Cloud. Per saperne di più, consulta Private Service Connect.
Crea un'istanza della piattaforma CCAI configurata per l'accesso privato
Puoi creare un'istanza della piattaforma CCAI configurata per l'ingresso privato, che limita l'accesso alla tua istanza da internet. Per accedere all'istanza privata, devi configurare una connessione Private Service Connect.
Per creare un'istanza di CCAI Platform configurata per l'ingresso privato:
Crea un'istanza come descritto in Inizia a utilizzare Contact Center AI Platform rispettando questi requisiti:
Configura l'istanza per l'ingresso privato con un tipo di componente AGENT.
Nel campo ID progetto consentiti, specifica l'ID progetto del progetto da cui vuoi configurare una connessione Private Service Connect.
Dopo aver salvato le impostazioni di traffico privato in entrata, queste vengono visualizzate in Accesso privato nella pagina dei dettagli dell'istanza.
Salva l'URI del collegamento di servizio generato dalla nuova istanza da utilizzare quando configuri un endpoint Private Service Connect. Per saperne di più, consulta Configurare una connessione Private Service Connect.
Hai creato un'istanza CCAI Platform configurata per:
Ingresso privato, che impedisce l'accesso da internet.
Un tipo di componente AGENT, che puoi utilizzare se crei un vincolo personalizzato.
Per accedere all'istanza, consulta Configurare una connessione Private Service Connect.
Configurare una connessione Private Service Connect
Puoi configurare una connessione Private Service Connect per accedere alla tua istanza privata della piattaforma CCAI. Questa connessione accede alla tua istanza utilizzando un indirizzo IP interno, mantenendo il traffico all'interno di Google Cloud. Agenti, gestori e amministratori della piattaforma CCAI possono accedere in sicurezza alla tua istanza utilizzando un nome di dominio privato.
La documentazione di Private Service Connect spiega come configurare una connessione Private Service Connect. Le sezioni seguenti mettono in evidenza i passaggi chiave per creare questa connessione nel contesto di CCAI Platform.
Creazione di un endpoint
Crea un endpoint Private Service Connect che utilizza un indirizzo IP interno e punta al collegamento al servizio dell'istanza che hai creato in Crea un'istanza configurata per l'accesso privato. Per saperne di più, consulta Crea un endpoint.
Configura l'infrastruttura DNS (Domain Name System)
Configura la tua infrastruttura DNS in modo che risolva il nome di dominio privato della tua istanza CCAI Platform nell'indirizzo IP interno del tuo endpoint Private Service Connect. Il nome di dominio privato dell'istanza della piattaforma CCAI è il nome di dominio pubblico con l'aggiunta di .p. Ad esempio, se il nome di dominio pubblico della tua istanza è {my_prefix}-{my_instance_id}.{location_code}.ccaiplatform.com, il nome di dominio privato sarà {my_prefix}-{my_instance_id}.{location_code}.p.ccaiplatform.com. Puoi utilizzare
il forwarding DNS dai tuoi locali alla zona DNS p.ccaiplatform.com e poi
utilizzare le policy dei server in entrata per configurare
Cloud DNS in modo che risolva questi indirizzi utilizzando le regole delle policy di risposta. Devi configurare una regola che mappi ogni indirizzo IP dell'endpoint Private Service Connect al dominio p.ccaiplatform.com corrispondente. Per saperne di più, consulta Private Service Connect.
Per configurare e testare una connessione Private Service Connect, consulta Configurare una connessione di test.
Configurare una connessione di test
Se hai creato un'istanza privata di CCAI Platform in Crea un'istanza configurata per l'accesso privato, puoi configurare una connessione di test Private Service Connect per accedere alla tua istanza privata.
Configurare una connessione di test Private Service Connect
Per configurare una connessione Private Service Connect di test, segui questi passaggi:
Nella console Google Cloud , nella pagina di selezione del progetto, crea un progetto Google Cloud. Utilizza un ID progetto specificato come ID progetto consentito in Crea un'istanza configurata per l'accesso privato.
Crea una VM che soddisfi i seguenti requisiti. Per saperne di più, consulta Crea e avvia un'istanza Compute Engine.
La VM deve trovarsi nel progetto che hai creato nel passaggio precedente.
La VM deve trovarsi nella stessa regione dell'allegato di servizio che hai creato in Crea un'istanza configurata per l'accesso privato.
Prenota un indirizzo IP regionale come descritto in Prenota un nuovo indirizzo IPv4 o IPv6 interno statico. Compila i seguenti campi come mostrato:
Versione IP:
IPv4Rete:
defaultSubnet: la subnet
defaultnella stessa regione dell'allegato del servizio creato in Crea un'istanza configurata per l'accesso privato.
Crea un endpoint Private Service Connect come indicato in Crea un endpoint. Compila i seguenti campi come mostrato:
Servizio di destinazione: l'URI del collegamento al servizio che hai salvato in Crea un'istanza configurata per l'accesso privato.
Rete:
defaultSubnet:
defaultIndirizzo IP: l'indirizzo IP che hai prenotato nel passaggio precedente
Hai configurato una connessione Private Service Connect di test. Consulta Accedi all'istanza della piattaforma CCAI per utilizzare questa connessione per accedere all'istanza della piattaforma CCAI privata.
Accedere all'istanza privata di CCAI Platform
Questa sezione mostra come utilizzare una connessione Private Service Connect per accedere all'istanza privata della piattaforma CCAI che hai creato in Configurare una connessione Private Service Connect di test.
Per accedere alla tua istanza privata di CCAI Platform dalla riga di comando, segui questi passaggi:
Nella console Google Cloud , attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per stabilire una connessione SSH alla VM che hai creato in Configura una connessione Private Service Connect di test, inserisci il seguente codice nel terminale:
gcloud compute ssh --zone "ZONE" "INSTANCE" --project "PROJECT_ID"Sostituisci quanto segue:
ZONE: la zona in cui si trova l'istanza VMINSTANCE: il nome dell'istanza VMPROJECT_ID: l'ID progetto del progetto in cui si trova l'istanza VM
Dopo l'esecuzione del codice, il prompt dei comandi dovrebbe essere simile al seguente, a indicare che hai stabilito una connessione SSH alla tua istanza VM:
{your_home_directory}@INSTANCE:~$Per mappare l'indirizzo IP interno dell'endpoint Private Service Connect al nome di dominio privato della tua istanza privata di CCAI Platform, procedi nel seguente modo:
Utilizzando un editor di testo a riga di comando, aggiungi la seguente riga al file
/etc/hosts:IP_ADDRESS PRIVATE_DOMAIN_NAMESostituisci quanto segue:
IP_ADDRESS: l'indirizzo IP che hai prenotato quando hai configurato una connessione Private Service Connect di test.PRIVATE_DOMAIN_NAME: il nome di dominio privato dell'istanza privata che hai creato in Crea un'istanza configurata per l'accesso privato. Ad esempio,{my_prefix}-{my_instance_id}.p.ccaiplatform.com. Per saperne di più, consulta Configura l'infrastruttura del Domain Name System (DNS).
Questo passaggio svolge una funzione simile alla configurazione dell'infrastruttura DNS.
Per accedere alla tua istanza privata di CCAI Platform, inserisci il seguente comando curl nel terminale. Il comando curl contiene il nome di dominio privato.
curl https://PREFIX-INSTANCE_ID.p.ccaiplatform.comSostituisci quanto segue:
PREFIX: il prefisso dell'istanza di CCAI PlatformINSTANCE_ID: l'ID dell'istanza della piattaforma CCAI
La risposta deve essere un codice HTML per la visualizzazione di una pagina dell'istanza privata della piattaforma CCAI. Ciò indica che hai eseguito l'accesso all'istanza privata con successo.
Hai configurato una connessione di test alla piattaforma CCAI e hai eseguito l'accesso alla tua istanza privata della piattaforma CCAI utilizzando il nome di dominio privato. Se tenti di accedere all'istanza privata tramite internet pubblico, utilizzando il nome di dominio pubblico (senza .p nell'URL), il tentativo non riesce, come previsto. Inoltre, un nome di dominio privato riesce a connettersi a un'istanza privata di CCAI Platform solo se hai configurato una connessione Private Service Connect.