Publicació i permisos¶

Exercici publishing-and-permissions-annex.pdf · PDF

Una pregunta ràpida. A part de tu i del teu professor, qui ha vist el teu quadre de comandament (dashboard) Steam market?

Ningú. Vas construir la fila de KPI, les pestanyes i els filtres, i tot plegat continua vivint en un lloc on només tu pots obrir-lo. Això és un problema, perquè un quadre de comandament es fa perquè el llegeixi una altra persona. Un quadre de comandament que ningú no pot obrir no el llegeix ningú, per bons que siguin els seus gràfics.

Així que en aquesta lliçó canvies de seient. Deixes de ser l'autor i et converteixes en el lector: entres com una persona amb gairebé cap dret, descobreixes per què no veu res i ho arregles pas a pas.

Un servidor de joc amb dos panys¶

Pensa en un servidor d'un joc multijugador. Mentre el propietari encara construeix el món, el servidor és privat: només hi entren el propietari i els administradors. Un dia s'obre. Però fins i tot llavors, cada jugador té un rang, i el rang decideix a quines zones pot entrar.

Superset funciona igual. Entre el teu quadre de comandament i un lector hi ha dos panys, i cadascun necessita la seva clau:

flowchart LR
    R["<b>Un lector</b><br>amb sessió a Superset"] --> L1{"<b>Pany 1</b><br>El quadre de comandament<br>està Published?"}
    L1 -- "No: Draft" --> X1["No surt a la seva llista"]
    L1 -- "Sí" --> L2{"<b>Pany 2</b><br>Algun dels seus rols<br>té accés al dataset?"}
    L2 -- "No" --> X2["Encara no surt a la seva llista"]
    L2 -- "Sí" --> OK["<b>Llegeix el quadre de comandament</b><br>i els filtres funcionen"]

Mantindrem el servidor de joc durant tota la pàgina. Recorda la forma del diagrama: dues preguntes, en aquest ordre.

Pany 1: Draft o Published¶

Un quadre de comandament en esborrany (draft) és un que encara s'està construint: només el poden veure els seus propietaris i els admins. Un quadre de comandament publicat és un que l'autor ha declarat llest.

Obre el teu quadre de comandament Steam market i mira al costat del títol. Hi ha una etiqueta petita: Draft. La documentació de Superset és contundent sobre què vol dir:

"Draft dashboards are only visible to the dashboard owners and admins."

Fes clic a l'etiqueta i es transforma en Published. A la llista Dashboards, la columna Status també canvia.

Qui són els propietaris (owners)? Els usuaris que tenen permís per editar el quadre de comandament. Tu ets un d'ells, perquè el vas crear. Un propietari és el constructor d'aquell món; publicar és el moment en què el constructor obre el servidor.

Pany 2: rols i datasets¶

Un rol és un conjunt de permisos amb nom. Cada usuari té un o més rols, i un usuari pot fer exactament el que els seus rols permeten.

Un permís és un únic dret: veure aquest menú, llegir aquest dataset, editar aquell gràfic. Ningú no reparteix els permisos un per un a cada usuari: seria interminable. Poses els permisos dins d'un rol i dones el rol a la gent. El rol és el rang al servidor de joc.

Superset porta tres rols principals. La seva documentació els descriu així:

A la teva màquina virtual ets Admin. Per això tot ha funcionat sempre: un admin travessa totes les portes. Un lector de veritat sol ser Gamma.

Ara la pregunta que importa. Un usuari Gamma i un quadre de comandament que acabes de publicar. El veu?

Encara no. Altra vegada la documentació de Superset:

"Published dashboards are visible to all users with access to the underlying datasets."

Llegeix lentament les quatre últimes paraules. A Superset, els permisos pengen del dataset, i el quadre de comandament els hereta. El teu quadre de comandament Steam market està construït sobre el dataset games_clean. Un usuari Gamma sense accés a games_clean no pot veure cap gràfic fet a partir d'ell, així que tampoc no pot veure el quadre de comandament.

Published obre el primer pany; l'accés al dataset obre el segon.

El mínim que els deixa llegir¶

Podries saltar-te tot això i fer Admin cada lector. El quadre de comandament apareixeria a l'instant. També deixaria que cada lector esborrés cada quadre de comandament i llegís cada dataset del servidor.

