1. Support ▸
  2. Knowledge Base ▸
  3. SCIM ▸
  4. SCIM-provisioning configureren in Uptrends

SCIM-provisioning configureren in Uptrends

Opmerking

Ondersteuning voor SCIM is beschikbaar voor in aanmerking komende Uptrends Enterprise-accounts. Als u SCIM wilt gebruiken, neemt u contact op met Uptrends Support of uw accountmanager om de opties te bespreken en aan de slag te gaan.

SCIM configureren

In deze handleiding wordt Microsoft Entra ID gebruikt als voorbeeld van een identity provider. Dezelfde workflow en hetzelfde SCIM-eindpunt zijn van toepassing op andere IdP’s.

Controleer voordat u begint of u voldoet aan de SCIM-vereisten.

Voer de volgende stappen uit om SCIM te configureren. Elke stap bevat gedetailleerde instructies:

  1. SCIM configureren in Uptrends.
  2. Uw identity provider (IdP) verbinden met Uptrends via SCIM.
  3. Uw IdP provisionen.
  4. SCIM-configuratie verifiëren in Uptrends en uw IdP.
  5. Toegangsrechten toevoegen aan gesynchroniseerde groepen in Uptrends.

SCIM configureren in Uptrends

Volg deze stappen om SCIM te configureren in uw Uptrends-account.

  1. Log in bij Uptrends als administrator.
  2. Open de SCIM-instellingen, afhankelijk van uw weergave:
  • Ga naar Accountinstellingen > SCIM-instellingen.
  • Ga naar Admin > Operators en groepen > SCIM-instellingen.

  1. Maak een SCIM-serviceaccount aan:

    a. Klik op SCIM-serviceaccount aanmaken.

    b. Geef het e-mailadres voor het serviceaccount op.

    c. Klik op Aanmaken.

    d. Nadat het account is aangemaakt, kopieert u de API key en slaat u deze veilig op. U gebruikt deze als het secret token in uw IdP. Uptrends toont de key slechts één keer. Als u deze kwijtraakt, genereert u een nieuwe API key voor het SCIM-serviceaccount. Zie voor meer informatie het gedeelte SCIM API-token.

    e. Kopieer de URL van het SCIM-eindpunt. Gebruik deze als de tenant-URL in uw IdP. Gebruik bijvoorbeeld https://api.uptrends.com/v4/scim/v2 voor de productie-URL.

    f. Klik op Doorgaan.

Uw identity provider (IdP) verbinden met Uptrends via SCIM

Volg deze stappen om een verbinding tot stand te brengen tussen het Uptrends-platform en uw IdP:

  1. Maak een non-gallery enterprise application aan in Microsoft Entra ID.

Opmerking

U hebt geen Entra App Gallery-vermelding nodig om SCIM met Uptrends te gebruiken. Configureer optioneel SSO in dezelfde enterprise application met uw bestaande Uptrends SSO-configuratie.

  1. Configureer SCIM-provisioning in Microsoft Entra ID:

    a. Ga in de enterprise application naar Provisioning.

    b. Stel Provisioning Mode in op Automatic.

    c. Als uw IdP u vraagt een authenticatiemethode te kiezen, selecteert u Bearer authentication.

    d. Voer onder Admin Credentials het volgende in:

  • Tenant URL — URL van het SCIM-eindpunt uit het configuratiescherm van de Uptrends-webapplicatie. Bijvoorbeeld https://api.uptrends.com/v4/scim/v2.

  • Secret Token — API key van uw SCIM-serviceaccount wanneer u SCIM in Uptrends configureert.

  1. Klik op Test Connection. Uw IdP verifieert het eindpunt en token.

Er wordt een bericht weergegeven als de verbinding is geslaagd.

  1. Klik op Save en start vervolgens provisioning.

Uw IdP provisionen met Uptrends via SCIM

Opmerking

Zorg dat u al gebruikers en groepen aan de enterprise application hebt toegewezen onder Users and groups voordat u provisioning start.

