Berechtigungen nach Bildschirmordner

Wer beschränkt ist

• Ein Mitglied. Der Projektinhaber beschränkt ein Mitglied auf ausgewählte Bildschirmordner und Bildschirme. Das Mitglied meldet sich wie bisher an und sieht und ändert nur die eigenen Bildschirme.
• Ein Agent. Der Inhaber beschränkt einen Agenten auf dieselbe Weise. Ein Agent reicht außerdem nie weiter als die für ihn verantwortliche Person: Seine Reichweite ist sein eigener Bereich, eingegrenzt durch den Bereich dieser Person, sodass eine beschränkte Person nie über einen weiter gefassten Agenten handelt.
• Nie beschränkt. Der Projektinhaber und Service-Clients des gesamten Projekts.

Eine Beschränkung ist ein Bereich. Er wird bei jeder Anfrage gelesen und nie in einem Token oder einer Sitzung gespeichert, sodass eine Änderung bei der nächsten Anfrage der Person gilt, ohne dass sie sich erneut anmelden muss. Ein Aufrufer ohne Bereich arbeitet im gesamten Projekt und zahlt nichts für die Prüfung.

Ordner und Vererbung

Bildschirmordner sind die Hierarchie. Ein Bereich, der einen Ordner nennt, umfasst jeden Bildschirm in diesem Ordner und in jedem Ordner darin, und er folgt dem Ordner, wenn dieser verschoben wird.

Hotel
  Lobby            <- the lobby manager's scope holds Lobby and Bar
    Bar
  Casino Floor     <- the floor manager's scope holds Casino Floor
  Rooms

• Ein Bereich umfasst bis zu 1.000 Ordner und 200 einzelne Bildschirme und mindestens einen von beiden.
• Ein einzelner Bildschirm kann in beliebig vielen Bereichen liegen, ebenso ein Ordner.
• IDs müssen beim Schreiben des Bereichs aktive Ordner und Bildschirme des Projekts nennen. Ein später gelöschter Ordner oder Bildschirm hinterlässt eine ID, die nichts gewährt.
• Ein Mitglied, das Überprüfungen genehmigt, ist auf Ordner beschränkt. Einzelne Bildschirme sind für Mitglieder gedacht, die nicht genehmigen.
• Eine Person ist entweder auf Bildschirme beschränkt oder ein Uploader, nie beides: Ein Uploader ist auf Inhalte beschränkt, ein beschränktes Mitglied auf Bildschirme.

Einen Bereich setzen

Nur der Projektinhaber setzt, ändert oder beendet einen Bereich, im Dashboard.

1. Öffnen Sie die Seite Zugriff des Dashboards.
2. Öffnen Sie unter Personen das Mitglied und verwenden Sie Bildschirme. Prüfen Sie die Ordner, die alles darin einschließen, und fügen Sie einzelne Bildschirme hinzu, wenn das Mitglied nicht genehmigt. Speichern.
3. Öffnen Sie bei einem Agenten ihn unter Agenten und verwenden Sie dasselbe Steuerelement Bildschirme.
4. Um eine Person zu beschränken, bevor sie beitritt, fügen Sie der Einladung den Bereich hinzu.

Entfernen Sie den Bereich an derselben Stelle, um dem Mitglied wieder das gesamte Projekt zu geben.

Das Setzen des Bereichs eines Mitglieds beendet die Agenten, die diese Person ins Projekt gebracht hat, sodass nichts die weitere Reichweite behält, die ihm zuvor gegeben wurde. Ein Bereich wird abgelehnt, solange die Person oder ein von ihr mitgebrachter Agent einen aktiven Service-Client des Projekts hält: Widerrufen Sie jeden Client, den die Ablehnung nennt, und setzen Sie den Bereich erneut. Die Übertragung des Projekts an ein Mitglied entfernt den Bereich dieses Mitglieds.

