Integration mit HG Insights

Mit dem HG Insights Action Connector können Sie direkt in Amazon Quick in natürlicher Sprache auf technografische Daten zugreifen, Technologieprofile von Unternehmen abfragen und Marktinformationen abrufen.

Amazon Quick unterstützt mehrere Authentifizierungsmethoden für HG Insights. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.

• Standard-OAuth-Anwendung — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Benutzer authentifizieren sich direkt mit ihrem HG Insights-Konto.

• Benutzerdefinierte OAuth-App — Verwendet eine vom Kunden verwaltete OAuth-Anwendung. Diese Option gibt Ihrem Unternehmen die volle Kontrolle über die OAuth-Konfiguration.

• Service-to-Service OAuth — Verwendet Client-Anmeldeinformationen für die Server-zu-Server-Authentifizierung ohne Benutzerinteraktion. Geeignet für automatisierte Workflows.

• API-Schlüssel — Verwendet einen API-Schlüssel zur Authentifizierung.

Weitere Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unterAuthentifizierungsmethoden.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.

• Ein aktives HG Insights-Konto mit Zugriff auf die Datenprodukte, die Sie abfragen möchten.

• Für benutzerdefinierte OAuth-Apps oder OAuth: Service-to-Service OAuth-Anmeldeinformationen von Ihrem HG Insights-Konto.

• Für API-Schlüssel: Ein HG-API-Schlüssel. Insights-issued

• Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.

Konfiguration von HG Insights

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden, überspringen Sie diesen Abschnitt und fahren Sie fort mit. Den Connector in Amazon Quick einrichten

Registrieren Sie für die benutzerdefinierte OAuth-App oder die Service-to-Service OAuth-Authentifizierung einen OAuth-Client in Ihrem HG Insights Phoenix-Konto und fügen Sie die Amazon Quick Callback-URL als Umleitungs-URI hinzu. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback Ersetzen Sie es durch Ihre {region}AWS Region (z. B.). us-east-1 Eine schrittweise Anleitung finden Sie in der Dokumentation zu Phoenix by HG Insights. Notieren Sie sich die Client-ID und das Client-Geheimnis — Sie benötigen sie, wenn Sie Amazon Quick konfigurieren. Generieren Sie für die API-Schlüsselauthentifizierung einen API-Schlüssel aus Ihrem Phoenix-Konto.

Den Connector in Amazon Quick einrichten

Über die Registerkarte „Verfügbar“ eine Connect

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über die Registerkarte Verfügbar eine Verbindung herstellen.

1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

2. Suchen Sie auf der Registerkarte Verfügbar nach HG Insights und wählen Sie Connect aus.

3. Füllen Sie den Anmeldevorgang für HG Insights aus und erteilen Sie die angeforderten Berechtigungen.

Um einen Connector mit einer der anderen Authentifizierungsmethoden zu konfigurieren, verwenden Sie den Tab Für Ihr Team erstellen, wie unten beschrieben.

Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“

1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

2. Wählen Sie den Tab „Für Ihr Team erstellen“.

3. Suchen und wählen Sie HG Insights.

4. Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.

5. Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.

6. Wählen Sie für die OAuth-Konfiguration eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.

   1. Für die Standard-OAuth-App:

      Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie Next (Weiter), um fortzufahren.

   2. Konfigurieren Sie für die benutzerdefinierte OAuth-App die folgenden Felder:

      • Client-ID — Die Client-ID aus Ihrer HG Insights OAuth-App.

      • Öffentlicher OAuth-Client (optional) — Wählen Sie diese Option, wenn Ihre HG Insights OAuth-App als öffentlicher Client konfiguriert ist (kein geheimer Client).

      • Geheimer Client — Der geheime Client-Schlüssel aus Ihrer HG Insights OAuth-App.

      • Token-URL — Der Token-Endpunkt. Standard: https://phoenix.hginsights.com/api/ai/token

      • Autorisierungs-URL — Der Autorisierungsendpunkt. Standard: https://phoenix.hginsights.com/api/ai/authorize

      • Weiterleitungs-URL — Pre-filled mit der Amazon Quick Callback-URL.

   3. Konfigurieren Sie für Service-to-ServiceOAuth die folgenden Felder:

      • Client-ID — Die Client-ID aus Ihrer HG Insights OAuth-App.

      • Kundengeheimnis — Das Client-Geheimnis aus Ihrer HG Insights OAuth-App.

      • Token-URL — Der Token-Endpunkt. Standard: https://phoenix.hginsights.com/api/ai/token

   4. Konfigurieren Sie für den API-Schlüssel die folgenden Felder:

      • API-Schlüssel — Der API-Schlüssel von HG Insights.

      • E-Mail (optional) — Die mit dem API-Schlüssel verknüpfte E-Mail-Adresse.

7. Wählen Sie Weiter aus.

8. Wenn Sie die Standard-OAuth-App oder die benutzerdefinierte OAuth-App ausgewählt haben, wird ein Autorisierungsfenster von HG Insights geöffnet. Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Zulassen.

9. Überprüfen Sie auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.

10. Wählen Sie auf der Seite Veröffentlichen aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.

11. Wählen Sie Publish.

Verfügbare Aktionen

Nachdem Sie den Connector eingerichtet haben, sind die von HG Insights bereitgestellten Aktionen verfügbar. Um die aktuellen Aktionen für Ihren Connector zu sehen, gehen Sie in der Amazon Quick-Konsole zur Ansicht Verfügbare Aktionen des Connectors.

Verwaltung und Problembehebung

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.

Probleme bei der Authentifizierung

• Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass Ihr HG Insights-Konto aktiv ist. Stellen Sie für die benutzerdefinierte OAuth-App sicher, dass die Weiterleitungs-URI in Ihrer HG Insights OAuth-App mit der Amazon Quick Callback-URL übereinstimmt.

• Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App oder Service-to-Service OAuth) — Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel mit den Werten in Ihrer HG Insights OAuth-App übereinstimmen.

• API-Schlüsselauthentifizierung schlägt fehl — Stellen Sie sicher, dass der API-Schlüssel nicht gesperrt wurde.