Konfigurer enkel pålogging (SSO) ved hjelp av Active Directory Federation Services (AD FS)

Hvis du har en HubSpot Professional- eller Enterprise-konto , kan du sette opp single sign-on ved hjelp av Active Directory Federation Services (AD FS).

Forstå kravene

For å bruke AD FS til å logge på HubSpot-kontoen din, må du oppfylle følgende krav:

• Alle brukere i Active Directory-forekomsten din må ha et e-postadresseattributt.
• Du bruker en HubSpot Professional- eller Enterprise-konto.
• Du har en server som kjører Windows Server 2008, 2012 eller 2019.

Merk: Denne konfigurasjonsprosessen bør utføres av en IT-administrator med erfaring i å opprette applikasjoner i identitetsleverandørkontoen din. Finn ut mer om hvordan du konfigurerer SSO med HubSpot.

Konfigurer SSO ved hjelp av Microsoft AD FS

Før du begynner, må du notere følgende to verdier fra HubSpot-kontoen din for å konfigurere SSO ved hjelp av Microsoft AD FS:

1. I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen.
2. Klikk på Sikkerhet i venstre sidefelt.
3. Klikk på Konfigurer under fanen Pålogging i delen Konfigurer enkeltpålogging (SSO).
4. I skyvepanelet Konfigurer enkel pålogging klikker du på Microsoft AD FS-fanen .
5. Legg merke til både Audience URI (tjenesteleverandørens enhets-ID) og Sign on URL, ACS, Recipient eller Redirect-verdiene, ettersom du må legge dem til i Microsoft AD FS i konfigurasjonsprosessen.

Legg til en avhengig part (RPT)

Åpne Active Directory Federation Services (AD FS)-administratoren:

1. I AD FS-administratoren åpner du mappen RPT (Relying Party Trusts).
2. Velg Legg til tillit til avhengig part i menyen i høyre sidefelt....
3. Klikk på Start i dialogboksen Legg til veiviser for tillit til avhengig part for å legge til en ny RPT.
4. På skjermbildet Velg datakilde velger du Angi data om den avhengige parten manuelt. Klikk deretter på Neste.
5. I feltet Visningsnavn skriver du inn et navn på klareringen - dette er for interne formål, så sørg for at du gir den et navn som du lett kan gjenkjenne. Klikk deretter på Neste.
6. På skjermbildet Konfigurer sertifikat lar du standardinnstillingene være som de er, og klikker deretter på Neste.
7. Merk av for Aktiver støtte for SAML 2.0 WebSSO-protokollen .
8. I feltet URL for SAML 2.0 SSO-tjeneste for avhengig part skriver du inn påloggings-URL , ACS-, mottaker- eller omdirigerings-URL fra HubSpot-kontoen din. Klikk deretter på Neste.

9. I feltet Tillitsidentifikator for avhengig part :
   • Skriv inn Audience URI-verdien (tjenesteleverandørens enhets-ID) fra HubSpot-kontoen din.
   • Skriv inn https://api.hubspot.com, og klikk deretter på Legg til.
10. Klikk på Neste.
11. I vinduet Velg en policy for tilgangskontroll velger du Tillat alle, og klikker deretter på Neste.
12. Gå gjennom innstillingene dine, og klikk deretter på Neste.
13. Klikk på Lukk.

Opprett regler for krav

Før du oppretter en regel for krav, må du sørge for at brukernes e-postadresser samsvarer med HubSpot-brukernes e-postadresser. Du kan bruke andre identifikatorer, for eksempel User Principal Name (UPN), hvis UPN-ene dine er i form av en e-postadresse. For at single sign-on med AD FS skal fungere, må nameID være i form av en e-postadresse for å matche med en HubSpot-bruker.