Volg deze stappen om het provisioningbereik in te stellen en IdP-gebruikers te synchroniseren met Uptrends:

  1. Ga naar Settings > Provisioning en selecteer vervolgens welke gebruikers en groepen worden gesynchroniseerd:

  • Alleen toegewezen gebruikers en groepen synchroniseren (aanbevolen) — alleen gebruikers en groepen die u aan deze enterprise application toewijst, worden in Uptrends geprovisioned.

  • Alle gebruikers en groepen synchroniseren — synchroniseert uw volledige directory. Gebruik dit alleen als u alle gebruikers en groepen in Uptrends wilt provisionen.

  1. Stel Provisioning status in op On.

  2. Microsoft Entra ID voert een initiële synchronisatie uit en blijft daarna ongeveer elke 40 minuten synchroniseren.

  3. Monitor de voortgang onder Provisioning > View provisioning logs.

De initiële synchronisatie kan langer duren, afhankelijk van het aantal toegewezen gebruikers en groepen.

Een geslaagde provisioning vanuit IdP en Uptrends verifiëren

Nadat provisioning is voltooid, verifieert u het volgende:

SCIM-configuratie in uw IdP verifiëren

  1. Ga in uw enterprise application naar Provisioning > View provisioning logs. Bevestig dat gebruikers en groepen zonder fouten als aangemaakt of bijgewerkt worden weergegeven.

SCIM-configuratie in Uptrends verifiëren

  1. Open de SCIM-instellingen, afhankelijk van uw weergave:
  • Ga naar Accountinstellingen > SCIM-instellingen.
  • Ga naar Admin > SCIM-instellingen.

Bevestig dat de eindpunt-URL en het serviceaccount correct zijn geconfigureerd.

  1. Open de pagina Operators, afhankelijk van uw weergave:
  • Ga naar Accountinstellingen > Operators en groepen.
  • Ga naar Admin > Operators en groepen.

Bevestig dat de door SCIM beheerde operators in de lijst zijn gelabeld als Beheerd door uw IdP.

  1. Open de pagina Operatorgroepen, afhankelijk van uw weergave:
  • Ga naar Accountinstellingen > Operators en groepen.
  • Ga naar Admin > Operators en groepen.

Bevestig dat de door SCIM beheerde operatorgroepen in de lijst zijn gelabeld als SCIM beheerd. Bevestig dat het lidmaatschap overeenkomt met uw IdP-toewijzingen.

  1. Open de Audit log, afhankelijk van uw weergave:
  • Ga naar Accountinstellingen > Audit log.
  • Ga naar Admin > Audit log.

Bevestig dat door SCIM geïnitieerde wijzigingen van gebruikers en groepen worden geregistreerd in de Uptrends Audit log. Zie voor meer informatie het Knowledge Base-artikel Audit log.

Nadat operators en operatorgroepen zijn geprovisioned, raadpleegt u Gedrag van SCIM-provisioning in Uptrends voor verwacht gedrag, gebruikersrechten, synchronisatietiming en huidige beperkingen.

Gesynchroniseerde groepen toewijzen aan Uptrends-gebruikersrechten

SCIM synchroniseert alleen operators en operatorgroepen in Uptrends. Gebruikersrechten blijven onder beheer van Uptrends, zodat u toegang kunt verlenen tot controleregels, alerts en andere resources zonder uw IdP-configuratie te wijzigen.

Volg deze stappen om toegangsrechten te verlenen aan de gesynchroniseerde groepen in Uptrends.

Voor elke gesynchroniseerde groep:

  1. Open de pagina Operators, afhankelijk van uw weergave:
  • Ga naar Accountinstellingen > Operators en groepen.
  • Ga naar Admin > Operators en groepen.
  1. Selecteer een door SCIM beheerde groep met het label SCIM beheerd.
  2. Klik op Gebruikersrechten.
  3. Configureer tot welke controleregels, controleregelgroepen, integraties, alerts en andere resources de groep toegang heeft.
  4. Herhaal dit voor elke groep die Uptrends-toegang nodig heeft.

