Przejdź do głównej zawartości

Odczyt danych i zalogowany użytkownik

Serwerowa aplikacja Panel może odczytywać dane PlaidCloud — i robi to jako osoba, która ją przegląda. Gdy ktoś otwiera aplikację, PlaidCloud loguje go przy użyciu tego samego jednokrotnego logowania (SSO), z którego korzysta cała platforma, a każde wywołanie aplikacji działa z własnymi uprawnieniami przeglądającego. Nie ma współdzielonego konta usługi, a aplikacja nigdy nie zobaczy danych, których sam przeglądający nie mógłby zobaczyć.

Dotyczy to wyłącznie aplikacji Server. Aplikacje WASM działają w całości w przeglądarce i nie mają połączenia po stronie serwera.

Użyj PlaidConnection, podając projekt, z którego chcesz odczytywać dane:

from plaidcloud.utilities.connect import PlaidConnection
conn = PlaidConnection(project_id="<your-project-id>")

To cała konfiguracja. Nie podajesz tokenu, nazwy użytkownika ani hasła — połączenie automatycznie uwierzytelnia się jako zalogowany przeglądający. Identyfikator projektu znajdziesz w adresie URL projektu lub na jego stronie ustawień.

Nadaj aplikacji projekt. Aplikacja opublikowana z projektem wybranym w polu Projekt domyślnie odczytuje ten projekt, a Data API używa go dla table("name"). W przypadku aplikacji bez projektu przekaż project_id do PlaidConnection, jak powyżej; samo PlaidConnection() nie ma projektu do odczytu.

Mając połączenie, pobierz tabelę do ramki danych pandas według nazwy:

df = conn.get_dataframe("Sales Ledger")

Ponieważ połączenie jest przeglądającym, zwraca ono tylko te wiersze, które przeglądający może zobaczyć, i zgłasza błąd uprawnień, jeśli nie ma on w ogóle dostępu do projektu.

Odczytuj tabele według nazwy, a nie za pomocą własnego SQL. W projekcie, w którym administrator włączył Dostęp do wierszy, odczyt według nazwy zwraca wiersze każdego przeglądającego, podobnie jak zapytanie złożone przez samą aplikację w magazynie StarRocks, Databend, Greenplum lub Postgres. Zapytanie w magazynie Snowflake lub Databricks albo takie, które nie jest pojedynczym zapytaniem SELECT do tabel projektu (zapis lub kilka instrukcji), jest odrzucane dla każdego, kto nie jest Architektem projektu. Odczyt według nazwy sprawia, że aplikacja działa w obu przypadkach.

Aby dostosować to, co aplikacja pokazuje, do tego, kto na nią patrzy — spersonalizowane powitanie, ukrycie karty lub zabezpieczenia na poziomie wierszy — odczytaj zalogowanego użytkownika z Panel:

import panel as pn
viewer = pn.state.user # the viewer's email address
token = pn.state.access_token # their JWT, if you need claims or group membership

pn.state.user to adres e-mail przeglądającego, pobrany z jego zweryfikowanego logowania — możesz uznać go za jego tożsamość. pn.state.access_token to jego surowy token dostępu, przydatny, gdy musisz zdekodować oświadczenia dotyczące grup lub ról na potrzeby bardziej szczegółowych reguł.

Połącz oba elementy: odczytaj przeglądającego, a następnie filtruj według niego każde zapytanie. Na przykład, aby pokazać każdemu kierownikowi regionalnemu tylko jego własny region:

import panel as pn
from plaidcloud.utilities.connect import PlaidConnection
pn.extension()
viewer = pn.state.user
conn = PlaidConnection(project_id="<your-project-id>")
sales = conn.get_dataframe("Regional Sales")
mine = sales[sales["manager_email"] == viewer]
pn.Column(
f"# Sales for {viewer}",
pn.pane.DataFrame(mine, index=False),
).servable()

Ponieważ połączenie już egzekwuje uprawnienia przeglądającego do projektu, to filtrowanie jest dodatkowym ukształtowaniem danych w ramach tego, co przeglądający może zobaczyć — a nie substytutem własnej kontroli dostępu PlaidCloud.

Wywołuj dane z głównego przepływu aplikacji. Zalogowany przeglądający jest dostępny, gdy kod aplikacji działa w jego sesji (tam, gdzie odbywa się praca z .servable()). Jeśli przenosisz wywołanie blokujące do wątku w tle, użyj asyncio.to_thread — surowa pula wątków nie przeniesie tożsamości sesji, a połączenie zakończy się jawnym błędem zamiast odczytać niewłaściwe dane.

Jeśli opublikujesz aplikację z opcją Zezwól na dostęp publiczny, jest ona udostępniana bez logowania, więc nie ma przeglądającego, w imieniu którego można działać — pn.state.user jest puste, a PlaidConnection() nie ma kogo uwierzytelnić. Ogranicz aplikacje publiczne do danych, które są bezpieczne dla każdego, lub pozostaw dostęp publiczny wyłączony, aby przeglądający logowali się i obowiązywał opisany wyżej model per użytkownik.