Zuletzt aktualisiert am: Januar 31, 2023
Mit dem HubSpot-API-Schlüssel können Ihre Entwickler benutzerdefinierte Anwendungen mit HubSpot-APIs erstellen. Jeder Schlüssel ist spezifisch für einen HubSpot-Account und nicht für einen Benutzer. Es ist immer nur ein Schlüssel zulässig.
Bitte beachten Sie: eines vom 30. November 2022, HubSpot API Keys sind veraltet und werden nicht mehr unterstützt. Die fortgesetzte Verwendung von HubSpot API-Schlüsseln stellt ein Sicherheitsrisiko für Ihren Account und Ihre Daten dar. Während dieser Abschreibungsphase kann HubSpot Ihren Schlüssel jederzeit deaktivieren.
Sie sollten sich stattdessen mit einem privaten App-Zugangs-Token oder OAuth authentifizieren. Erfahren Sie mehr über diese Änderung und wie Sie eine API-Schlüssel-Integration migrieren, um stattdessen eine private App zu verwenden.
API-Schlüssel aufrufen
Sie benötigen Super-Admin-Berechtigungen, um auf die API-Schlüssel Ihres Accounts zuzugreifen.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Wenn noch nie ein Schlüssel für Ihren Account generiert wurde, klicken Sie auf „API-Schlüssel generieren“.
- Wenn Sie bereits einen API-Schlüssel generiert haben, klicken Sie auf „Anzeigen“, um Ihren Schlüssel anzuzeigen.
- Klicken Sie bei angezeigtem Schlüssel auf „Kopieren“, um ihn zu kopieren. Sie können den Schlüssel dann einfügen, um ihn Ihren Entwicklern bereitzustellen oder in Ihren Anwendungen zu nutzen.
API-Schlüssel rotieren
Stellen Sie Ihren API-Schlüssel einem Entwickler bereit, kann dieser umfangreiche Änderungen an Ihrem Account über die API von HubSpot vornehmen und beispielsweise protokollierte E-Mails von verknüpften E-Mail-Konten und andere Drittanbieter-Daten lesen.
Um mehr Sicherheit zu gewährleisten, sollten Sie Ihren HubSpot-API-Schlüssel alle sechs Monate rotieren. Das Rotieren Ihres HubSpot-API-Schlüssels bewirkt, dass der vorhandene API-Schlüssel deaktiviert und ein neuer generiert wird. HubSpot zeigt das Alter der API-Schlüssel an und empfiehlt einen Zeitpunkt für das Rotieren Ihres HubSpot-API-Schlüssels.
Alle 180 Tage werden E-Mail-Benachrichtigungen an Super-Admins und Benutzer gesendet, die den API-Schlüssel zuletzt erstellt oder rotiert haben, sofern der API-Schlüssel in diesem Zeitraum nicht rotiert wurde.
Dies kann zwar zu einer Unterbrechung des Betriebs führen und Arbeit verursachen, aber es bietet auch zusätzliche Sicherheit, indem Sie schädliche Anwendungen daran hindern, Ihre HubSpot-Informationen mit Ihrem vorhandenen API-Schlüssel aufzurufen.
So rotieren Sie Ihren HubSpot-API-Schlüssel:
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Klicken Sie auf das Dropdown-Menü „Aktionen“ und wählen Sie „Schlüssel rotieren“ aus.
- Klicken Sie auf „Diesen Schlüssel jetzt rotieren und verfallen lassen“. Aktivieren Sie das reCAPTCHA-Kontrollkästchen. Ihr bestehender Schlüssel wird deaktiviert und ein neuer API-Schlüssel wird erstellt.
- Klicken Sie auf „Kopieren“ und ersetzen Sie den deaktivierten API-Schlüssel, den Ihre Anwendungen verwendet haben, mit diesem neuen API-Schlüssel.
API-Aufrufe mit dem deaktivierten HubSpot-API-Schlüssel schlagen jetzt fehl und alle Anwendungen, die den Schlüssel verwenden, können nicht mehr auf Ihre Informationen zugreifen.
Das Rotieren Ihres API-Schlüssels hat keinen Einfluss auf Ihre Verknüpfung mit der Salesforce-Integration. Wenn Sie jedoch eine benutzerdefinierte Integration installiert haben, müssen Sie Ihren API-Schlüssel nach dem Rotieren aktualisieren.
Verknüpfte Apps, die über den App Marketplace installiert wurden, sind nicht betroffen, wenn Sie Ihren API-Schlüssel rotieren.
API-Schlüssel deaktivieren
Beim Deaktivieren Ihres API-Schlüssels wird kein neuer Schlüssel erstellt. API-Aufrufe mit dem deaktivierten HubSpot-API-Schlüssel schlagen fehl und alle Anwendungen, die den Schlüssel verwenden, können nicht mehr auf Ihre Informationen zugreifen.
So deaktivieren Sie Ihre API-Schlüssel:- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Klicken Sie auf das Dropdown-Menü „Aktionen“.
- Klicken Sie auf „Schlüssel deaktivieren“ und dann auf „Diesen Schlüssel jetzt deaktivieren“. Aktivieren Sie das reCAPTCHA-Kontrollkästchen.
API-Prüfprotokoll anzeigen
Sie können im Bereich „Protokoll“ anzeigen, welcher Benutzer zu welchem Zeitpunkt den API-Schlüssel des Accounts aufgerufen, erstellt oder deaktiviert hat.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Klicken Sie auf die Registerkarte „Prüfprotokoll“.
Aufrufprotokoll für Ihren API-Schlüssel anzeigen
Um das Debugging einer Ihrer Integrationen zu erleichtern oder die Einhaltung der API-Nutzungsrichtlinien von HubSpot zu gewährleisten, können Sie ein Protokoll Ihrer API-Schlüssel-Aufrufe für die vorherigen 7 Tage anzeigen.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Zeigen Sie auf der Registerkarte „API-Aufrufe“ alle Aktivitäten der letzten 7 Tage an.