Ein mit einem Bereich eingeladenes Mitglied tritt als Mitglied bei, das nicht genehmigen kann. Der Inhaber schaltet auf derselben Seite Kann genehmigen für es ein, wenn es Überprüfungen für seine Ordner entscheiden soll.

Was eine beschränkte Person tut und sieht

Innerhalb des Bereichs arbeitet eine beschränkte Person wie ein Mitglied des Projekts, im Dashboard, mit der CLI und über die API:

• Bildschirme. Lesen, Gesundheit, Wiedergaben, Betriebszeit, Screenshots und Live-Ansicht, Kommentare, Befehle wie Neustart, Cache leeren, Identifizieren und Aktualisieren, Tags, Felder, Standort, Name, Playlist, Playlist-Zeitplan, Übernahme, Archivieren und Löschen.
• Ordner. Ordner innerhalb des Bereichs erstellen, umbenennen, verschieben und löschen sowie die Standard-Playlist eines Ordners festlegen. Der Ordner, den ein Bereich nennt, bleibt bestehen: Ihn löscht nur eine Person mit einem weiter gefassten Bereich.
• Verschiebungen. Ein Bildschirm oder Ordner wird von einer Stelle innerhalb des Bereichs an eine andere verschoben. Quelle und Ziel liegen beide darin.
• Kampagnen. Eine Kampagne erstellen, ändern und löschen, deren gesamte Zielgruppe innerhalb des Bereichs liegt.
• Flottenaktionen. Bildschirme per ID oder nach Ordner innerhalb des Bereichs auswählen.
• Neue Bildschirme. Eine beschränkte Person, die genehmigen kann, koppelt oder richtet einen Bildschirm in einem Ordner des Bereichs ein. Der neue Bildschirm nennt seinen Ordner, sodass er innerhalb des Bereichs landet.
• Notizen. Notizen über die eigenen Bildschirme, über Playlists und ohne Bezug lesen und schreiben.

Inhalte (Medien, Playlists, Anwendungen, Karten, Kartendaten) unterliegen weiterhin der Rolle des Mitglieds, genau wie bei jedem Mitglied.

Eine beschränkte Person erreicht keine Projektverwaltung: Mitglieder, Einladungen, Service-Clients, Agent-Anmeldungen, Flottenverknüpfungen, Abrechnung, Einstellungen, Webhooks, Benachrichtigungen, Alarme, Trigger, Zeitplan-Importe und projektweite Berichte werden abgelehnt. Jede wird mit outside_screen_scope beantwortet.

Eine Kampagne ist nur innerhalb des Bereichs bearbeitbar

Eine Kampagne wird jedem aufgelistet, und eine beschränkte Person bearbeitet sie nur, wenn ihre gesamte Zielgruppe innerhalb ihres Bereichs liegt. Andernfalls ist editable gleich false, und die Kampagne ist für sie schreibgeschützt.

• Ein Ordner oder Bildschirm im Bereich liegt darin.
• Eine any-Regel liegt innerhalb, wenn jedes Kind darin liegt.
• Eine all-Regel liegt innerhalb, wenn mindestens ein Kind darin liegt, denn sie ist ein Schnitt.
• Eine Tag-Regel und die Regel für jeden Bildschirm liegen nie innerhalb.

Eine beschränkte Person, die nicht genehmigen kann

Ein beschränktes Mitglied, das keine Überprüfungen genehmigen kann, liest alles im Bereich und führt Befehle aus, macht Screenshots und kommentiert, ändert aber nur über eine genehmigende Person, was wiedergegeben wird. Das Zuweisen einer Playlist, Zeitpläne, Übernahmen, Kampagnen, Ordner und Verschiebungen werden für sie mit approver_required beantwortet. Ein Mitglied ohne Bereich bleibt unverändert.

Was außerhalb des Bereichs liegt

