Single-Sign-On (SSO) einrichten

Single-Sign-On (SSO) ermöglicht Ihren Teammitgliedern einen Account für alle Systeme, die Ihr Unternehmen verwendet.

SAML (Security Assertion Markup Language) ist ein offener Standard für die Authentifizierung. Basierend auf dem XML-Format (Extensible Markup Language) verwenden Webanwendungen SAML, um Authentifizierungsdaten zwischen zwei Parteien zu übertragen – dem Identitätsanbieter (IdP) und dem Dienstanbieter (SP).

Sie können auch SSO einrichten und einschränken, welche Anmeldemethoden Benutzer für den Zugriff auf Ihren Account über den Assistenten für Anmeldeeinstellungen verwenden können. Wenn Sie ein SAML-basiertes SSO eingerichtet haben, können Sie es für Benutzer als erforderlich festlegen, sich mit ihren SSO-Anmeldeinformationen bei HubSpot anzumelden.

Bevor Sie loslegen

• Sie müssen ein Super-Admin sein, um SSO für Ihren Account einzurichten.
• Der SSO-Einrichtungsprozess sollte von einem IT-Administrator mit Erfahrung in der Erstellung von Anwendungen in Ihrem Identitätsanbieterkonto ausgeführt werden.

Allgemeine Einrichtung

1. Melden Sie sich beim Konto Ihres Identitätsanbieters an.
2. Navigieren Sie zu Ihren Anwendungen.
3. Erstellen Sie eine neue Anwendung für HubSpot. So rufen Sie die Werte für Zielgruppen-URI und Anmelde-URL, ACS, Empfänger oder Weiterleitung ab:

• • Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
  • Wählen Sie im Menü der Seitenleiste links die Option Sicherheit aus.
  • Klicken Sie auf der Registerkarte Anmeldung, wenn Sie Ihre Portal-Anmeldeeinstellungen nicht konfiguriert haben, auf Portal-Anmeldeeinstellungen einrichten. Oder klicken Sie im Abschnitt Single-Sign-On (SSO ) konfigurieren auf Einrichten. Im rechten Bereich:
    • Der XML-Upload ist für alle SSO-Setups verfügbar. Wählen Sie Ihre Verbundmetadaten per Drag-&-Drop für den Upoload aus, oder klicken Sie dazu auf Datei auswählen. Klicken Sie anschließend auf Verifizieren.
    • Wenn Sie die Daten Ihres Identitätsanbieters manuell eingeben möchten, klicken Sie auf der Registerkarte Alle anderen Identitätsanbieter neben den entsprechzenden Werten auf Kopieren. Danach können Sie die Werte Ihres Identitätsanbieters unten einfügen. Klicken Sie auf Verifizieren. 
    • Wenn Sie Microsoft AD FS verwenden, klicken Sie unter der Registerkarte Microsoft AD FS neben den entsprechzenden Werten auf Kopieren . Danach können Sie die Werte Ihres Identitätsanbieters unten einfügen. Klicken Sie auf Verifizieren. 

Bitte beachten Sie: Wenn Sie Microsoft Entra (ehemals Azure) verwenden, verwenden Sie bitte die Registerkarte Alle anderen Identitätsanbieter, um Ihr SSO zu konfigurieren. 

• Okta
• OneLogin
• Azure Active Directory
• Google

1. Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.

2. Wählen Sie im Menü der linken Seitenleiste die Option Sicherheit aus.

3. Aktivieren Sie auf der Registerkarte Anmeldung im Abschnitt Single-Sign-On konfigurieren das Kontrollkästchen Single-Sign-On verlangen .

1. Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
2. Wählen Sie im Menü der Seitenleiste links „Sicherheit“ aus.
3. Klicken Sie auf der Registerkarte Anmeldung im Abschnitt Single-Sign-On konfigurieren auf Benutzer befreien.

4. Klicken Sie im Dialogfeld auf das Dropdown-Menü Benutzer auswählen und wählen Sie die Benutzer aus, die sich mit ihren HubSpot-Accounts anmelden können. Sie können beispielsweise Partner und Auftragnehmer auswählen, wenn sie nicht über eine SSO-Anmeldung verfügen.
5. Klicken Sie auf Speichern. 

Bitte beachten: Der Benutzer, der den Schalter Single-Sign-On als erforderlich festlegen aktiviert, wird automatisch zu den ausgeschlossenen Benutzern hinzugefügt. Es wird empfohlen, mindestens einen Super-Admin auszuschließen. Für den Fall eines Ausfalls Ihres Identitätsanbieters kann dieser sich anmelden und den Schalter Single-Sign-On als erforderlich festlegen deaktivieren, um allen Benutzern die Anmeldung mit ihren HubSpot-Accounts zu ermöglichen.

Anweisungen zu spezifischen Identitätsanbietern

Okta

Bitte beachten: Sie benötigen Administratorrechte in Ihrer Okta-Instanz. Dieser Vorgang ist nur bei der Classic-UI in Okta verfügbar.

