Single Sign-On för HubSpot-applikationen möjliggör säker inloggning på HubSpot CMS-målsidor, bloggar och andra sidor med Googleas OAuth-leverantör. Den stöder avancerade Single Sign-On (SSO) funktioner som t.ex användarprofil Attributmappning, och så vidare

Här kommer vi att gå igenom en guide för att konfigurera SSO mellan HubSpot och Google. I slutet av den här guiden bör användare kunna logga in på HubSpot från Google. Om du vill veta mer om Single Sign-On för HubSpot och andra HubSpot-integrationer kan du klicka här.

Kontakta oss gärna på hubapps@xecurify.com för att veta mer om hur man installerar Single Sign-On för HubSpot-appen från miniOrange.

Förutsättningar: Ladda ner och installation

• Logga in på ditt HubSpot-konto som administratör.
• Klicka här att installera Enkel inloggning för HubSpot . Eller så kan du installera vår app från HubSpot App Marketplace .

Steg för att konfigurera enkel inloggning för HubSpot-inloggning med Google som identitetsleverantör

Steg 1: Ställ in Google som OAuth-leverantör

• Gå till https://console.developers.google.com/ och registrera dig/logga in.
• Klicka på Välj projekt för att skapa ett nytt Google Apps-projekt kommer du att se en popup med listan över alla dina projekt.

• Du kan klicka på Nytt projekt knappen för att skapa ett nytt projekt.

• Ange ditt projektnamn under Projektnamn fältet och klicka på Skapa.

• Gå till navigationsmenynAPI:er och tjänsterReferenser.

• Klicka på Skapa Referenser -knappen och välj sedan OAuth-klient-ID från de alternativ som tillhandahålls.

• Om du står inför en varning som säger att för att skapa ett OAuth-klient-ID måste du ange ett produktnamn på samtyckesskärmen (som visas i bilden nedan). Klicka på Skärmen Konfigurera samtycke knapp.

• Välj hur du vill konfigurera och registrera din app och klicka på skapa knapp.

• Ange nödvändiga uppgifter som t.ex Appens namn, e-post för användarsupport. och klicka på Spara och fortsätt knapp.

• Nu för att konfigurera omfattningar, klicka på Lägg till eller ta bort scopes knapp.

• Välj nu Scopes för att ge ditt projekt åtkomst till specifika typer av privat användardata från deras Google-konto och klicka på Uppdatering knapp.

• Gå till Fliken Inloggningsuppgifter och klicka på Skapa Referenser knapp. Välj Webbapplikation från rullgardinsmenyn för att skapa en ny applikation.

• Ange det namn du vill ha för ditt klient-ID under namnfältet och ange Omdirigera/återuppringnings-URI från miniOrange OAuth Client plugin/modul under Auktoriserad omdirigering URI-fältet och klicka på Skapa knapp.

• Du kommer att se en popup med klient-ID och klienthemlighet. Kopiera din kund-ID och Klienthemlighet och spara den i din miniOrange OAuth Client-plugin-konfiguration.

Steg 2: Konfigurera HubSpot som OAuth-klient

• Gå till miniOrange Single Sign-On (SSO) app och logga in med dina referenser.
• Välj ditt konto genom att klicka på Välj konto knapp.

• Efter det klickar du på höger ikon för att komma åt applikationen.

• Gå till miniOranges instrumentpanel för Single Sign On-appen och klicka på Appkonfigurationer fliken.

• Här, välj din applikation och klicka på den. Om din app inte finns här kan du skapa en anpassad OAUTH 2.0 eller OIDC (Open ID Connect-protokoll) app enligt din leverantörs implementering.

• Ange Text för inloggningsknapp och kopiera Återuppringnings-URL för att ställa in den identitetsleverantör (tredjepartsapp) som du vill autentisera med.

• Nu, för att konfigurera enkel inloggning (OAuth SSO) från identitetsleverantören, måste du ange Klient-ID, klienthemlighet,och Omfattning, och aktivera Skicka in Header och endpoints från google (Se tabellen nedan).

kund-ID	Klicka här
Klienthemlighet	Klicka här
Omfattning	openid e-postprofil
Rubrik / Kroppsinställning	Aktivera parameteralternativet Skicka i kropp
Auktorisera slutpunkt:	https://accounts.google.com/o/oauth2/auth
Åtkomsttokens slutpunkt:	https://www.googleapis.com/oauth2/v4/token
Få användarinformation slutpunkt:	https://www.googleapis.com/oauth2/v1/userinfo


• När du har fyllt i alla uppgifter, klicka på Spara och testa konfiguration knapp.

• Vid framgångsrik autentisering kommer du att se listan över Användarprofildetaljer.

Steg 3: Konfigurera sidbegränsning i HubSpot (webbplats, målsidor, bloggar, kunskapsbas)

Vår Sidbegränsningsfunktion gör att du kan skydda din HubSpot-webbplats från obehörig åtkomst. Det är användbart för att säkra känslig information. Med den här metoden kan du begränsa åtkomsten till HubSpot-sidor/-innehåll. Besökare måste logga in innan de kommer åt HubSpot-sidor.

• När du har fått testkonfigurationsresultatet klickar du på Sidbegränsning fliken.

• Välj kryssrutan bredvid sidan du vill skydda från obehöriga användare och klicka Save för att spara informationen.

