Integrazione con HG Insights

Con l'action connector HG Insights, puoi accedere ai dati tecnografici, interrogare i profili tecnologici aziendali e recuperare informazioni di mercato direttamente in Amazon Quick tramite linguaggio naturale.

Amazon Quick supporta diversi metodi di autenticazione per HG Insights. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.

• App OAuth predefinita: utilizza un'applicazione OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account HG Insights.

• App OAuth personalizzata: utilizza un'applicazione OAuth gestita dal cliente. Questa opzione offre all'organizzazione il pieno controllo sulla configurazione OAuth.

• Service-to-Service OAuth: utilizza le credenziali del client per l'autenticazione da server a server senza l'interazione dell'utente. Adatto per flussi di lavoro automatizzati.

• Chiave API: utilizza una chiave API per l'autenticazione.

Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

• Un account HG Insights attivo con accesso ai prodotti di dati che desideri interrogare.

• Per l'app OAuth personalizzata o OAuth: credenziali Service-to-Service OAuth dal tuo account HG Insights.

• Per la chiave API: una chiave API HG. Insights-issued

• Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.

Configurazione di HG Insights

Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e procedi con. Configurazione del connettore in Amazon Quick

Per l'app OAuth personalizzata o l'autenticazione Service-to-Service OAuth, registra un client OAuth nel tuo account HG Insights Phoenix e aggiungi l'URL di callback Amazon Quick come URI di reindirizzamento. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback Sostituisci {region} con la tua regione (ad esempio,).AWSus-east-1 Per istruzioni dettagliate, consulta la documentazione di Phoenix by HG Insights. Registra l'ID cliente e il segreto del cliente: ti servono quando configuri Amazon Quick. Per l'autenticazione tramite chiave API, genera una chiave API dal tuo account Phoenix.

Configurazione del connettore in Amazon Quick

Connect dalla scheda Available

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda Disponibile senza configurazioni aggiuntive.

1. Nella console Amazon Quick, scegli Connettori.

2. Nella scheda Disponibile, trova HG Insights e scegli Connect.

3. Completa il flusso di accesso a HG Insights e concedi le autorizzazioni richieste.

Per configurare un connettore con uno degli altri metodi di autenticazione, usa la scheda Crea per il tuo team come descritto di seguito.

Crea dalla scheda Crea per il tuo team

1. Nella console Amazon Quick, scegli Connettori.

2. Scegli la scheda Crea per il tuo team.

3. Trova e scegli HG Insights.

4. Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.

5. Per Tipo di connessione, scegli Rete pubblica.

6. Per la configurazione OAuth, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.

   1. Per l'app OAuth predefinita:

      Non sono necessarie credenziali aggiuntive. Seleziona Successivo per continuare.

   2. Per l'app OAuth personalizzata, configura i seguenti campi:

      • ID client: l'ID client dell'app HG Insights OAuth.

      • Client OAuth pubblico (opzionale): seleziona questa opzione se l'app HG Insights OAuth è configurata come client pubblico (nessun client segreto).

      • Segreto del cliente: il segreto del client dell'app HG Insights OAuth.

      • URL del token: l'endpoint del token. Impostazione predefinita: https://phoenix.hginsights.com/api/ai/token

      • URL di autorizzazione: l'endpoint di autorizzazione. Impostazione predefinita: https://phoenix.hginsights.com/api/ai/authorize

      • URL di reindirizzamento: Pre-filled con l'URL di callback di Amazon Quick.

   3. Per Service-to-ServiceOAuth, configura i seguenti campi:

      • ID client: l'ID client dell'app HG Insights OAuth.

      • Segreto del cliente: il segreto del cliente dell'app HG Insights OAuth.

      • URL del token: l'endpoint del token. Impostazione predefinita: https://phoenix.hginsights.com/api/ai/token

   4. Per API Key, configura i seguenti campi:

      • Chiave API: la chiave API HG Insights.

      • Email (opzionale): l'indirizzo e-mail associato alla chiave API.

7. Scegli Next (Successivo).

8. Se hai scelto l'app OAuth predefinita o l'app OAuth personalizzata, si apre una finestra di autorizzazione di HG Insights. Controlla le autorizzazioni richieste e scegli Consenti.

9. Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).

10. Nella pagina Pubblica, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.

11. Seleziona Pubblica.

Operazioni disponibili

Dopo aver configurato il connettore, sono disponibili le azioni esposte da HG Insights. Per visualizzare l'attuale set di azioni per il tuo connettore, vai alla visualizzazione Azioni disponibili del connettore nella console Amazon Quick.

Gestione e risoluzione dei problemi

Per modificare, condividere o eliminare il connettore, consultaGestione delle integrazioni esistenti.

Problemi di autenticazione

• Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata): verifica che il tuo account HG Insights sia attivo. Per l'app OAuth personalizzata, verifica che l'URI di reindirizzamento nell'app HG Insights OAuth corrisponda all'URL di callback Amazon Quick.

• Credenziali client non valide (app OAuth personalizzata o Service-to-Service OAuth): verifica che l'ID client e il segreto del client corrispondano ai valori dell'app HG Insights OAuth.

• L'autenticazione della chiave API non riesce: verifica che la chiave API non sia stata revocata.