Single-Sign-On (SSO) für den Zugriff auf privaten Content einrichten

Single-Sign-On (SSO) bietet die Möglichkeit, sich bei verschiedenen Anwendungen sicher mit einem Benutzernamen und einem Passwort anzumelden. Die Verwendung von SSO für privaten Content optimiert den Zugriff auf privaten Content und stellt sicher, dass nur interne Besucher auf Ihren Content zugreifen können. 

Ihr IT-Administrator kann eine HubSpot-Anwendung in Ihrem Identity Provider-Konto wie Google oder Okta einrichten. Mitglieder Ihrer Organisation mit Zugriff auf die HubSpot-Anwendung innerhalb Ihres Identity Provider-Kontos können sich mit SSO anmelden, um den privaten Content anzuzeigen. 

Sie können weiter verfeinern, welche Personen Zugriff auf bestimmte Inhalte haben, basierend auf ihren Segment-Zugriffsberechtigungen in Ihrem HubSpot-Account . Um auf Content nach Segmentmitgliedschaft zugreifen zu können, müssen diese Mitglieder Ihres Teams über Kontaktdatensätze in Ihrem HubSpot-Account verfügen.

Bitte beachten: Seit dem 5. Februar 2025 können Sie SSO nicht mehr für neue JWT-Anwendungen verwenden. JWT-basierte Anwendungen, die vor diesem Datum für SSO konfiguriert wurden, sind davon nicht betroffen. Es wird empfohlen, in Zukunft stattdessen eine Open ID Connect (OIDC)-Anwendung zu verwenden.

Bevor Sie loslegen 

Bevor Sie mit dieser Funktion beginnen, sollten Sie sich im Voraus darüber im Klaren sein, welche Schritte unternommen werden sollten und welche Einschränkungen die Funktion mit sich bringt und welche Konsequenzen sich daraus ergeben können. 

Dies sind die Voraussetzungen:

• Dieser Einrichtungsprozess muss von einem IT-Administrator durchgeführt werden, der Erfahrung mit der Erstellung von Anwendungen in Ihrem Identitätsanbieter-Account und hat und die Berechtigung hat, Website-Einstellungen in HubSpot zu bearbeiten. 
• SSO kann für eine von HubSpot gehostete Subdomain pro Identity Provider-Konto konfiguriert werden. Die besten Ergebnisse erzielen Sie, wenn Sie eine Subdomain ausschließlich für SSO-Mitgliedschaften zuweisen.

Einschränkungen und Wissenswertes

• SSO für privaten Content ist für die folgenden Content-Typen verfügbar:
  • Content Hub Professional- und Enterprise-Accounts können SSO für Blogs, Landingpages und Website-Seiten einrichten.
  • Service Hub Professional- und Enterprise-Accounts können SSO für Wissensdatenbankartikel und Kundenportale einrichten.
• Benachrichtigungs-E-Mails und Anmeldeseiten für privaten Content mit SSO-Zugriff werden von Ihrem Identity Provider-Konto und nicht in den Einstellungen für privaten Content in HubSpot geregelt.
• Privater Content, der SSO voraussetzt, wird von Suchmaschinen nicht katalogisiert. Er kann nur von Kontakten angezeigt werden, die Zugriff haben und angemeldet sind.
• Für Seitenelemente wie Bilder und Formulare ist SSO nur erforderlich, um als Teil der Seite darauf zuzugreifen. Wenn die URLs zu den Elementen selbst separat bereitgestellt werden, ist kein SSO für den Zugriff erforderlich. Erfahren Sie mehr über das Festlegen der URL-Sichtbarkeit für Elemente im Dateien-Tool. 
• Wenn Sie SSO für eine Domain aktivieren, für die zuvor eine Mitgliederregistrierung erforderlich war, verwendet SSO Ihre ursprünglichen Mitgliedersegmente. Wenn Sie SSO wieder deaktivieren, ist für den Content wieder eine Mitgliederregistrierung für dieselben Segmente erforderlich.

SSO für privaten Content in HubSpot in Ihrem Identity Provider-Konto einrichten

Um SSO für in Hubspot gehosteten privaten Content einzurichten, erstellt Ihr IT-Administrator eine neue Anwendung für den Zugriff auf HubSpot-Content. Um diesen Vorgang abzuschließen, verwendet Ihr IT-Administrator Werte aus Ihren Einstellungen für privaten Content in HubSpot. 

Die erforderlichen Schritte und Felder für das Hinzufügen einer neuen Anwendung können je nach Identity Provider variieren. Im Folgenden finden Sie allgemeine Anweisungen zur Einrichtung von SSO für privaten Content.

SSO für eine SAML-basierte Anwendung einrichten 

So erstellen Sie eine neue SAML-Anwendung für in HubSpot gehosteten privaten Content bei Ihrem Identity Provider:

1. Melden Sie sich beim Identity Provider-Konto an.
2. Navigieren Sie zu Ihren Anwendungen innerhalb Ihres Identity Provider-Kontos.
3. Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
4. Navigieren Sie im Menü der linken Seitenleiste zu Content > Privater Content.
5. Klicken Sie oben auf der Seite auf das Dropdown-Menü „Domain zum Bearbeiten auswählen:“ und wählen Sie eine Subdomain aus.
6. Klicken Sie im Abschnitt Single-Sign-On (SSO) auf „SSO einrichten“.
7. Klicken Sie im rechten Bereich auf das Dropdown-Menü Authentifizierungsprotokoll und wählen Sie SAML aus.
8. Kopieren Sie im Abschnitt Schritt 1 im rechten Bereich den Zielgruppen-URI (Service Provider Entity ID) und Anmelde-URL, ACS, Empfänger oder Weiterleitung.

