Konfigurieren der Rollen- und Berechtigungs-API in der benutzerdefinierten Bereitstellung
Über das miniOrange-Dashboard können Sie die Rollen und Berechtigungen der externen Anwendung verwalten. In der benutzerdefinierten Bereitstellungsanwendung lassen sich Rollen erstellen, aktualisieren, löschen, mit Berechtigungen zuweisen/entziehen sowie Benutzern zuweisen/entziehen.
Konfigurieren Sie die benutzerdefinierte Bereitstellungsanwendung und integrieren Sie Ihre externen Anwendungs-APIs. Informationen zum Hinzufügen der benutzerdefinierten Bereitstellungsanwendung finden Sie im Leitfaden .
Dieser Leitfaden hilft Ihnen bei der Konfiguration von APIs im Zusammenhang mit der Verwaltung von Rollen und Berechtigungen der externen Anwendung.
Kostenlose Installationshilfe
miniOrange bietet Ihnen kostenlose Hilfe in Form eines Beratungsgesprächs mit unseren Systemingenieuren zur Installation oder Einrichtung der ADFS SSO-Lösung in Ihrer Umgebung mit einer 30-tägigen kostenlosen Testphase.
Hierfür müssen Sie uns lediglich eine E-Mail an idpsupport@xecurify.com senden , um einen Termin zu vereinbaren, und wir helfen Ihnen umgehend weiter.
1. Externe App für miniOrange konfigurieren
Bitte beachten Sie diese Anleitung: Hinzufügen einer benutzerdefinierten Bereitstellungs-App , um eine benutzerdefinierte Bereitstellungsanwendung in miniOrange zu konfigurieren.
1.1 Konfigurieren der Importrollen-API
Diese API wird verwendet, um die vorhandenen Rollen der externen Anwendung zu importieren.
- Im Externe App für miniOrange klicken Sie auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration. Wählen Veranstaltungstyp as Importrollenanfrage. Ergänzen Sie die GET-Endpunkt Rollen importieren/abrufen.
- Wähle aus Genehmigung Das wird auf der Registerkarte „Autorisierung“ konfiguriert.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Attributzuordnung:
- Karte der Rollendaten Primärschlüssel Der Schlüssel „roles“ (dem alle Rollen zugeordnet sind) wird in der API-Antwort übergeben. Lassen Sie das Feld leer, wenn die Rollenliste keinem Feld zugeordnet ist.
- Einrichtung Attributzuordnung um einzelne Rollenattribute mit miniOrange-Attributen zu verknüpfen, wie zum Beispiel Rollen-ID, Rollenname, usw.
- Einrichtung Seiteneinstellungen:
- Konfigurieren Sie die Seitentyp und der Seitenschlüssel sofern von der API unterstützt.
- Klicken Sie auf Konfiguration speichern.
- Zu Importrollen, Klicken Sie auf Schaltfläche importieren (Pfeil nach unten) entsprechend dem Importrolle Ereignis in der Liste auf der Externe App für miniOrange Tab.
1.2 Konfigurieren der Importberechtigungs-API
Mithilfe dieser API können die zulässigen Berechtigungen der externen Anwendung importiert werden, die dann den Rollen hinzugefügt werden können und so die Zugriffsebene des Benutzers in der Anwendung bestimmen.
- Gehen Sie zur Externe App für miniOrange Tab. Klicke auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration. Wählen Veranstaltungstyp as Importberechtigungsanfrage. Ergänzen Sie die GET-Endpunkt Berechtigungen importieren/abrufen.
- Wähle aus Genehmigung Das wird auf der Registerkarte „Autorisierung“ konfiguriert.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Seiteneinstellungen:
- Konfigurieren Sie die Seitentyp und der Seitenschlüssel sofern von der API unterstützt.
- Einrichtung Attributzuordnung um einzelne Berechtigungsattribute mit miniOrange-Attributen zu verknüpfen.
- Karte der Berechtigungsdaten Primärschlüssel wobei der Berechtigungsschlüssel (dem Sie alle Berechtigungen zuweisen) in der Antwort der API enthalten ist.
- Wenn Berechtigungen als Liste von Zeichenketten empfangen werden, verwenden Sie das Attribut Liste der Berechtigungsnamen.
- Wenn Berechtigungen als Schlüssel-Wert-Paare empfangen werden, verwenden Sie Attribute. Berechtigungsname und Berechtigungsbeschreibung.
- Klicken Sie auf Konfiguration speichern.
- Zu Importberechtigungen, Klicken Sie auf Schaltfläche importieren (Pfeil nach unten) entsprechend dem Importberechtigungen Ereignis in der Liste auf der Externe App für miniOrange Tab.
1.3 Konfigurieren der Import-Rollen- und Berechtigungszuweisungs-API
Diese API wird verwendet, um die Rollen und Berechtigungszuweisungen zu importieren und so zu ermitteln, welche Berechtigungen unter einer bestimmten Rolle vorhanden sind.
- Gehen Sie zur Externe App für miniOrange Tab. Klicke auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration. Wählen Veranstaltungstyp as Importrollen- und Berechtigungszuweisungsanfrage. Ergänzen Sie die GET-Endpunkt Um Berechtigungen einer Rolle zu importieren/abzurufen, müssen Sie Folgendes hinzufügen: Externe Rollen-ID im Endpunkt (Leertaste drücken > @ > Externe Rollen-ID auswählen).
- Wähle aus Genehmigung Das wird auf der Registerkarte „Autorisierung“ konfiguriert.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Seiteneinstellungen:
- Einrichtung Legende für die nächste Seite (falls die API die Daten in Batches bereitstellt).
- Einrichtung Startseitennummer (sofern die API die Paginierung unterstützt).
- Einrichtung Attributzuordnung um einzelne Berechtigungsattribute mit miniOrange-Attributen zu verknüpfen.
- Karte der Berechtigungsdaten Primärschlüssel wobei der Berechtigungsschlüssel (dem Sie alle Berechtigungen zuweisen) in der Antwort der API enthalten ist.
- Wenn Berechtigungen als Liste von Zeichenketten empfangen werden, verwenden Sie das Attribut Liste der Berechtigungsnamen.
- Wenn Berechtigungen als Schlüssel-Wert-Paare empfangen werden, verwenden Sie Attribute. Berechtigungsname und Berechtigungsbeschreibung.
- Klicken Sie auf Konfiguration speichern.
- Zu Importieren von Rollen- und Berechtigungszuweisungen, Klicken Sie auf Schaltfläche importieren (Pfeil nach unten) entsprechend dem Importrolle Ereignis in der Liste auf der Externe App für miniOrange Tab.
2. miniOrange für externe App-APIs konfigurieren
Navigieren Sie in der benutzerdefinierten Bereitstellungsanwendung zur Registerkarte „miniOrange zu externen Apps“.
2.1 Konfiguration der API zum Erstellen von Rollen
Diese API wird verwendet, wenn Sie im Abschnitt „Rollen und Berechtigungen“ eine Rolle erstellen.
- Im miniOrange zu externer App klicken Sie auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration. Wählen Veranstaltungstyp as Rolle erstellen. Ergänzen Sie die POST-Endpunkt um eine Rolle in der externen Anwendung zu erstellen.
- Wähle aus Genehmigung Die Konfiguration erfolgte auf der Registerkarte „Autorisierung“.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Korpus Um den Anfragetext hinzuzufügen, entnehmen Sie die Struktur der Dokumentation der externen App. Fügen Sie entsprechend den Attributen des Anfragetextes miniOrange-Attribute für die Rolle hinzu, indem Sie die Leertaste drücken > @ > und die relevanten Rollenattribute auswählen.
- Einrichtung Antworteinstellungen zur Abbildung der Status-Taste, Fehler-Taste und externer Bezeichner der in der Antwort enthaltenen Rolle. Behalten Sie den Status- und Fehlerschlüssel bei, falls diese in der Antwort nicht vorhanden sind.
- Klicken Sie auf Konfiguration speichern.
2.2 Konfigurieren der Update-Rollen-API
Diese API wird verwendet, wenn Sie eine Rolle im Abschnitt „Rollen und Berechtigungen“ aktualisieren.
- Gehen Sie zur miniOrange zu externer App Tab und klicken Sie auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration. Wählen Veranstaltungstyp as Rolle aktualisieren. Ergänzen Sie die POST/PUT-Endpunkt Sie müssen hinzufügen Externe Rollen-ID/Name im Endpunkt (Leertaste drücken > @ > Externe Rollen-ID/Name auswählen).
- Wähle aus Genehmigung Die Konfiguration erfolgte auf der Registerkarte „Autorisierung“.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Korpus Um den Anfragetext hinzuzufügen, fügen Sie entsprechend den Attributen des Anfragetextes miniOrange-Attribute für die Rolle hinzu, indem Sie die Leertaste drücken > @ > und die relevanten Rollenattribute auswählen.
- Einrichtung Antworteinstellungen zur Abbildung der Status-Schlüssel und Fehlerschlüssel in der Antwort enthalten.
- Klicken Sie auf Konfiguration speichern.
2.3 Konfigurieren der Löschrollen-API
Diese API wird verwendet, wenn Sie eine Rolle im Abschnitt „Rollen und Berechtigungen“ löschen.
- Gehen Sie zur miniOrange zu externer App Tab. Klicke auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration.
- Auswählen Veranstaltungstyp as Rolle löschen.
- Fügen Sie POST/PUT/DELETE-Endpunkt Sie müssen hinzufügen Externe Rollen-ID/Name im Endpunkt (Leertaste drücken > @ > Externe Rollen-ID/Name auswählen).
- Wähle aus Genehmigung Die Konfiguration erfolgte auf der Registerkarte „Autorisierung“.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Korpus Fügen Sie bei Bedarf den Anfragetext hinzu. Fügen Sie entsprechend den Attributen des Anfragetextes miniOrange-Attribute für die Rolle hinzu, indem Sie die Leertaste drücken > @ > und die relevanten Rollenattribute auswählen.
- Einrichtung Antworteinstellungen zur Abbildung der Status-Schlüssel und Fehlerschlüssel in der Antwort enthalten.
- Klicken Sie auf Konfiguration speichern.
2.4. Konfigurieren der API „Berechtigungen für Rollen zuweisen“
Diese API wird verwendet, wenn Sie während der Rollenkonfiguration im Abschnitt „Rollen und Berechtigungen“ Berechtigungen zu einer Rolle zuweisen.
- Gehen Sie zur miniOrange zu externer App Tab. Klicke auf Konfiguration hinzufügen.
- Stellen Sie eine Name der Ereigniskonfiguration.
- Auswählen Veranstaltungstyp as Berechtigungen einer Rolle zuweisen..
- Fügen Sie POST/PUT-EndpunktSie müssen hinzufügen Externe Rollen-ID/Name im Endpunkt (Leertaste drücken > @ > Externe Rollen-ID/Name auswählen).
- Wähle aus Genehmigung Das wird auf der Registerkarte „Autorisierung“ konfiguriert.
- Bereitstellung eines Industriebodens für Lagerbühnen, der extremen Minustemperaturen und schwerem Rollverkehr standhält, kostengünstiger als Beton ist und eine bessere Ergonomie als Gitterroste bietet. Überschriften Für die API erforderlich.
- Einrichtung Korpus Um den Anfragetext hinzuzufügen, fügen Sie entsprechend den Berechtigungsattributen des Textes miniOrange-Attribute für Berechtigungen hinzu, indem Sie die Leertaste drücken > @ > und die relevanten Berechtigungsattribute auswählen.
- Wenn Berechtigungen als Liste von Zeichenketten gesendet werden sollen, verwenden Sie das Attribut Liste der Berechtigungsnamen.
- Wenn Berechtigungen als Schlüssel-Wert-Paare gesendet werden sollen, verwenden Sie Attribute. Berechtigungsname und Berechtigungsbeschreibung.
- Einrichtung Antworteinstellungen zur Abbildung der Status-Schlüssel und Fehlerschlüssel in der Antwort enthalten.
- Klicken Sie auf Konfiguration speichern.
2.5 Konfigurieren der API zum Zuweisen von Rollen zu Benutzern
Diese API wird verwendet, wenn Sie im Bereich „Rollen und Berechtigungen“ während der Rollenkonfiguration eine Gruppe einer Rolle zuweisen. Benutzer der zugewiesenen Gruppe werden dann in der externen Anwendung der Rolle zugeordnet. Die API wird außerdem aufgerufen, wenn Sie unter „ Gruppen“ >> „Gruppen verwalten“ einen Benutzer einer Gruppe zuweisen.
2.6 Konfigurieren der Aufhebung der Rollenzuweisung über die Benutzer-API
Diese API wird verwendet, wenn Sie im Bereich „Rollen und Berechtigungen“ eine Gruppe von einer Rolle entfernen. Die Benutzer dieser Gruppe werden dann in der externen Anwendung von der Rolle entfernt. Die API wird außerdem ausgelöst, wenn Sie einen Benutzer unter „ Gruppen >> Gruppen verwalten“ von einer Gruppe entfernen.
