Ga naar hoofdinhoud

OktaShared Signals met Okta Identity Threat Protection Beta

Licentievereisten

Shared signals ontvangen in Okta vereist Okta Identity Threat Protection met Okta AI op Okta Identity Engine. Aan de kant van XFA is Shared Signals in beta en wordt het per organisatie op verzoek ingeschakeld (zie het overzicht).

Let op: deze gids gaat ervan uit dat je organisatie een XFA-account heeft en dat jij daar beheerder van bent in XFA. In Okta heb je de rol super administrator nodig, of een aangepaste beheerdersrol die receiver-streams van het Shared Signals Framework kan beheren. Heb je nog geen XFA-account, maak er dan een aan op https://dashboard.xfa.tech/signup.

Okta ontvangt shared signals via push. XFA stuurt een CAEP device-compliance-change-event naar je Okta-org telkens wanneer een toestel van je organisatie wisselt tussen conform en niet-conform (zie wat "niet-conform" betekent). Okta koppelt het event aan de gebruiker via het e-mailadres en past zijn eigen beleid toe.

Er hoeft geen token uitgewisseld te worden. Je geeft XFA het adres van je Okta-org, en je geeft Okta de well-known URL van XFA. Okta controleert elk event met de publieke ondertekeningssleutel van XFA.

1. Voeg de Okta-verbinding toe in XFA

  1. Open in het XFA-dashboard Apparaatbeveiliging > Shared Signals.
  2. Klik op Verbinding toevoegen.
  3. Vul een Naam in, bijvoorbeeld Okta production, en kies Okta als Ontvanger.
  4. Vul je Okta-org-URL in, bijvoorbeeld https://acme.okta.com. Gebruik alleen het adres van de org, zonder pad.
  5. Klik op Verbinding toevoegen.

XFA maakt de stream naar je Okta-org meteen aan. De verbinding toont dat XFA naar je Okta-org pusht, en haar stream staat eronder.

Kopieer in het onderdeel Transmitter bovenaan de pagina de Well-known-configuratie-URL:

https://ssf.xfa.tech/.well-known/ssf-configuration

2. Voeg XFA als transmitter toe in Okta

  1. Ga in de Okta Admin Console naar Security > Device Integrations en open het tabblad Receive shared signals.
  2. Klik op Create stream.
  3. Vul een Integration name in, bijvoorbeeld XFA.
  4. Kies ervoor de stream in te stellen met een Well-known URL, en plak de Well-known-configuratie-URL uit de vorige stap.
  5. Klik op Create.

De stream verschijnt in de lijst van Okta met de status Active. Okta kan ook ingesteld worden met de Issuer URL en JWKS URL; beide staan in het onderdeel Transmitter van de pagina Shared Signals.

De stream dekt elke gebruiker van je organisatie. Okta reageert alleen op events voor gebruikers die het kent, gekoppeld via het e-mailadres.

3. Bepaal wat Okta met het event doet

Een device-compliance-change-event bevat de gebruiker (e-mailadres), het toestel (een ondoorzichtige XFA-toestel-id), de vorige en huidige status (compliant of not-compliant), het tijdstip van de evaluatie en de falende controles in de reason-velden.

Okta onderneemt zelf geen actie op het event. Het registreert het event in de System Log en neemt het op in de entity risk van de gebruiker, en je Okta-beleid bepaalt de reactie: bijvoorbeeld een entity risk-beleidsregel die de gebruiker bij alle sessies afmeldt, of een sessiebeleid dat opnieuw authenticeren vereist. Stel dat in onder Security in de Okta Admin Console. XFA verstuurt het event; het afdwingen is aan Okta.

4. Controleer met een testevent

  1. Zoek op de pagina Shared Signals in XFA de stream onder je Okta-verbinding en klik op Testevent versturen.
  2. XFA pusht een SSF-verificatie-event naar je Okta-org en toont het resultaat van de aflevering op de stream.
  3. Controleer in Okta de System Log op het ontvangen event van XFA.

Een echt device-compliance-change-event volgt binnen enkele minuten nadat een toestel van status verandert: laat een toestel van een testgebruiker falen op een controle die blokkeert in een beleid dat aan een van je applicaties gekoppeld is, en het event verschijnt in de Okta System Log.

Problemen oplossen

  • Okta kan de stream niet aanmaken: controleer of de well-known URL exact https://ssf.xfa.tech/.well-known/ssf-configuration is. Mislukt het aanmaken, dan vraagt Okta je de URL te controleren en de stream opnieuw toe te voegen.
  • De stream in XFA toont een mislukte aflevering: de stream toont de fout die Okta teruggaf. Controleer of XFA als stream is toegevoegd in dezelfde Okta-org waarvan je de URL in XFA invulde, en of de stream in Okta actief is. Afleveringen worden bij tijdelijke fouten opnieuw geprobeerd.
  • De Okta-org-URL in XFA klopt niet: verwijder de verbinding en voeg ze opnieuw toe met de juiste URL. De URL van een Okta-verbinding kan niet gewijzigd worden.
  • Er komen geen events aan: een toestel verstuurt alleen een event wanneer zijn status verandert. Controleer of de falende controle op blokkeren staat in een beleid dat aan een applicatie gekoppeld is, en of het e-mailadres van de gebruiker in XFA overeenkomt met het e-mailadres in Okta.
  • Er gebeurt niets in Okta na een event: Okta heeft het event geregistreerd, maar geen enkel beleid heeft erop gereageerd. Bekijk je entity risk- en sessiebeleid.