Direkt zum Hauptinhalt

Eine Rolle erstellen

Ziel​

Eine Rolle in Ihrem Mandanten erstellen, damit sie Benutzern zugewiesen werden kann – und wissen, wohin Sie als Nächstes gehen, um ihr tatsächlich Zugriff zu geben.

Voraussetzungen​

  • Sie sind als Plattformadministrator beim Admin Control Center angemeldet.

Schritte​

  1. Öffnen Sie die Seite Rollen über die linke Navigation.
  2. Wählen Sie Neu aus. Ein Seitenbereich öffnet sich.
  3. Geben Sie einen Anzeigenamen ein – das, was Personen lesen – und einen logischen Namen, der die Identität der Rolle ist. Fügen Sie eine Beschreibung hinzu, wofür die Rolle da ist.
  4. Wählen Sie Speichern aus.
  5. Geben Sie der Rolle Zugriff: Öffnen Sie Lösungen, öffnen Sie die Lösung, in der die Anwendung liegt, und verwenden Sie deren Seite Rollen (siehe Einer Rolle Zugriff auf Datensätze gewähren). Eine gerade erstellte Rolle erlaubt überhaupt nichts.

Eine Rolle hat zwei Namen​

Darüber stolpert man einmal und dann nie wieder, daher lohnt sich ein kurzer Blick.

Was er istKönnen Sie ihn ändern?
AnzeigenameDie Worte, die Personen lesen – „Vertrieb & Presales“Ja
Logischer NameDie Identität der Rolle – salesNein

Der logische Name ist keine Beschriftung. Er ist der Claim, den das Token eines angemeldeten Benutzers trägt, und der Schlüssel, unter dem jede Umgebung die Berechtigungen der Rolle speichert. Ihn zu ändern, würde jede dieser Gewährungen auf eine Rolle zeigen lassen, die es nicht mehr gibt – und zwar stillschweigend, denn „eine Rolle ohne Gewährungen“ ist ein völlig gültiger Zustand, der einfach nichts erlaubt. Niemand würde es bemerken, bis jemand einen Datensatz nicht öffnen kann. Es funktioniert genau wie der logische Name einer Tabelle und ist aus genau demselben Grund unveränderlich.

Der Anzeigename wird immer nur von Personen gelesen, daher macht seine Änderung nichts kaputt. Soll die Rolle anders heißen, ändern Sie diesen.

Rollen, die Sie hier erstellen, sind Systemrollen: Ihr logischer Name trägt kein Herausgeberpräfix, weil eine Rolle, die Ihre Organisation erfindet, Ihnen gehört und nicht der App von irgendjemandem. Eine Rolle mit einem Namen mit Präfix wie par_sales wurde innerhalb einer Lösung erstellt oder kam mit einer.

Eine Rolle bearbeiten​

Klicken Sie auf die Zeile einer Rolle – oder aktivieren Sie sie und wählen Sie Bearbeiten aus –, um den Seitenbereich erneut zu öffnen. Anzeigename und Beschreibung sind bearbeitbar; der logische Name wird gesperrt angezeigt, damit Sie die Identität, auf die sich ein Paket oder eine Fehlermeldung bezieht, weiterhin lesen können.

Brauchen Sie wirklich einen anderen logischen Namen – was selten vorkommt –, ist das bewusste Arbeit statt einer Bearbeitung:

  1. Erstellen Sie die neue Rolle.
  2. Gewähren Sie ihr in jeder Lösung denselben Zugriff. Rolle kopieren auf der Seite „Rollen“ der Lösung erledigt das in einem Schritt (siehe Einer Rolle Zugriff auf Datensätze gewähren).
  3. Übertragen Sie ihre Benutzer (siehe Einem Benutzer eine Rolle zuweisen).
  4. Löschen Sie die alte Rolle.

Eine Rolle gewährt von sich aus nichts​

Das Erstellen einer Rolle gibt ihr einen Namen und sonst nichts. Was sie tun darf, wird innerhalb einer Lösung entschieden – und das ist kein Zufall der Platzierung dieser Seite. Eine Berechtigung nennt eine Tabelle, Tabellen gehören zu einer Umgebung, und eine Gewährung, die Test und Produktion erreichen soll, muss in einem Paket reisen. Innerhalb einer Lösung zu stehen legt beides auf einmal fest, weshalb diese Seite nie fragen muss, welche Umgebung Sie meinen.

Die RolleIhre Berechtigungen
GeltungsbereichDer gesamte MandantEine Lösung, in einer Umgebung
EnthältDen Namen und die BeschreibungWas sie erstellen/lesen/aktualisieren/löschen darf, und bei welchen Datensätzen
WoDiese SeiteLösungen → Ihre Lösung → Rollen
Zugewiesen anBenutzer, auf der Seite „Benutzer“Nichts – sie sind die Gewährungen der Rolle

Was im Hintergrund passiert​

Die Rolle wird ohne Berechtigungen in Ihrem Mandanten erstellt. Meldet sich ein Benutzer an, der sie innehat, reist die Rolle als Claim in seinem Token; jede Umgebung sieht dann nach, was diesem Namen dort gewährt wurde.

Fehlerbehebung​

  • „Eine Rolle namens … existiert bereits.“ – eine Rolle mit diesem Namen ist bereits vorhanden. Wählen Sie einen anderen Namen.
  • Das Feld für den logischen Namen ist ausgegraut. – Sie sehen eine bestehende Rolle an, und dieser Name ist unveränderlich. Wollten Sie ändern, wie die Rolle heißt, ändern Sie den Anzeigenamen direkt darüber; dieser ist bearbeitbar, und nichts geht kaputt.
  • Sie können eine Rolle nicht löschen – eine Rolle, die noch einem oder mehreren Benutzern zugewiesen ist, kann nicht gelöscht werden. Entfernen Sie sie zuerst bei diesen Benutzern (siehe Einem Benutzer eine Rolle zuweisen) und löschen Sie sie dann.
  • Bearbeiten ist ausgegraut. – es wirkt auf genau eine Rolle. Aktivieren Sie eine einzelne Zeile oder klicken Sie einfach auf die gewünschte Zeile.
  • Ich habe eine Rolle erstellt, und der Benutzer kann immer noch nichts tun. – erwartet. Gewähren Sie ihr auf der Seite Rollen einer Lösung Zugriff, in jeder Umgebung, in der sie etwas erreichen soll.

Verwandte Szenarien​