1. Support ▸
  2. Knowledge Base ▸
  3. SCIM ▸
  4. SCIM-Provisioning in Uptrends einrichten

SCIM-Provisioning in Uptrends einrichten

Notiz

SCIM-Support ist für berechtigte Uptrends Enterprise Accounts verfügbar. Wenn du SCIM verwenden möchtest, kontaktiere den Uptrends Support oder deinen Account Manager, um Optionen zu besprechen und loszulegen.

SCIM einrichten

Diese Anleitung verwendet Microsoft Entra ID als beispielhaften Identity Provider. Derselbe Workflow und derselbe SCIM-Endpunkt gelten für andere IdPs.

Bevor du beginnst, stelle sicher, dass du die SCIM-Voraussetzungen erfüllst.

Führe die folgenden Schritte aus, um SCIM einzurichten. Jeder Schritt enthält detaillierte Anweisungen:

  1. SCIM in Uptrends konfigurieren.
  2. Deinen Identity Provider (IdP) über SCIM mit Uptrends verbinden.
  3. Deinen IdP provisionieren.
  4. SCIM-Einrichtung in Uptrends und deinem IdP überprüfen.
  5. Zugriffsberechtigungen zu synchronisierten Gruppen in Uptrends hinzufügen.

SCIM in Uptrends konfigurieren

Befolge diese Schritte, um SCIM in deinem Uptrends Account zu konfigurieren.

  1. Melde dich als Administrator bei Uptrends an.
  2. Öffne die SCIM-Einstellungen, abhängig von deiner Ansicht:
  • Gehe zu Accounteinstellungen > SCIM-Einstellungen.
  • Gehe zu Admin > Operator und Gruppen > SCIM-Einstellungen.

  1. Erstelle ein SCIM-Servicekonto:

    a. Klicke auf SCIM-Servicekonto erstellen.

    b. Gib die E-Mail-Adresse für das Servicekonto an.

    c. Klicke auf Erstellen.

    d. Kopiere nach dem Erstellen den API-Schlüssel und speichere ihn sicher. Du verwendest ihn als Secret Token in deinem IdP. Uptrends zeigt den Schlüssel nur einmal an. Wenn du ihn verlierst, generiere einen neuen API-Schlüssel für das SCIM-Servicekonto. Weitere Details findest du im Abschnitt SCIM API-Token.

    e. Kopiere die SCIM-Endpunkt-URL. Verwende diese als Tenant URL in deinem IdP. Verwende beispielsweise https://api.uptrends.com/v4/scim/v2 als Produktions-URL.

    f. Klicke auf Weiter.

Deinen Identity Provider (IdP) über SCIM mit Uptrends verbinden

Befolge diese Schritte, um eine Verbindung zwischen der Uptrends-Plattform und deinem IdP herzustellen:

  1. Erstelle eine Non-Gallery-Unternehmensanwendung in Microsoft Entra ID.

Notiz

Du benötigst keinen Eintrag in der Entra App Gallery, um SCIM mit Uptrends zu verwenden. Optional kannst du SSO in derselben Unternehmensanwendung mit deiner bestehenden Uptrends SSO-Einrichtung konfigurieren.

  1. Konfiguriere die SCIM-Provisionierung in Microsoft Entra ID:

    a. Gehe in der Unternehmensanwendung zu Provisioning.

    b. Setze Provisioning Mode auf Automatic.

    c. Wenn dein IdP dich auffordert, eine Authentifizierungsmethode auszuwählen, wähle Bearer authentication.

    d. Gib unter Admin Credentials Folgendes ein:

  • Tenant URL — SCIM-Endpunkt-URL aus dem Konfigurationsbildschirm der Uptrends Webanwendung. Zum Beispiel https://api.uptrends.com/v4/scim/v2.

  • Secret Token — API-Schlüssel aus deinem SCIM-Servicekonto, wenn du SCIM in Uptrends konfigurierst.

  1. Klicke auf Test Connection. Dein IdP überprüft den Endpunkt und den Token.

Eine Meldung wird angezeigt, wenn die Verbindung erfolgreich ist.

  1. Klicke auf Save und starte dann die Provisionierung.

Deinen IdP mit Uptrends über SCIM provisionieren

Notiz

Stelle sicher, dass du bereits Nutzer und Gruppen unter Users and groups der Unternehmensanwendung zugewiesen hast, bevor du die Provisionierung startest.