Bildschirme außerhalb des Bereichs sind in jeder Liste ausgeblendet: der Bildschirmliste, den Bildschirmen eines Ordners, den Kampagnenbildschirmen, dem Kalender, den Ereignissen und dem Live-Stream. Der Ordnerbaum zeigt die Ordner des Bereichs und die Ordner darüber, schreibgeschützt und ohne Bildschirmanzahl, damit der Baum eine Wurzel hat. Ihre Geschwister sind ausgeblendet.

Eine Anfrage, die einen Bildschirm, Ordner, Selektor oder eine Zielgruppe außerhalb des Bereichs nennt, wird vollständig abgelehnt und nie eingegrenzt: Es wird nichts geschrieben. Eine ID außerhalb des Bereichs und eine ID, die nicht existiert, erhalten dieselbe Antwort.

{
  "status": 403,
  "errors": [
    {
      "code": "outside_screen_scope",
      "screen_scope": { "folder_ids": ["sfd_01LOBBY"], "screen_ids": [] },
      "hint": "Ask the project owner to widen the scope, or leave this to a member of the whole project."
    }
  ]
}

screen_scope nennt den eigenen Bereich des Aufrufers, damit dieser erkennt, was er nutzen darf. Wiedergabeaufzeichnungen, der Kalender und das Player-Protokoll akzeptieren einen Bildschirm des Bereichs (der Kalender auch einen Ordner). Der projektweite Gesundheitsverlauf und die tägliche Betriebszeit werden abgelehnt; der Gesundheitsverlauf und die Betriebszeit pro Bildschirm sind offen.

Delegierte Verwaltung

Geben Sie einem Venue-Manager seine Ordner und lassen Sie ihn sie betreiben:

1. Der Inhaber beschränkt den Manager auf die Ordner des Standorts.
2. Der Inhaber schaltet Kann genehmigen für den Manager ein.
3. Der Manager weist Playlists, Zeitpläne und Kampagnen in seinen Ordnern direkt zu und entscheidet über die Überprüfungen, die Agenten für diese Ordner vorschlagen.

Eine genehmigende Person mit Beschränkung entscheidet nur eine Überprüfung, deren gesamte Reichweite innerhalb ihres Bereichs liegt, und die Seite Überprüfungen listet nur diese auf. Eine beschränkte genehmigende Person entscheidet keine Überprüfung von Werbekreativen. Eine Überprüfung, die einen Bildschirm außerhalb des Bereichs erreicht, wird mit outside_screen_scope beantwortet.

Mitglieder, Gäste und Admins der Organisation

Eine Person hat höchstens eine Heimatorganisation. Die Personen, deren Heimatorganisation sie ist, sind ihre Mitglieder. In einem Projekt jeder anderen Organisation ist eine Person extern, ein Gast, und die Personenliste des Projekts kennzeichnet sie. Die Mitgliedschaft in einem Projekt bleibt der einzige Weg zu dessen Inhalten. GET /api/session meldet für eine Person organization, und GET /api/members kennzeichnet jeden Gast mit external.

• Mitglied werden. Ein Admin der Organisation lädt eine Person per E-Mail ein; mit der Annahme wird diese Organisation zu ihrer Heimatorganisation anstelle jeder anderen. Personen an einer verifizierten Domain der Organisation sind Mitglieder, ebenso jede Person, die über Single Sign-on oder Benutzerbereitstellung verwaltet wird. Eine Person ohne Heimatorganisation, die ein Projekt erstellt, übernimmt die Organisation dieses Projekts als Heimatorganisation. Der Beitritt zu einem Projekt ändert nie die Heimatorganisation.
• Mitglied entfernen. Ein Admin entfernt ein Mitglied aus der Organisation. Die Heimatorganisation der Person wird gelöscht, und der Projektzugriff, den ein Admin oder eine Einladung ihr gewährt hat, endet; Zugriff, den die Benutzerbereitstellung gewährt, bleibt bei der Bereitstellung. Eine entfernte Person bleibt ausgeschlossen, auch an einer verifizierten Domain, bis zu einer neuen Einladung. Das Entfernen wird abgelehnt, solange die Person ein Projekt der Organisation besitzt (member_owns_projects): Übertragen Sie es zuerst. Eine Person, die der Identitätsanbieter der Organisation verwaltet, wird dort entfernt (managed_member), und ein Admin wird entfernt, nachdem sein Admin-Platz endet (organization_admin_member).