Nadat u gebruikersrechten hebt toegewezen, meldt u zich aan als een geprovisionde gebruiker met SSO of een Uptrends-login. Bevestig dat de gebruiker toegang heeft tot de controleregels en functies die voor de gesynchroniseerde groep worden verwacht. Zie Overzicht gebruikersrechten voor meer informatie over Uptrends-gebruikersrechten.

SCIM API-token

De API key is het secret token dat uw IdP gebruikt om zich bij Uptrends te authenticeren. Zonder een geldige API key kan uw IdP gebruikers en groepen niet synchroniseren met Uptrends-operators en operatorgroepen.

Let bij het aanmaken van de API key op het volgende:

  • Uptrends toont de API key slechts één keer, wanneer deze wordt aangemaakt. Als u deze kwijtraakt, kunt u deze later niet meer ophalen. Trek de kwijtgeraakte key in op het tabblad API management van de SCIM-serviceaccountoperator, zodat deze onmiddellijk verloopt, en genereer vervolgens een nieuwe API key.
  • De API key is één jaar geldig. Nadat deze is verlopen, kan uw IdP geen operators of operatorgroepen meer provisionen totdat u een nieuwe API key aanmaakt en deze opslaat als het secret token.
  • Noteer de vervaldatum en vervang de API key voordat deze verloopt. Uptrends verzendt geen herinneringen voor de vervaldatum.

Een token vervangen

Om een token te vervangen moet u een nieuw token genereren. Deze optie is alleen beschikbaar voor het SCIM-serviceaccount.

  1. Open de SCIM-serviceaccountoperator vanaf de pagina Accountinstellingen of via Admin > Operators en groepen. Gebruik op een van beide pagina’s een van deze opties:
  • Ga naar SCIM-instellingen en open vervolgens de serviceaccountoperator.
  • Klik op Alle operators bekijken en open vervolgens de serviceaccountoperator.

  1. Ga naar API management.

  2. Klik op Bearer-token toevoegen. De standaard tokennaam toont de vervaldatum.

  3. Klik op Aanmaken. Uptrends genereert de API key en geeft deze één keer weer. Kopieer deze onmiddellijk. Deze kan niet opnieuw worden weergegeven.

  4. Vervang in de provisioninginstellingen van uw identity provider het vorige secret token door de nieuwe API key.

Opmerking

De vorige API key blijft geldig tot de vervaldatum, zelfs nadat u een nieuwe key hebt aangemaakt. Werk het secret token in uw identity provider bij met de nieuwe API key en trek vervolgens de ongebruikte key in op het tabblad API management, zodat deze onmiddellijk verloopt. Trek deze pas in nadat de nieuwe key is opgeslagen, zodat provisioning actief blijft.

Problemen oplossen

Test Connection mislukt

Als een testverbinding mislukt, bevestigt u het volgende:

  • Tenant URL komt overeen met het exacte SCIM-eindpunt uit Uptrends.
  • Secret Token is de API key van het SCIM-serviceaccount.

Er verschijnen geen gebruikers of groepen in Uptrends

Als gebruikers of groepen na synchronisatie niet in Uptrends verschijnen, bevestigt u het volgende:

  • Gebruikers of groepen zijn toegewezen aan de enterprise application.
  • Het synchronisatiebereik omvat de gebruikers en groepen die u verwacht.
  • De initiële synchronisatie is voltooid. Controleer de provisioninglogs op overgeslagen items of fouten.
  • De gebruiker bevindt zich in een IdP-groep die aan de applicatie is toegewezen.

Dubbele operators of groepen

  • Operators: de IdP userName moet overeenkomen met het bestaande e-mailadres of de bestaande gebruikersnaam van de operator voor overname.
  • Groepen: SCIM neemt niet over op basis van display name. Stel een overeenkomende external ID in voordat provisioning start. Anders wordt er een nieuwe door SCIM beheerde groep aangemaakt.

Gebruikers hebben na synchronisatie geen toegang tot controleregels

  • SCIM stelt geen gebruikersrechten in. Wijs gebruikersrechten toe aan de door SCIM beheerde groep in Uptrends.
Door deze website te gebruiken, stemt u in met het gebruik van cookies in overeenstemming met ons Cookiebeleid.