Befolge diese Schritte, um den Provisionierungsumfang festzulegen und IdP-Nutzer mit Uptrends zu synchronisieren:

  1. Gehe zu Settings > Provisioning und wähle dann aus, welche Nutzer und Gruppen synchronisiert werden:

  • Nur zugewiesene Nutzer und Gruppen synchronisieren (empfohlen) — nur Nutzer und Gruppen, die du dieser Unternehmensanwendung zuweist, werden in Uptrends provisioniert.

  • Alle Nutzer und Gruppen synchronisieren — synchronisiert dein gesamtes Verzeichnis. Verwende dies nur, wenn du alle Nutzer und Gruppen in Uptrends provisionieren möchtest.

  1. Setze Provisioning status auf On.

  2. Microsoft Entra ID führt eine erste Synchronisierung aus und synchronisiert danach etwa alle 40 Minuten weiter.

  3. Überwache den Fortschritt unter Provisioning > View provisioning logs.

Die erste Synchronisierung kann je nach Anzahl der zugewiesenen Nutzer und Gruppen länger dauern.

Erfolgreiche Provisionierung aus IdP und Uptrends überprüfen

Nachdem die Provisionierung abgeschlossen ist, überprüfe Folgendes:

SCIM-Konfiguration in deinem IdP überprüfen

  1. Gehe in deiner Unternehmensanwendung zu Provisioning > View provisioning logs. Bestätige, dass Nutzer und Gruppen ohne Fehler als erstellt oder aktualisiert angezeigt werden.

SCIM-Konfiguration in Uptrends überprüfen

  1. Öffne die SCIM-Einstellungen, abhängig von deiner Ansicht:
  • Gehe zu Accounteinstellungen > SCIM-Einstellungen.
  • Gehe zu Admin > SCIM-Einstellungen.

Bestätige, dass die Endpunkt-URL und das Servicekonto korrekt konfiguriert sind.

  1. Öffne die Operator-Seite, abhängig von deiner Ansicht:
  • Gehe zu Accounteinstellungen > Operator und Gruppen.
  • Gehe zu Admin > Operator und Gruppen.

Bestätige, dass die von SCIM verwalteten Operator in der Liste mit Von deinem IdP verwaltet gekennzeichnet sind.

  1. Öffne die Operatorgruppen-Seite, abhängig von deiner Ansicht:
  • Gehe zu Accounteinstellungen > Operator und Gruppen.
  • Gehe zu Admin > Operator und Gruppen.

Bestätige, dass die von SCIM verwalteten Operatorgruppen in der Liste mit SCIM-verwaltet gekennzeichnet sind. Bestätige, dass die Mitgliedschaft deinen IdP-Zuweisungen entspricht.

  1. Öffne den Audit Log, abhängig von deiner Ansicht:
  • Gehe zu Accounteinstellungen > Audit Log.
  • Gehe zu Admin > Audit Log.

Bestätige, dass von SCIM initiierte Nutzer- und Gruppenänderungen im Uptrends Audit Log aufgezeichnet werden. Weitere Informationen findest du im Knowledge-Base-Artikel Audit Log.

Nachdem Operator und Operatorgruppen provisioniert wurden, lies SCIM-Provisionierungsverhalten in Uptrends für erwartetes Verhalten, Berechtigungen, Synchronisierungszeitpunkt und aktuelle Einschränkungen.

Synchronisierte Gruppen Uptrends-Berechtigungen zuordnen

SCIM synchronisiert in Uptrends nur Operator und Operatorgruppen. Berechtigungen bleiben unter Uptrends-Kontrolle, damit du Zugriff auf Prüfobjekte, Alarme und andere Ressourcen gewähren kannst, ohne deine IdP-Konfiguration zu ändern.

Befolge diese Schritte, um den synchronisierten Gruppen in Uptrends Zugriffsberechtigungen zu gewähren.

Für jede synchronisierte Gruppe:

  1. Öffne die Operator-Seite, abhängig von deiner Ansicht:
  • Gehe zu Accounteinstellungen > Operator und Gruppen.
  • Gehe zu Admin > Operator und Gruppen.
  1. Wähle eine von SCIM verwaltete Gruppe mit der Kennzeichnung SCIM-verwaltet.
  2. Klicke auf Berechtigungen.
  3. Konfiguriere, auf welche Prüfobjekte, Prüfobjektgruppen, Integrationen, Alarme und andere Ressourcen die Gruppe zugreifen darf.
  4. Wiederhole dies für jede Gruppe, die Uptrends-Zugriff benötigt.

Nachdem du Berechtigungen zugewiesen hast, melde dich als provisionierter Nutzer mit SSO oder einem Uptrends Login an. Bestätige, dass der Nutzer auf die Prüfobjekte und Funktionen zugreifen kann, die für seine synchronisierte Gruppe erwartet werden. Weitere Informationen zu Uptrends-Berechtigungen findest du im Berechtigungen Überblick.