Gastrichtlinie

Eine Organisation legt in den Organisationseinstellungen fest, wen sie als Gäste in ihre Projekte zulässt.

Die Richtlinie gilt für Personen, wenn sie einem Projekt hinzugefügt werden: bei einer Einladung, erneut bei deren Annahme, durch eine Gruppenzuordnung und wenn ein Admin jemanden hinzufügt. Mitglieder und die eigenen Admins der Organisation werden nie abgelehnt. Eine Ablehnung lautet guest_not_allowed. Eine Verschärfung der Richtlinie entfernt niemanden: Die Seite Personen markiert jeden Gast, den die Richtlinie nicht zulassen würde.

Bibliothek

Ein Organisations-Admin wählt in den Organisationseinstellungen ein Projekt als Bibliothek der Organisation (Premium, Education und Enterprise). Alle anderen Projekte der Organisation nutzen dann die Medien, Ordner und Playlists der Bibliothek schreibgeschützt:

• Platzieren Sie seine Medien auf Seiten.
• Spielen Sie einen Bibliotheksordner mit einem Ordner-Selektor ab. Tag- und Alle-Selektoren verwenden nur die eigenen Medien des Projekts.
• Planen Sie seine Playlists ein und starten Sie Playlists aus seinen Vorlagen.

Nur die eigenen Mitglieder der Bibliothek ändern sie. Ein Projekt mit Bildschirmen kann nicht die Bibliothek sein, und sobald es die Bibliothek ist, lassen sich ihr keine Bildschirme hinzufügen (library_no_screens). Agenten listen die Bibliothek mit screenrig media list --library, screenrig media folder list --library und screenrig playlist list --library auf.

Was ein Organisations-Admin tut

Ein Admin hat Befugnis über jedes Projekt der Organisation und liest die Inhalte eines Projekts erst, nachdem er ihm beigetreten ist.

• Einem Projekt beitreten. Der Admin tritt jedem Projekt der Organisation als genehmigende Person ohne Bereich bei, auch wenn er bereits ein eingeschränktes Mitglied war. Das wird im Audit-Protokoll aufgezeichnet und löst eine E-Mail an den Inhaber des Projekts aus. Ein erneuter Beitritt ändert nichts.
• Inhaber ändern. Der Admin macht ein verifiziertes Projektmitglied oder ein anderes Mitglied der Organisation zum Inhaber des Projekts, auch wenn der Inhaber ausgetreten oder deaktiviert ist. Ein Admin, der dem Projekt beigetreten ist, kann sich selbst zum Inhaber machen. Das wird aufgezeichnet, und der bisherige und der neue Inhaber erhalten eine E-Mail.
• Projektmitglied entfernen. Der Admin entfernt jedes Mitglied, das weder der Inhaber noch er selbst ist. Das wird aufgezeichnet.
• In einem Projekt, dem der Admin als Mitglied angehört, hat er die Mitgliederfunktionen des Inhabers gegenüber anderen Personen: Mitglieder entfernen, festlegen, wer genehmigen darf, Bildschirm- und Upload-Bereiche festlegen, die Inhaberschaft übertragen und SCIM-Gruppen zuordnen.

Geschützte Ordner