1. Klikk på Legg til regel i vinduet Kravregel .
2. Klikk på rullegardinmenyen Kravregelmal og velg Send LDAP-attributter som krav. Klikk deretter på Neste.
3. På skjermbildet Konfigurer kravregel :
   • Skriv inn et navn på regelen i feltet Kravregelnavn .
   • Klikk på rullegardinmenyen Attributtlager , og velg Active Directory.
   • I tabellen Tilordning av LDAP-attributter tilordner du følgende:
     • I kolonnen LDAP-attributt klikker du på rullegardinmenyen og velger E-postadresser.
     • I kolonnen Utgående kravtype klikker du på rullegardinmenyen og velger E-postadresse.
4. Klikk på Fullfør.

Konfigurer deretter regelen Transformer et innkommende krav:

1. Klikk på Legg til regel.
2. Klikk på nedtrekksmenyen Kravregelmal , og velg Transformer et innkommende krav. Klikk deretter på Neste.
3. På skjermbildet Konfigurer kravregel :
   • Skriv inn et navn på kravregelen.
   • Klikk på rullegardinmenyen Innkommende kravtype , og velg E-postadresse.
   • Klikk på nedtrekksmenyen Utgående kravtype , og velg Navn-ID.
   • Klikk på rullegardinmenyen Utgående navn-ID-format , og velg E-post.
   • Klikk på Fullfør for å legge til den nye regelen.
4. Klikk på OK for å legge til begge de nye reglene.

Juster tillitsinnstillingene

1. I mappen Replying Party Trusts velger du Properties fra menyen Actions i sidepanelet.
2. Klikk på fanen Avansert , og kontroller at SHA-256 er angitt som sikker hashalgoritme.

Selv om både SHA-256 og SHA-1 støttes, anbefales SHA-256.

Finn x509-sertifikatet ditt i PEM-format

Slik får du tilgang til x509-sertifikatet ditt i PEM-format:

1. Naviger til AD FS-administrasjonsvinduet . Gå til Tjenester > Sertifikater i menyen i venstre sidefelt.
2. Finn Token-signeringssertifikatet . Høyreklikk på sertifikatet, og velg Vis sertifikat.

3. I dialogboksen klikker du på kategorien Detaljer .
4. Klikk på Kopier til fil.
5. Klikk på Neste i sertifikateksportvinduet som åpnes.
6. Velg Base-64-kodet X.509 (.CER), og klikk deretter på Neste.
7. Gi fileksporten et navn, og klikk deretter på Neste.
8. Klikk på Fullfør for å fullføre eksporten.
9. Finn filen du nettopp eksporterte, og åpne den med et tekstredigeringsprogram, for eksempel Notisblokk.
10. Kopier innholdet i filen.

Fullfør oppsettet i HubSpot

1. Logg inn på HubSpot-kontoen din.
2. I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen.
3. Klikk på Sikkerhet i venstre sidefelt.
4. Klikk på Konfigurer under fanen Pålogging i delen Konfigurer enkeltpålogging (SSO).
5. I skyvepanelet Konfigurer enkel pålogging klikker du på Microsoft AD FS-fanen .
6. Lim inn innholdet i filen i feltet X.509 Certificate.
7. Gå tilbake til AD FS-administratoren.
8. I menyen til venstre velger du mappen Endepunkter .
9. Søk etter SSO-tjenestens endepunkt og enhetens URL-adresse. SSO-tjenestens URL-adresse slutter vanligvis på "adfs/services/ls", og entitetens URL-adresse slutter på "adfs/services/trust".
10. Gå tilbake til HubSpot. I feltet Identity provider Identifier eller Issuer skriver du inn enhetens URL.
11. I feltet Identity Provider Single Sign-On URL skriver du inn SSO-tjenestens URL-adresse.
12. Klikk på Verifiser.

Merk: Hvis du får en feilmelding når du konfigurerer Single Sign-On i HubSpot, kan du se etter feilmeldingen i hendelsesvisningsloggene på enheten din. Hvis du ikke klarer å feilsøke feilmeldingen, kan du kontakte HubSpot Support.