1. Melden Sie sich bei Okta an. Stellen Sie sicher, dass Sie sich in der Verwaltungsinstanz Ihres Okta-Entwicklerkontos befinden.
2. Klicken Sie in der oberen Navigationsleiste auf Applications (Anwendungen ).
3. Klicken Sie auf Anwendung hinzufügen.
4. Suchen Sie nach HubSpot SAML und klicken Sie dann auf Hinzufügen.
5. Klicken Sie im Bildschirm Allgemeine Einstellungen auf Fertig.
6. Klicken Sie auf der Detailseite der Anwendung auf die Registerkarte Sign on (Anmelden ).
7. Klicken Sie unter der Meldung SAML 2.0 is not configured until you complete the setup instructions (SAML 2.0 ist nicht konfiguriert, bis Sie die Installationsanweisungen abgeschlossen haben) auf View Setup Instructions (Setupanweisungen anzeigen). Dies wird eine neue Registerkarte öffnen. Öffnen Sie es, und kehren Sie zur ursprünglichen Registerkarte in Okta zurück.
8. Scrollen Sie auf derselben Registerkarte zu Advanced Sign-on Settings (Erweiterte Anmeldeeinstellungen) und fügen Sie Ihre Hub-ID im Feld für die HubSpot-Portal-ID hinzu. Erfahren Sie, wie Sie auf Ihre Hub-ID zugreifen können.
9. Gehen Sie zu Ihren Benutzereinstellungen. Weisen Sie die neue App allen Benutzern zu, die sich ebenfalls in Ihrem HubSpot-Account befinden, einschließlich sich selbst.
10. Kehren Sie zur Registerkarte View Setup Instructions (Setupanweisungen anzeigen ) zurück. Kopieren Sie die URLs und das Zertifikat und fügen Sie sie in HubSpot in das Feld Identitätsanbieter-ID oder Aussteller-URL , das Feld URL des Identity Server für Single-Sign-On und das Feld X.509-Zertifikat ein.
11. Klicken Sie auf Verifizieren. Sie werden aufgefordert, sich mit Ihrem Okta-Konto anzumelden, um die Konfiguration abzuschließen und Ihre Einstellungen zu speichern.
12. Navigieren Sie nach der Überprüfung Ihres SSO-Setups zu https://app.hubspot.com/login/sso und geben Sie Ihre E-Mail-Adresse ein. HubSpot sucht nach der Single-Sign-On-Konfiguration Ihres HubSpot-Portals und sendet Sie an Ihren Identitätsanbieter, um sich anzumelden. Wenn Sie einen direkten Link zu Ihrem Konto aufrufen, wird auch die Schaltfläche Mit SSO anmelden angezeigt.

OneLogin

Bitte beachten: Sie benötigen Administratorrechte in Ihrer OneLogin-Instanz, um bei Bedarf eine neue SAML 2.0-Anwendung in OneLogin zu erstellen.

1. Melden Sie sich bei OneLogin an.
2. Gehen Sie zu Apps.
3. Suchen Sie nach HubSpot.
4. Klicken Sie auf die App, für die „SAML2.0“ angegeben ist.
5. Klicken Sie oben rechts auf Speichern.
6. Klicken Sie auf die Registerkarte Konfiguration.
7. Fügen Sie im Feld HubSpot-Account-ID Ihre Hub-ID hinzu. Erfahren Sie, wie Sie auf Ihre Hub-ID zugreifen können.
8. Klicken Sie auf die Registerkarte SSO.
9. Kopieren Sie die folgenden Felder von OneLogin und fügen Sie sie in die entsprechenden Felder im SSO-Einrichtungsbereich in HubSpot ein:

• • Kopieren Sie den Wert unter Aussteller-URL und fügen Sie ihn in Identitätsanbieter-ID oder Aussteller-URL ein.
  • Kopieren Sie den Wert unter SAML 2.0 Endpunkt (HTTP) und fügen Sie ihn in URL des Identity Server für Single-Sign-On ein.
  • Klicken Sie unter X.509-Zertifikat auf Details anzeigen, kopieren Sie das Zertifikat und fügen Sie es in X.509-Zertifikat ein.

10. Klicken Sie oben rechts In Ihrem OneLogin-Konto auf Speichern.

Navigieren Sie nach der Überprüfung Ihres SSO-Setups zu https://app.hubspot.com/login/sso und geben Sie Ihre E-Mail-Adresse ein. HubSpot sucht nach der Single-Sign-On-Konfiguration Ihres HubSpot-Portals und sendet Sie an Ihren Identitätsanbieter, um sich anzumelden. Wenn Sie einen direkten Link zu Ihrem Konto aufrufen, wird auch die Schaltfläche Mit SSO anmelden angezeigt.

Microsoft Entra ID

Installieren Sie für Microsoft Entra ID (früher Azure Active Directory)-Benutzer die HubSpot-App im Microsoft Azure Marketplace und befolgen Sie die Anweisungen von Microsoft, um die Integration einzurichten. Auf diese Weise können Sie Microsoft Entra ID verwenden, um den Benutzerzugriff zu verwalten und die einmalige Anmeldung mit HubSpot zu aktivieren.

Navigieren Sie nach der Überprüfung Ihres SSO-Setups zu https://app.hubspot.com/login/sso und geben Sie Ihre E-Mail-Adresse ein. HubSpot sucht nach der Single-Sign-On-Konfiguration Ihres HubSpot-Portals und sendet Sie an Ihren SSO-Anbieter, um sich anzumelden. Wenn Sie einen direkten Link zu Ihrem Konto aufrufen, wird auch die Schaltfläche Mit SSO anmelden angezeigt.