Ein geschützter Ordner ist für Bildschirme gedacht, auf denen keine einzelne Person ändert, was abgespielt wird. Eine Person, die genehmigen kann, schaltet im Dashboard Geschützt für einen Ordner ein, und der Schutz gilt für jeden Ordner darin. Agenten und Service-Clients schützen nie einen Ordner, und ein Agent hebt den Schutz nur als Vorschlag auf: screenrig screen folder update ID --unprotect wird zu einer Überprüfung, die eine zweite genehmigende Person entscheidet. Eine beschränkte genehmigende Person schützt Ordner innerhalb ihres Bereichs, nicht einen Ordner, den ihr Bereich nennt. Eine Änderung, die einen Bildschirm in einem geschützten Ordner erreicht, wird bei jedem Zugriffslevel, auch bei Verwalten, zu einer Überprüfung, die eine zweite genehmigende Person entscheidet.

Ein Agent, der eine Playlist einem Bildschirm in einem geschützten Ordner zuweist, erhält pending_review und die Überprüfung. Der Bildschirm spielt weiter, was er gespielt hat, bis eine zweite genehmigende Person entscheidet.

screenrig screen assign scr_01EXAMPLESCREEN000000000 --playlist-id pl_01WELCOME
screenrig reviews list --kind protected_change
screenrig reviews show rvw_01EXAMPLEREVIEW0000000000

Was mit einer Änderung geschieht, hängt von der Änderung ab:

• Eine Überprüfung. Das Zuweisen einer Playlist sowie das Setzen oder Löschen eines Playlist-Zeitplans oder einer Übernahme, auf einem Bildschirm oder einer Flotte, ist eine Überprüfung vom Typ screen_change. Das Erstellen, Ändern oder Löschen einer Kampagne, deren Zielgruppe einen geschützten Bildschirm erreicht, das Erstellen eines Ordners in einem geschützten Ordner, das Verschieben, Löschen oder Festlegen der Standard-Playlist eines Ordners, der in einem geschützten Ordner liegt oder einen enthält, das Verschieben von Bildschirmen oder Ordnern in einen geschützten Ordner hinein oder aus ihm heraus sowie das Aufheben des Schutzes sind eine Überprüfung vom Typ protected_change. Die Änderung wird mit der genehmigenden Entscheidung angewendet. Eine Umbenennung ist sofort live.
• Eine Ablehnung. Änderungen an Tags, Feldern, Standort, Zeitzone und Videowand, das Ersetzen eines Bildschirms, Löschen, Archivieren, Sperren, die Display-Stromversorgung und ihr Zeitplan, eine Play-Seite, ein Toast, Werbeinventar, Trigger-Ziele und Zeitplan-Importe, die einen geschützten Bildschirm erreichen, werden mit protected_target beantwortet. Um die Änderung vorzunehmen, hebt eine genehmigende Person den Schutz über eine Überprüfung auf, die Änderung wird vorgenommen, und der Ordner wird wieder geschützt. Ein Trigger, der sich verteilt, lässt geschützte Bildschirme unverändert und zählt sie.
• Offen. Fortsetzen, Archivierung aufheben, Neustarten, Neuladen, Identifizieren, Wartung und Screenshots bleiben offen.

Eine Überprüfung wartet auf eine Person, die weder die vorschlagende Person noch die für den vorschlagenden Agenten oder Service-Client verantwortliche Person ist. Die Entscheidung wird mit second_approver_required abgelehnt, wenn die entscheidende Person dieselbe ist. Hat das Projekt nur eine genehmigende Person, sagt die Ablehnung, ein weiteres Mitglied zur genehmigenden Person zu machen. Eine Änderung, die vorgeschlagen wurde, bevor ihr Ordner geschützt wurde, unterliegt der Regel, wenn sie genehmigt wird. Eine Überprüfung, die während des Wartens veraltet ist, wird mit review_stale beantwortet; schlagen Sie die Änderung erneut vor.

Ein Projekt ohne geschützten Ordner zahlt nichts für die Regel.

Reservierte Kampagnen