Els experts en seguretat tenen un nom per a l'instint correcte, i és més antic del que et pensaries. El 1975, Jerome Saltzer i Michael Schroeder van publicar un article titulat The Protection of Information in Computer Systems. Un dels seus principis de disseny es va fer famós com a principi del mínim privilegi: cada usuari ha de treballar amb el conjunt de drets més petit que li permeti fer la seva feina, i res més.

Per a un lector de quadres de comandament, aquest conjunt mínim és fàcil d'escriure:

Gamma més un rol. Aquesta és tota la recepta, i és el que construiràs ara.

Prova-ho: els ulls del lector¶

Necessites dues finestres del navegador. La normal és tu, l'Admin. Una finestra privada (d'incògnit) és el lector. Una finestra privada no comparteix la teva sessió, i per això és la manera que una sola persona entri com a dos usuaris alhora.

Treballa a la teva VM, en ordre, i anota cada resultat abans de continuar. L'experiment només té sentit si veus cada "no" abans d'arreglar-lo.

Pas 1 — Un lector que no veu res. Comprova que Steam market encara diu Draft. Després crea el lector:

Hauries de veure una llista Dashboards buida. Charts i Datasets també estan buits. I els menús són més curts: el menú SQL (amb SQL Lab) ha desaparegut, i també les entrades Security dins de Settings. Un usuari Gamma ni tan sols pot arribar a la pantalla on es creen els usuaris.

Pas 2 — Obre el primer pany. A la finestra Admin, obre Steam market i fes clic a Draft → Published. A la finestra privada, recarrega Dashboards.

Continua buida. No arreglis res encara: aquest és el moment més important de la lliçó. El quadre de comandament està publicat i el lector continua sense veure'l. El primer pany és obert. El segon, no.

Pas 3 — Obre el segon pany. Ara dona al lector un rang que arribi a les dades:

Ara el lector obre el quadre de comandament. La fila de KPI diu 26,685 · 11.6% · 4.99 · 623, exactament igual que per a tu, i els filtres funcionen.

Aquests quatre números no són cap casualitat. Els gràfics del lector executen la mateixa consulta sobre les mateixes dades que els teus:

SELECT COUNT(*), ROUND(100 * AVG(is_free::int), 1),
       PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY price),
       COUNT(*) FILTER (WHERE owners_tier = 'Hit')
FROM games_clean;

Un rol decideix si pots llegir un dataset. No canvia què diu el dataset.

Pas 4 — Un enllaç no és una clau. Al quadre de comandament, a la finestra Admin: els tres punts → Share → Copy permalink to clipboard. A la finestra privada, tanca la sessió i enganxa l'enllaç. Després torna a entrar com a viewer i enganxa'l una altra vegada.

Sense sessió, l'enllaç et porta a la pàgina d'inici de sessió. Amb la sessió de viewer, obre el quadre de comandament, amb els filtres exactament com eren quan es va copiar l'enllaç. Un permalink (enllaç permanent) és una adreça que recorda l'estat del quadre de comandament. No porta cap dret.

Els quatre estats¶

Posa les teves notes una al costat de l'altra. Aquesta taula és tota la lliçó:

A l'estat 2, on era el problema: al quadre de comandament o a les dades? A les dades. El quadre de comandament estava llest. El rang del lector no arribava al dataset.

Idees clau¶

• Un quadre de comandament existeix perquè el llegeixi una altra persona. Entre ell i un lector hi ha dos panys.
• Pany 1 — Draft o Published. Un esborrany només el veuen els seus propietaris (els usuaris que el poden editar) i els admins. Published vol dir "ja no és un esborrany", no "públic a internet".
• Pany 2 — rols i datasets. Un rol és un conjunt de permisos. Admin ho pot fer tot, Alpha veu totes les dades però només modifica el que és seu, Gamma només veu el que està construït sobre datasets als quals se li ha donat accés.
• Els permisos pengen del dataset; el quadre de comandament els hereta. Donar accés a un dataset obre tot el que s'hi ha construït.
• Mínim privilegi (Saltzer i Schroeder, 1975): dona a un lector el mínim que li permeti llegir — Gamma més un rol.
• Un permalink és una adreça, no una clau. I els rols viuen a Superset: la base de dades no té cap usuari nou.

Comprovació ràpida¶

El teu quadre de comandament ja té lectors. Però què passa si aquests lectors treballen en un lloc que no ha sentit mai a parlar de Superset? Ara toca Informes amb Power BI, on reconstrueixes tres dels teus gràfics de Steam en una altra eina i comproves que el que saps continua funcionant.