SCIM API-Token

Der API-Schlüssel ist der Secret Token, den dein IdP zur Authentifizierung bei Uptrends verwendet. Ohne gültigen API-Schlüssel kann dein IdP Nutzer und Gruppen nicht mit Uptrends-Operatorn und Operatorgruppen synchronisieren.

Beachte beim Erstellen des API-Schlüssels Folgendes:

  • Uptrends zeigt den API-Schlüssel nur einmal an, wenn er erstellt wird. Wenn du ihn verlierst, kannst du ihn später nicht wieder abrufen. Widerrufe den verlorenen Schlüssel im Tab API-Management des Operators des SCIM-Servicekontos, damit er sofort abläuft, und generiere dann einen neuen API-Schlüssel.
  • Der API-Schlüssel ist ein Jahr lang gültig. Nach Ablauf kann dein IdP keine Operator oder Operatorgruppen mehr provisionieren, bis du einen neuen API-Schlüssel erstellst und ihn als Secret Token speicherst.
  • Notiere das Ablaufdatum und ersetze den API-Schlüssel, bevor er abläuft. Uptrends sendet keine Ablauf-Erinnerungen.

Token ersetzen

Um einen Token zu ersetzen, musst du einen neuen Token generieren. Diese Option ist nur für das SCIM-Servicekonto verfügbar.

  1. Öffne den Operator des SCIM-Servicekontos entweder über die Seite Accounteinstellungen oder über Admin > Operator und Gruppen. Verwende auf einer der beiden Seiten eine dieser Optionen:
  • Gehe zu SCIM-Einstellungen und öffne dann den Operator des Servicekontos.
  • Klicke auf Alle Operator anzeigen und öffne dann den Operator des Servicekontos.

  1. Gehe zu API-Management.

  2. Klicke auf Bearer-Token hinzufügen. Der Standardname des Tokens zeigt das Ablaufdatum an.

  3. Klicke auf Erstellen. Uptrends generiert den API-Schlüssel und zeigt ihn einmal an. Kopiere ihn sofort. Er kann nicht erneut angezeigt werden.

  4. Ersetze in den Provisionierungseinstellungen deines Identity Providers den bisherigen Secret Token durch den neuen API-Schlüssel.

Notiz

Der vorherige API-Schlüssel bleibt bis zu seinem Ablaufdatum gültig, auch nachdem du einen neuen Schlüssel erstellt hast. Aktualisiere den Secret Token in deinem Identity Provider mit dem neuen API-Schlüssel und widerrufe dann den ungenutzten Schlüssel im Tab API-Management, damit er sofort abläuft. Widerrufe ihn erst, nachdem der neue Schlüssel gespeichert wurde, damit die Provisionierung aktiv bleibt.

Fehlerbehebung

Test Connection schlägt fehl

Wenn eine Testverbindung fehlschlägt, bestätige Folgendes:

  • Tenant URL stimmt mit dem exakten SCIM-Endpunkt aus Uptrends überein.
  • Secret Token ist der API-Schlüssel des SCIM-Servicekontos.

Keine Nutzer oder Gruppen erscheinen in Uptrends

Wenn Nutzer oder Gruppen nach der Synchronisierung nicht in Uptrends erscheinen, bestätige Folgendes:

  • Nutzer oder Gruppen sind der Unternehmensanwendung zugewiesen.
  • Der Synchronisierungsumfang umfasst die Nutzer und Gruppen, die du erwartest.
  • Die erste Synchronisierung ist abgeschlossen. Prüfe die Provisionierungslogs auf übersprungene Einträge oder Fehler.
  • Der Nutzer ist in einer IdP-Gruppe, die der Anwendung zugewiesen ist.

Doppelte Operator oder Gruppen

  • Operator: Der IdP-userName muss mit der E-Mail-Adresse oder dem Benutzernamen des bestehenden Operators übereinstimmen, damit er übernommen wird.
  • Gruppen: SCIM übernimmt nicht nach Anzeigename. Lege eine übereinstimmende externe ID fest, bevor die Provisionierung startet. Andernfalls wird eine neue von SCIM verwaltete Gruppe erstellt.

Nutzer können nach der Synchronisierung nicht auf Prüfobjekte zugreifen

  • SCIM legt keine Berechtigungen fest. Weise Berechtigungen für die von SCIM verwaltete Gruppe in Uptrends zu.
Durch die Nutzung dieser Website stimmen Sie der Verwendung von Cookies gemäß unserer Cookie-Richtlinien zu.