Eine Kampagne mit der Markierung Reserviert wird nur von einer Person geändert, pausiert, gelöscht oder auf nicht reserviert gesetzt, die Überprüfungen genehmigen kann: vom Inhaber oder von einer genehmigenden Person, deren Bereich die gesamte Zielgruppe der Kampagne umfasst. Eine Person schaltet Reserviert im Formular der Kampagne im Dashboard ein. Agenten und Service-Clients ändern eine reservierte Kampagne nie, auf keiner Zugriffsstufe, und ihre Versuche werden mit reserved_item beantwortet. Reservieren Sie die Kampagne, die den festen Zeitplan einer Marke trägt, und ein Manager oder ein Agent kann sie nicht versehentlich ändern.

Tags sind kein Bereich

Ein Bereich besteht aus Ordnern und einzelnen Bildschirmen. Jeder, der einen Bildschirm ändern darf, kann seine Tags schreiben, sodass ein Tag-Bereich es einem Manager erlauben würde, die eigene oder die Reichweite eines anderen Managers zu erweitern. Verwenden Sie Ordner für die Zuständigkeit und Tags für die Auswahl darin.

Eine Flottenaktion oder Kampagne, die per Tag auswählt, wird einer beschränkten Person vollständig verweigert, mit outside_screen_scope, und der Hinweis sagt, nach IDs oder nach Ordner auszuwählen.

Agenten

Ein beschränkter Agent arbeitet mit der CLI so, wie ein beschränktes Mitglied im Dashboard.

screenrig agent status
screenrig screen list
screenrig screen folder list
screenrig screen pair "$PAIRING_CODE" --folder sfd_01LOBBY --name "Lobby entrance"
screenrig screen assign scr_01EXAMPLESCREEN000000000 --playlist-id pl_01WELCOME
screenrig screen folder update sfd_01LOBBY --unprotect
screenrig campaign show cmp_01EXAMPLECAMPAIGN0000000

• agent status zeigt die screen_scope des Agenten und die person_screen_scope der für ihn verantwortlichen Person.
• screen list und screen folder list enthalten nur seine Bildschirme und Ordner.
• screen pair akzeptiert --folder und braucht einen Ordner des Bereichs.
• screen folder update ID --unprotect schlägt vor, den Schutz eines Ordners aufzuheben, allein gesendet. Daraus wird eine Überprüfung, die eine zweite genehmigende Person entscheidet.
• campaign show gibt editable und reserved aus.
• Ohne ausgewähltes Projekt lässt screen list ein Projekt aus, in dem der Agent beschränkt ist. Wählen Sie das Projekt aus.

Ablehnungen und wie man sie behebt

Jede Ablehnung nennt den Weg zurück in ihrem hint.

Eine akzeptierte geschützte Änderung wird mit 202 mit status: pending_review und der Überprüfung beantwortet, derselben Antwort, die ein Agent mit Propose-Zugriff erhält. Folgen Sie ihr mit screenrig reviews show ID.

Audit

Jede Änderung ist ein Ereignis im Protokoll des Projekts, geschrieben in der Transaktion, die die Änderung vornimmt:

Überprüfungen schreiben die üblichen review.*-Ereignisse, und die genehmigende Person ist der Akteur dessen, was eine Überprüfung anwendet.

API

Die Routen des Inhabers verwenden die Dashboard-Sitzung.

Die Organisationsrouten akzeptieren die Dashboard-Sitzung eines Admins. Agenten und Bearer-Anmeldeinformationen haben keine.

Die API-Referenz listet jede Anfrage, Antwort und jedes Problem auf. Die Probleme stehen in den Problemtypen.

Verwandt

• Authentifizierung: Zugriffsstufen, Überprüfungseinstellungen und Uploader.
• Agenten: wie Überprüfungen für Änderungen eines Agenten funktionieren.
• Signage-CLI: Bildschirmordner und Flottenbefehle.
• Service-Clients: Anmeldedaten für Server und CI-Jobs.