Hur ska integrationen ansluta?
Private apps, public apps, OAuth och Service Keys – en praktisk guide till HubSpots anslutningsalternativ.
Ska integrationen använda en private app, en public app eller något annat? Frågan dyker ofta upp när HubSpot ska kopplas till ett affärssystem. Svaret beror bland annat på om lösningen ska användas i ett eller flera konton och vilka funktioner som behövs. Dessutom förändras HubSpots utvecklarplattform, vilket gör att äldre guider inte alltid beskriver rätt väg för en ny integration.
Skilj på app, distribution och autentisering
En app beskriver en integrerad lösning och dess funktioner. Distribution handlar om var den ska kunna installeras. Autentisering handlar om hur ett anrop visar vilken anslutning det kommer från, medan behörigheterna styr vad anslutningen får göra.
I äldre HubSpot-material förekommer private app och public app som tydliga huvudalternativ. På den nyare utvecklarplattformen behöver ni även skilja mellan hur appen distribueras och vilken autentisering den använder.
Det är därför mer användbart att börja med behovet än med etiketten. Ska integrationen bara ansluta ert eget konto? Ska en leverantör erbjuda samma app till flera kunder? Behövs webhooks eller funktioner inne i HubSpots gränssnitt?
Private apps: förstå den äldre modellen
En äldre private app har varit ett vanligt sätt att ge en integrationslösning API-åtkomst till ett enskilt HubSpot-konto genom en åtkomsttoken. Många befintliga integrationer använder den modellen.
HubSpot har meddelat att skapandet av nya legacy private apps tas bort stegvis under hösten 2026. För äldre konton anges den 26 oktober 2026 som tidpunkt, medan begränsningen införs tidigare för nyare konton. Meddelandet gäller skapandet av nya appar och innebär inte att befintliga appar stängs av samma dag. Läs HubSpots besked om förändringen när ni planerar en ny anslutning.
En instruktion som visar hur man skapade en private app för några år sedan kan alltså beskriva en annan väg än den som rekommenderas nu.
OAuth när appen ska installeras i flera konton
OAuth används när en app ska kunna anslutas till flera HubSpot-konton. Kunden godkänner appens åtkomst i ett installationsflöde, och integrationen hanterar anslutningen till respektive konto.
Det betyder inte att appen måste vara offentligt listad i Marketplace. Även en lösning som distribueras till ett bestämt urval av konton kan använda OAuth. Det är en viktig skillnad mellan autentiseringsmetod och marknadsplatslistning.
För beställaren är de praktiska frågorna vem som får installera appen, vilka behörigheter som efterfrågas och hur anslutningen förvaltas. Tokenhantering och förnyelse behöver fungera även efter den första installationen.
Static auth och Service Keys fyller olika roller
På den projektbaserade utvecklarplattformen finns static auth för appar som installeras i ett enskilt konto. HubSpot beskriver skillnaden mot OAuth i sin översikt över autentisering.
Service Keys är ett annat alternativ för system-till-system-åtkomst till data i ett konto. De är separata från en apps livscykel och kan vara relevanta när behovet framför allt är att läsa och skriva data. Men de ersätter inte alla appfunktioner.
HubSpot pekar exempelvis på projektbaserade appar när lösningen behöver webhook-prenumerationer eller gränssnittsfunktioner. Läs HubSpots genomgång av Service Keys och när de passar för att bedöma rätt alternativ.
Scopes beskriver vad anslutningen får göra
Scopes är behörigheter till olika typer av funktioner och data. Att integrationen får läsa företag innebär inte automatiskt att den får skapa affärer eller ändra affärsrader.
Utgå från era objekt och flöden. Lista vad integrationen ska läsa, skapa och uppdatera, och välj behörigheter som motsvarar detta. En fungerande anslutning med fel scopes kan fortfarande misslyckas när ett visst steg ska köras.
Skilj även på integrationsbehörighet och produktlicens. Ett godkänt API-anrop eller en installerad app ger inte automatiskt tillgång till alla funktioner i HubSpot. Kraven behöver kontrolleras för det aktuella upplägget.
Bearer token säger inte hela historien
I tekniska exempel kan flera av anslutningsalternativen använda en token i anropets Authorization-header med typen Bearer. Att anropen ser lika ut betyder inte att token skapas, förnyas eller förvaltas på samma sätt.
Det är också viktigt att inte blanda ihop produktionsanslutningen med nycklar för lokal utveckling eller särskilda utvecklarfunktioner. En instruktion som nämner en developer key behöver läsas i sitt sammanhang.
För ett integrationsprojekt räcker det ofta att beställaren förstår ansvaret: vem äger anslutningen, var förvaras hemligheterna och hur byts eller återkallas de när det behövs?
Säker förvaltning är en del av anslutningen
Lägg inte tokens i dokumentation, publika forum eller vanliga felsökningsskärmbilder. Integrationen behöver säker lagring av hemligheter och ett planerat sätt att byta dem.
Bestäm hur anslutningen påverkas när en administratör slutar, ett samarbete ändras eller behörighetsbehovet växer. Dessa frågor bör hanteras tillsammans med driftansvaret, inte först när synken slutat fungera.
En integrationsplattform kan hjälpa till att samla anslutningar och körningar. Även där behöver rätt personer ha rätt åtkomst och ett tydligt ansvar för förändringar.
Vanliga frågor om appar och autentisering
Måste en OAuth-app finnas i Marketplace?
Nej. OAuth kan även användas för distribution till ett bestämt urval av konton. Marketplace-listning och autentisering är olika frågor.
Är en äldre private app fel att använda?
Inte automatiskt. Bedöm den befintliga lösningen mot aktuella förändringar och krav. För en ny integration ska ni utgå från HubSpots nuvarande rekommenderade alternativ.
Kan Service Keys ersätta alla appar?
Nej. De är avsedda för dataåtkomst och ersätter inte appfunktioner som exempelvis webhook-prenumerationer och gränssnittstillägg.
Vilket alternativ ska vi välja för affärssystemet?
Det beror på distribution, funktioner och förvaltning. Låt partnern motivera valet utifrån era faktiska flöden och dokumentera vem som ansvarar för anslutningen.
Vill ni få hjälp att välja rätt anslutning?
Cedeo hjälper er att bedöma autentisering som en del av hela integrationslösningen. Läs om våra integrationer, hitta rätt i HubSpots tekniska underlag eller kontakta oss.