Questa pagina descrive come configurare l'autenticazione e le autorizzazioni prima di creare il datastore Zendesk.
Abilitare l'accesso con token
Per consentire a Zendesk di autenticarsi e interagire con la tua istanza Zendesk, devi abilitare l'accesso ai token. Segui questi passaggi per attivare l'accesso con token:
- Vai alla tua istanza di Zendesk e accedi con un account amministratore.
- Nel menu di navigazione, espandi App e integrazioni, quindi seleziona Configurazione API da API.
- Seleziona la casella di controllo Consenti accesso con token API.
- Fai clic su Salva.
Configurare l'autenticazione e le autorizzazioni
Per un'integrazione sicura tramite OAuth 2.0, devi registrare la tua applicazione in Zendesk per ottenere l'ID client e il client secret necessari.
Crea un client OAuth e ottieni le credenziali di autenticazione
Per creare un client OAuth in Zendesk e ottenere le credenziali di autenticazione:
Vai alla tua istanza di Zendesk e accedi con un account amministratore.
Fai clic sull'icona Prodotti Zendesk, quindi seleziona Admin Center.
Zendesk Admin Center Nel menu di navigazione, espandi App e integrazioni e seleziona Client OAuth da API.
Fai clic su Aggiungi client OAuth.
Inserisci i seguenti dettagli del cliente:
- Nome:inserisci un nome descrittivo per l'applicazione.
- (Facoltativo) Descrizione: inserisci una breve descrizione.
- (Facoltativo) Azienda: inserisci il nome della tua azienda.
- (Facoltativo) Logo: fornisci un logo, che viene visualizzato nella schermata del consenso.
- Identificatore univoco (ID cliente): fornisci un nome univoco per il tuo client. Puoi modificare il suggerimento iniziale, ma deve essere univoco.
- Tipo di client:seleziona Pubblico per le applicazioni eseguite in un browser o su un dispositivo mobile oppure Riservato per le applicazioni eseguite su server sicuri.
- URL di reindirizzamento (obbligatori): inserisci
https://vertexaisearch.cloud.google.com/oauth-redirect. Questo è l'URL a cui Zendesk reindirizza dopo l'autorizzazione, ricevendo il codice di autorizzazione.
Fai clic su Salva per ottenere il client secret.
- ID client:il valore del campo Identificatore univoco.
- Client secret:viene visualizzato un nuovo campo Secret. Copia questo secret e salvalo immediatamente in una posizione sicura. Per motivi di sicurezza, il secret completo viene mostrato una sola volta. Se lo perdi, devi rigenerarlo.
Credenziali client generate Fai di nuovo clic su Salva per finalizzare le modifiche.
Configurare le autorizzazioni
Per configurare le autorizzazioni richieste:
- Vai alla tua istanza di Zendesk e accedi con un account amministratore.
- Fai clic sull'icona Prodotti Zendesk, quindi seleziona Admin Center.
- Nel menu di navigazione, espandi App e integrazioni e seleziona Client OAuth da Connessioni.
- Fai clic su Add client (Aggiungi client).
Inserisci i seguenti dettagli del cliente:
- Nome: inserisci un nome descrittivo. Questo valore non può essere modificato.
- Tipo di concessione OAuth: seleziona Codice di autorizzazione.
- ID client: inserisci l'ID client ottenuto dalla sezione Creare un client OAuth in Zendesk.
- Client secret: inserisci il valore del client secret ottenuto dalla sezione Crea un client OAuth in Zendesk.
- URL di autorizzazione: l'endpoint di autorizzazione è in genere nel formato
https://<var>your-subdomain</var>.zendesk.com/oauth/authorize. Sostituisci<var>your-subdomain</var>con il tuo sottodominio Zendesk effettivo. - URL token: l'endpoint token è in genere nel formato
https://<var>your-subdomain</var>.zendesk.com/oauth/token. Sostituisci<var>your-subdomain</var>con il tuo sottodominio Zendesk effettivo.
Aggiungi ambiti - Ambiti: inserisci gli ambiti seguenti separati da spazi, in base alla modalità di connessione:
Modalità di connessione Ambito Finalità Consenso dell'amministratore richiesto Ricerca federata read,users:readConsente di eseguire ricerche nei dati di Zendesk. No Fai clic su Salva.