9. In Ihrem Identity Provider-Konto:
   • Fügen Sie den Zielgruppen-URI (Service Provider Entity ID)  und Anmelde-URL, ACS, Empfänger oder Weiterleitung,  die aus HubSpot kopiert wurden, in die entsprechenden Felder ein.
   • Kopieren Sie die IDs für Identitätsanbieter-ID oder Aussteller-URL, URL des Identity Server für Single-Sign-On und X.509-Zertifikat.
10. Fügen Sie in Ihrem HubSpot-Account im Abschnitt Schritt 2 die Werte für Identitätsanbieter-ID oder Aussteller-URL, URL des Identity Server für Single-Sign-On und X.509-Zertifikat in die entsprechenden Felder ein. Sie können auch eine XML-Datei hochladen, um die Felder auszufüllen.
11. Klicken Sie auf Verifizieren.

12. Sobald die Verifizierung abgeschlossen ist, sehen Sie eine Bestätigung, dass Single-Sign-On für Ihre Domain in den Einstellungen für privaten Content aktiviert ist. 

SSO für eine OpenID Connect (OIDC)-Anwendung einrichten

So erstellen Sie eine neue OpenID Connect (OIDC)-Anwendung für in HubSpot gehosteten privaten Content bei Ihrem Identity Provider:

1. Melden Sie sich beim Identity Provider-Konto an.
2. Navigieren Sie zu Ihren Anwendungen innerhalb Ihres Identity Provider-Kontos.
3. Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
4. Navigieren Sie im Menü der linken Seitenleiste zu Content > Privater Content.
5. Klicken Sie oben auf der Seite auf das Dropdown-Menü „Domain zum Bearbeiten auswählen:“ und wählen Sie eine Subdomain aus.
6. Klicken Sie im Abschnitt Single-Sign-On (SSO) auf „SSO einrichten“.
7. Klicken Sie im rechten Bereich auf das Dropdown-Menü Authentifizierungsprotokoll und wählen Sie OIDC aus.
8. Klicken Sie neben Weiterleitungs-URI für die Anmeldung auf Kopieren, um den Wert in die Zwischenablage zu kopieren.

9. Fügen Sie in Ihren Identity Provider den Wert hinzu, den Sie aus dem Feld Weiterleitungs-URI für die Anmeldung kopiert haben. Sammeln Sie dann Werte für die folgenden Felder: 
   • • Client-Geheimnis
     • Client-ID
     • Anbieter-Autorisierungsendpunkt
     • Anbieter-Tokenendpunkt
10. Geben Sie in Ihrem HubSpot-Account die Werte ein, die Sie über das Identity Provider-Konto erfasst haben.
11. Klicken Sie auf Verifizieren.

12. Sobald der Verifizierungsprozess abgeschlossen ist, sehen Sie eine Bestätigung, dass Single-Sign-On für Ihre Domain in den Einstellungen für privaten Content aktiviert ist. 

SSO für Ihren Content verlangen

Es gibt zwei Optionen für das Verlangen von privatem Content mit SSO:

• Privat – Single-Sign-On (SSO) erforderlich: Alle Benutzer Ihres Identity Providers mit Zugriff auf die HubSpot-Anwendung können sich mit SSO anmelden, um den privaten Content anzuzeigen.
• Privat – Single-Sign-On (SSO) mit Segmenten erforderlich: Personen in Ihrer Identitätsanbieter-Organisation, die auch über bestimmte Segment-Zugriffsberechtigungen verfügen, können sich mit SSO anmelden, um privaten Content anzuzeigen. Diese Personen müssen Zugriff auf die HubSpot-Anwendung in Ihrem Identity Provider-Konto (z. B. Okta oder Google) haben, sie müssen jedoch keine Benutzer in Ihrem HubSpot-Account sein.

SSO für einen Blog verlangen

Verlangen Sie SSO für Blogs, die auf der Subdomain gehostet werden, die Sie in Ihrem Identitätsanbieterkonto verknüpft haben. Die Aktivierung von SSO für einen bestimmten Blog wirkt sich auf alle Blog-Beiträge in diesem Blog aus. Es ist nicht möglich, SSO für einen bestimmten Blog-Beitrag zu verlangen.

Bitte beachten Sie: Wenn Sie SSO für einen Blog benötigen, der bereits private Inhalte mit Mitgliederregistrierung enthält, ist dieser Blog für diese Kontakte nicht mehr zugänglich.

So richten Sie SSO für einen Blog ein:

1. Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
2. Gehen Sie im Menü der linken Seitenleiste zu Content > Blog.
3. Klicken Sie oben links auf das Dropdown-Menü „Wählen Sie einen zu ändernden Blog aus“ und wählen Sie einen Blog aus, der auf der bei Ihrem Identity Provider eingerichteten Subdomain gehostet wird.
4. Richten Sie im Abschnitt „Zielgruppenzugriff steuern“ SSO ein:
   • Wählen Sie „Privat – Single-Sign-On (SSO) erforderlich“ aus, um allen Benutzern Ihres Identity Providers mit Zugriff auf die HubSpot-Anwendung Zugriff zu gewähren.
   • Wählen Sie „Privat – Single-Sign-On (SSO) mit Segmenten erforderlich“ aus, um Benutzern Ihres Identity Providers mit Zugriff auf die HubSpot-Anwendung und spezifische Segmentzugehörigkeiten Zugriff zu gewähren. Wählen Sie dann die Segmente aus, die Zugriff auf diesen Content haben sollen.
5. Klicken Sie unten links auf „Speichern“.