Självstudie: Konfigurera kpifire för automatisk användaretablering

I den här självstudien beskrivs de steg du behöver utföra i både kpifire och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När det konfigureras etablerar och avreglerar Microsoft Entra-ID automatiskt användare och grupper till kpifire med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

  • Skapa användare i kpifire
  • Ta bort användare i kpifire när de inte behöver åtkomst längre
  • Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och kpifire
  • Etablera grupper och gruppmedlemskap i kpifire
  • Enkel inloggning till kpifire (rekommenderas)

Förutsättningar

Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:

Steg 1: Planera etableringsdistributionen

  1. Lär dig mer om hur etableringstjänsten fungerar.
  2. Ta reda på vem som finns i etableringsomfånget.
  3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och kpifire.

Steg 2: Konfigurera kpifire för att stödja etablering med Microsoft Entra-ID

  1. Logga in https://app.kpifire.com på med administratörsrättigheter

  2. Gå till Inställningar-API> Inställningar-Add New Token (Lägg till ny token) för att generera SCIM-token>.

    kpifire token generation

  3. Kopiera och spara SCIM-token. Det här värdet anges i fältet Hemlig token på fliken Etablering i kpifire-programmet.

Lägg till kpifire från Microsoft Entra-programgalleriet för att börja hantera etablering till kpifire. Om du tidigare har konfigurerat kpifire för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vem som ska finnas i omfånget för etablering

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren/gruppen. Om du väljer att omfånget som ska etableras till din app ska baseras på tilldelning, kan du använda följande steg för att tilldela användare och grupper till programmet. Om du väljer att omfånget endast ska etableras baserat på attribut för användaren eller gruppen, kan du använda ett omfångsfilter enligt beskrivningen här.

  • Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När etableringsomfånget har angetts till tilldelade användare och grupper, kan du kontrollera detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper, kan du ange ett attributbaserat omfångsfilter.

  • Om du behöver ytterligare roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till kpifire

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i kpifire-appen baserat på användar- och grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för kpifire i Microsoft Entra-ID:

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications Enterprise-program>

    Bladet Företagsprogram

  3. I programlistan väljer du kpifire.

    Kpifire-länken i programlistan

  4. Välj fliken Etablering.

    Fliken Etablering

  5. Ange Etableringsläge som Automatiskt.

    Automatisk etableringsflik

  6. I avsnittet Administratörsautentiseringsuppgifter anger du din kpifire-klient-URL och information om hemlig token. Välj Testa Anslut ion för att säkerställa att Microsoft Entra-ID kan ansluta till kpifire. Om anslutningen misslyckas kontrollerar du att ditt kpifire-konto har administratörsbehörighet och försöker igen.

    Token

  7. I fältet E-postavisering anger du e-postadressen till en person eller grupp som ska få meddelanden om etableringsfel. Markera kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .

    E-postavisering

  8. Välj Spara.

  9. I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till kpifire.

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till kpifire i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i kpifire för uppdateringsåtgärder. Om du ändrar det matchande målattributet måste du se till att kpifire-API:et stöder filtrering av användare baserat på det attributet. Välj Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering
    userName String
    aktiv Booleskt
    name.givenName String
    name.familyName String
    phoneNumbers[type eq "work"].value String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
  11. I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till kpifire.

  12. Granska de gruppattribut som synkroniseras från Microsoft Entra-ID till kpifire i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha grupperna i kpifire för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering
    displayName String
    medlemmar Referens
  13. Information om hur du konfigurerar omfångsfilter finns i anvisningarna i självstudien om omfångsfilter.

  14. Om du vill aktivera Microsoft Entra-etableringstjänsten för kpifire ändrar du Etableringsstatus till i avsnittet Inställningar.

    Etableringsstatus är på

  15. Definiera de användare eller grupper som du vill etablera till kpifire genom att välja önskade värden i Omfång i avsnittet Inställningar.

    Etableringsomfång

  16. När du är redo att etablera väljer du Spara.

    Spara etableringskonfiguration

Åtgärden startar den initiala synkroniseringscykeln för alla användare och grupper som har definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid än nästa cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

  • Använd etableringsloggarna för att avgöra vilka användare som har etablerats eller misslyckats.
  • Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras.
  • Om etableringskonfigurationen verkar innehålla fel, kommer programmet att placeras i karantän. Mer information om karantäntillstånd finns i Programetableringsstatus för karantän.

Fler resurser

Nästa steg