HjälpcenterAdmin: inloggning och inställningar

Enkel inloggning: det här behöver er IT-avdelning

Den här sidan är till den som sköter er organisations inloggning. Er admin i Hives har börjat inställningen i Hives och behöver att du lägger till Hives hos er identitetsleverantör. Det tar ungefär tio minuter. Hives sida av inställningen beskrivs i Ställa in enkel inloggning (SAML).

Det här stöder Hives

  • SAML 2.0, med en identitetsleverantör per hive.
  • Inloggning som startas av er leverantör (från en portal, ett intranät eller en appruta) och som startas av Hives (en knapp på hivens inloggningssida). Båda leder till samma konto.
  • Svaret, intyget (assertion) eller båda signerade med SHA-256 eller starkare. SHA-1 nekas.
  • Upp till två signeringscertifikat samtidigt, så att du kan byta certifikat utan avbrott.
  • Två minuters skillnad mellan klockorna.

Hives signerar inte sina förfrågningar och använder inte single logout. Att logga ut från Hives loggar bara ut från Hives.

Värdena från Hives

Er admin i Hives kopierar dem från Admin > Hive > Enkel inloggning och skickar dem till dig. Varje hive har sina egna.

Hives kallar det Er leverantör kan kalla det Ser ut så här
Inloggningsadress (ACS URL) Reply URL, Assertion Consumer Service URL, Single sign-on URL https://api.hives.co/auth/saml/<id>/acs
Entity ID Identifier, Audience URI, SP Entity ID https://api.hives.co/auth/saml/<id>/metadata
Länk till metadata Service provider metadata samma adress som Entity ID

Hives ber om Name ID-formatet unspecified, så vilket Name ID som helst från er leverantör går bra.

Det här skickar du tillbaka

Ge er admin i Hives något av det här:

  • en länk till metadata för Hives-appen (bäst, eftersom den tar med ett nytt certifikat när du förnyar), eller
  • metadatafilen, eller
  • utfärdaren (Entity ID), er leverantörs inloggningsadress och signeringscertifikatet i PEM.

Attributen som Hives läser

Skicka dem som SAML-attribut. Namnen till vänster är det som Hives väntar sig från början. Om du använder andra namn ändrar er admin dem i Hives.

Attribut Det innehåller Behövs
first_name Förnamn Ja
last_name Efternamn Ja
email E-postadress på jobbet Ja, om inte personer känns igen på anställningsnummer
employee_id Anställningsnummer eller ett annat id som aldrig ändras När personer känns igen på anställningsnummer
job_title Titel När hiven använder det här profilfältet
department Avdelning När hiven använder det här profilfältet

Om du inte skickar något email-attribut läser Hives e-postadressen från Name ID, när det är en e-postadress.

Bestäm tillsammans med er admin i Hives vad som känner igen en person: e-postadressen eller anställningsnumret. Använd anställningsnummer när personer saknar jobbmejl eller delar en inloggning, och se till att det alltid skickas och aldrig ändras.

Namn sätts när en person loggar in första gången. Anställningsnummer, titel och avdelning följer det du skickar vid varje inloggning.

Vem som kommer in

Tilldela Hives till de personer eller grupper hos er leverantör som ska använda det. Hives släpper in alla som er leverantör släpper igenom, som medlem i hiven. Roller i Hives ges i Hives.

Entra ID

  1. Öppna Enterprise applications > New application > Create your own application i Microsoft Entra admin center, döp den till Hives och välj att integrera en app som inte finns i galleriet.
  2. Öppna Single sign-on och välj SAML.
  3. Under Basic SAML Configuration sätter du Identifier (Entity ID) till Hives Entity ID och Reply URL till Hives Inloggningsadress (ACS URL). Lämna Sign on URL tomt.
  4. Under Attributes & Claims finns redan anspråken för förnamn, efternamn och e-post, och Hives läser dem under deras vanliga Microsoft-namn. Lägg till de anspråk som Hives behöver utöver dem, utan namnrymd: till exempel employee_id från user.employeeid, job_title från user.jobtitle och department från user.department.
  5. Under SAML Certificates kopierar du App Federation Metadata Url och skickar den till er admin i Hives. Använd den här adressen, inte er tenants allmänna federationsmetadata.
  6. Under Users and groups tilldelar du de personer eller grupper som ska använda Hives. Då syns Hives också i deras My Apps-portal.

Okta

  1. Öppna Applications > Create App Integration och välj SAML 2.0. Döp den till Hives.
  2. Sätt Single sign-on URL till Hives Inloggningsadress (ACS URL) och Audience URI (SP Entity ID) till Hives Entity ID.
  3. Sätt Name ID format till EmailAddress och Application username till Email, eller till det som passar hur personer känns igen.
  4. Under Attribute Statements lägger du till first_name (user.firstName), last_name (user.lastName), email (user.email) och vid behov employee_id (user.employeeNumber), job_title (user.title) och department (user.department).
  5. Slutför, öppna fliken Sign On och kopiera Metadata URL. Skicka den till er admin i Hives.
  6. Tilldela de personer eller grupper som ska använda Hives.

Google Workspace

  1. Öppna Apps > Web and mobile apps > Add app > Add custom SAML app i Google Admin console. Döp den till Hives.
  2. Ladda ned IdP metadata och skicka filen till er admin i Hives.
  3. Sätt ACS URL till Hives Inloggningsadress (ACS URL) och Entity ID till Hives Entity ID. Name ID format: EMAIL, Name ID: primary email.
  4. Under Attribute mapping kopplar du First name till first_name, Last name till last_name, Primary email till email och vid behov Employee ID till employee_id, Job title till job_title och Department till department.
  5. Slå på appen för de personer eller organisationsenheter som ska använda Hives. Enligt Google kan det ta en stund innan det når alla.

Hives har också en egen Logga in med Google, som inte kräver någon inställning. Använd den anpassade SAML-appen när du vill ha anställningsnummer, titlar eller avdelningar i Hives, eller en inloggning som er organisation styr.

Andra SAML 2.0-leverantörer

Skapa en SAML-app med Hives Inloggningsadress (ACS URL) och Entity ID, skicka attributen i tabellen ovan och ge er admin i Hives er länk till metadata, metadatafil eller utfärdare, inloggningsadress och certifikat.

Testa

Er admin i Hives gör en testinloggning från Hives. Den visar varje attribut som er leverantör skickade och vilket fält i Hives det fyller, så att ni kan gå igenom namnen tillsammans. Ingen annan kan logga in förrän testet har fungerat och er admin slår på enkel inloggning.

När något går fel

Er admin i Hives ser varje försök i inloggningsloggen, med vad som hände. De vanligaste orsakerna:

  • Inte för den här hiven: Entity ID eller inloggningsadressen hos er leverantör stämmer inte exakt med Hives värden.
  • Signaturen godtogs inte: certifikatet har ändrats. Skicka den nya metadatan eller det nya certifikatet, eller använd en länk till metadata så att det följer med av sig självt.
  • Ingen identitet skickades: attributet som känner igen personer (e-post eller anställningsnummer) skickas inte för den här personen.
  • Länken har gått ut: klockorna skiljer sig mer än två minuter, eller så tog personen för lång tid på sig.

Frågor om Hives sida: help@hives.co.