• När du går till sidans webbadress som du har begränsat kommer du att se inloggningsfönstret för din identitetsleverantör där du anger dina referenser.

• Efter att ha loggat in kommer du att omdirigeras till webbsidan.

Steg 4: Konfigurera Contact Sync i HubSpot

Kontaktsynkronisering är en kraftfull funktion som möjliggör sömlös integration och synkronisering av kontaktinformation mellan HubSpot och externa plattformar eller applikationer. Med Contact Sync kan du säkerställa att din kunddata är uppdaterad, korrekt, och konsekvent över flera system, vilket sparar tid och eliminerar manuell datainmatning.

• För att synkronisera kontaktuppgifterna, gå till APP-konfigurationer och välj leverantör du skapade.
• Klicka på Redigera ikonen under Kontakta Attribut Mapping alternativ.

• Du kommer att se HubSpot-kontaktattribut och IDP-attribut alternativet, Mappa ditt HubSpot-kontaktattribut med ett tredjepartsprogram/IDP-attribut mottas i testkonfigurationsresultatet. Dessutom, om flera attribut krävs kan du lägga till dem med hjälp av Anpassad attributmappning alternativ.

• När du har lagt till alla attribut, se till att du har aktiverat Kontaktsynkronisering alternativ. Klicka på Save knapp.

• Du kan nu hitta kontakt i HubSpot Contacts. Detta är ett bra sätt att generera leads, eftersom det låter dig snabbt och enkelt lägga till nya kontakter till dina HubSpot försäljnings- och marknadsföringspipelines. Kontaktsynkronisering låter dig säkerställa att din HubSpot-kontot är alltid uppdaterat med den senaste informationen om dina leads och kunder (webbplatsbesökare), vilket kan hjälpa dig att generera fler kvalificerade potentiella kunder.

Steg 5: Hur man avinstallerar vår app från en HubSpot-portal

• För att avinstallera vår app, gå till ditt HubSpot-konto och klicka på Inställningar ikonen.

• Gå till integrationer och klicka på Anslutna appar.

• Du kommer att se listan över appar, välj vår app och klicka på Handlingar knapp. Och klicka sedan på unistall alternativ.

• Skriv "avinstallera" nedan för att fortsätta och klicka avinstallera knapp.

Felsökning / vanliga frågor

Jag får följande: {"status":"failed","message":"Fel vid hämtning av token från OAuth-leverantören."}

• Se till att du har kontrollerat en eller båda av följande kryssrutor i "HubSpot App-konfiguration”Inställning.

• Om din IdP behöver inloggningsuppgifterna i rubriken, måste du kontrollera Sidhuvud kryssrutan.
• Save konfigurationen och klicka sedan testkonfiguration.
• Om detta inte löser ditt problem kan du prova att välja båda Sidhuvud och Kaross kryssrutor.
• På samma sätt, om din IdP behöver referenserna i kroppen, måste du välja Kaross kryssrutan.
• När du har markerat lämpliga kryssrutor får du attributtabellen i testkonfigurationsfönstret.

Min testkonfiguration lyckades men när jag försöker logga in fastnar jag i en omdirigeringsslinga.

Det finns ett par anledningar till varför detta kan hända:

1. Cachning är aktiverat på webbplatsen.

När automatisk omdirigering är aktiverat, omdirigeras användaren till IDP-inloggningssidan och efter att ha loggat in tillbaka till huvudsidan, men eftersom caching aktiveras omdirigeras den till IDP-inloggningssidan, vilket innebär en loop.

2. HTTP/HTTPS-avvikelse:

Detta händer när HTTPS inte tillämpas på webbplatsen utan konfigureras på IDP-sidan med HTTPS URL. Detta kan lösas genom att upprätthålla HTTPS på webbplatsen genom att definiera en omdirigeringsregel i .htaccess-filen eller på Apache-nivå.

3. Cookieförfalskning:

Cookien som skapas av plugin-programmet efter att användaren loggat in ändras av ett annat plugin som gör att användaren inte loggar in på WordPress-webbplatsen utan sessionen skapas på IDP.

Får fel: "Ogiltigt svar"

Det kan finnas 2 möjligheter:

1. Antingen stöder din app OAuth 2.0-protokoll och du har konfigurerat med OpenID Connect-protokoll och vice versa. I det här fallet, om du har konfigurerat appen med Custom OAuth2.0-appen, konfigurera om den med Custom OpenID Connect-appen och om du har konfigurerat appen med Custom OpenID Connect-appen, konfigurera om den med Custom OAuth 2.0-appen. Det borde lösa det här problemet åt dig.
2. Om ovanstående lösning inte fungerar är den andra möjligheten att din app/leverantör inte följer standardprotokollet OAuth 2.0/OpenID Connect. Kontakta i så fall hubapps@xecurify.com med din app/leverantörs begäran/svarsformatsdokumentation så återkommer teknikern till dig med en lösning.

Jag får felmeddelandet "Ogiltigt svar mottaget"

För att åtgärda det här problemet, konfigurera rätt token och användarinformationsändpunkt i HubSpot SSO-applikationens slutpunktstabell. Du kan bekräfta det korrekta formatet för endponit från HÄR.

Ytterligare resurser

• Enkel inloggning för HubSpot från miniOrange
• Wordpress Single Sign-On för HubSpot av miniOrange
• AWS Cognito Single Sign-On för HubSpot från miniOrange
• HubSpot säkerhet och API-integration