Configura l'accesso in entrata privato

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:

  1. 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.

  2. 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:

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:

  1. 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.

    Vai al selettore di progetti

  2. Crea una VM che soddisfi i seguenti requisiti. Per saperne di più, consulta Crea e avvia un'istanza Compute Engine.

  3. Prenota un indirizzo IP regionale come descritto in Prenota un nuovo indirizzo IPv4 o IPv6 interno statico. Compila i seguenti campi come mostrato:

  4. Crea un endpoint Private Service Connect come indicato in Crea un endpoint. Compila i seguenti campi come mostrato:

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:

  1. Nella console Google Cloud , attiva Cloud Shell.

    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.

  2. 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 VM

    • INSTANCE: il nome dell'istanza VM

    • PROJECT_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:~$
    
  3. 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:

    1. Utilizzando un editor di testo a riga di comando, aggiungi la seguente riga al file /etc/hosts:

      IP_ADDRESS PRIVATE_DOMAIN_NAME
      

      Sostituisci quanto segue:

      Questo passaggio svolge una funzione simile alla configurazione dell'infrastruttura DNS.

  4. 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.com
    

    Sostituisci quanto segue:

    • PREFIX: il prefisso dell'istanza di CCAI Platform

    • INSTANCE_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.

Passaggi successivi