Üzenőfüzet

Az iskola Google Workspace-rendszergazdájának

Iskolai admin
csatlakozás

Egy szülő azt kérte, engedélyezd az Üzenőfüzetet az iskola Workspace-ében. Itt együtt van minden, ami a döntéshez kell: mit kér az alkalmazás, mit hív, mit nem tud megtenni, és hogyan vonható vissza.

01

Csak olvasás

Az alkalmazás kizárólag GET kéréseket küld a Classroom API-nak. Nem ad be feladatot, nem ír és nem módosít jegyet, nem töröl semmit.

02

Gyerekenként külön engedély

A hozzáférést a tanuló adja meg a Google saját oldalán, a saját iskolai fiókjával. A szülő fiókja csak az Üzenőfüzet főoldalát védi, a tanuló adataihoz nem ad jogot.

03

Bármikor visszavonható

Az engedély az Admin konzolban letiltható, a tanuló fiókjából visszavonható, a szülő pedig az Üzenőfüzet főoldalán törölheti a kapcsolatot.

Az engedélyezendő alkalmazás

Alkalmazás neve
Üzenőfüzet
Weboldal
https://uzenofuzet.hu
OAuth-kliens típusa
Web application
OAuth-kliensazonosító
652545082668-28jv22mkvkjl85hd1rhfard3egnb4dtc.apps.googleusercontent.com
Átirányítási URI
https://uzenofuzet.hu/api/classroom/callback
Futtatás
Google Cloud Run, europe-west1 (EU)
Google rendszergazdai útmutató

Kért hozzáférések

Az alkalmazás hat scope-ot kér, mind csak olvasó. Írási, beadási vagy törlési scope nincs köztük, és a Classroomon kívül semmilyen Google-szolgáltatáshoz nem kér hozzáférést.

  • Google-fiók azonosításaopenid
  • Iskolai e-mail-cím megtekintésehttps://www.googleapis.com/auth/userinfo.email
  • Kurzusok megtekintésehttps://www.googleapis.com/auth/classroom.courses.readonly
  • Saját feladatok és beadások megtekintésehttps://www.googleapis.com/auth/classroom.coursework.me.readonly
  • Közlemények megtekintésehttps://www.googleapis.com/auth/classroom.announcements.readonly
  • Tananyagok megtekintésehttps://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Mit hív valójában

A Claude-nak öt rögzített eszköz áll rendelkezésére. Mindegyik pontosan egy Classroom-végpontot olvas, és csak akkor fut le, ha a szülő a beszélgetésben rákérdez.

  • GET /v1/coursesA tanuló aktív kurzusai (studentId=me).
  • GET /v1/courses/{id}/courseWorkA kurzus publikált feladatai.
  • GET /v1/courses/{id}/courseWork/{id}/studentSubmissionsCsak a saját beadások és jegyek (userId=me).
  • GET /v1/courses/{id}/announcementsA kurzus publikált közleményei.
  • GET /v1/courses/{id}/courseWorkMaterialsA kurzus publikált tananyagai.

Amit nem tesz — és amit tudnod kell

  • Nem ad be feladatot, nem ír vissza jegyet, nem szerkeszt és nem töröl Classroom-tartalmat.
  • Nem lát más tanulót: a beadási állapotokat és jegyeket userId=me szűréssel, csak a saját fiókjából olvassa.
  • Nem kér Gmail-, Drive-, Naptár- vagy címtárhozzáférést, és nem használ általános Google API-jogosultságot.
  • Nem tárolja a Classroom-tartalmakat: a válaszok lekéréskor keletkeznek, adatbázisba nem kerülnek.
  • Nem hirdet, nem ad tovább adatot harmadik félnek üzleti célra, és nem tanít modellt az iskola adataiból.

Melyik hibát látod?

A Google két, könnyen összekeverhető hibát ad. Csak az első tartozik az iskolára.

  • „Access blocked: Your institution's admin needs to review uzenofuzet.hu”Error 400: access_not_configuredEz az iskola Workspace-tiltása: a rendszergazdának kell engedélyeznie az alkalmazást az alábbi lépések szerint.
  • „Google hasn't verified this app” / a hitelesítés még nem fejeződött beError 403: access_deniedEz nem az iskolán múlik, hanem az Üzenőfüzet Google-oldali beállításán. Ilyenkor a szülőnek kell jeleznie az üzemeltetőnek.

A Request Access gombot a gyerek iskolai fiókjával kell megnyomni — pontosan azzal, amelyik a hibaoldal alján látszik. A kérés annak az iskolai domainnek a rendszergazdájához fut be; magánfiókból (például Gmailről) küldve senkihez nem jut el. A kérés az Admin konzol Hozzáférési kérések (Access requests) listájába kerül — hogy megy-e róla e-mail is, az a rendszergazda értesítési beállításain múlik. Ha az iskola kikapcsolta a kérésküldést, marad a közvetlen megkeresés a fenti kliensazonosítóval.

Engedélyezés
az Admin
konzolban

Két út vezet ugyanoda. Ha a szülő vagy a tanuló már elindította a hozzáférési kérést, elég azt jóváhagynod.

  1. 01

    Nyisd meg az alkalmazáshozzáférést

    Biztonság (Security) → Hozzáférés és adatkezelés (Access and data control) → API-vezérlők (API controls) → Alkalmazáshozzáférés kezelése (Manage App Access)

  2. 02

    Nézd meg a beérkezett kéréseket

    A Hozzáférési kérések (Access requests) listán megjelenik a tanuló kérése, ha a Google hibaoldalán — a saját iskolai fiókjával belépve — a Request Access gombra kattintott. A jóváhagyással készen is vagy.

  3. 03

    Vagy add hozzá kézzel

    Válaszd az Új alkalmazás konfigurálása (Configure new app) lehetőséget, keress az OAuth-kliensazonosítóra, majd válaszd ki a tanulók szervezeti egységét.

  4. 04

    Adj hozzáférést a fenti scope-okhoz

    Az Adott Google-adatok (Specific Google data) beállításnál elég a hat felsorolt olvasó scope. A teljes Megbízható (Trusted) állapot nem szükséges.

  5. 05

    Ellenőrizd a Classroom-beállítást

    A Classroom beállításainál a Classroom API adathozzáférés legyen engedélyezve az érintett szervezeti egységnek, különben az engedélyezés a Google oldalán elakad.

Mi kerül tárolásra

A Google által kiadott refresh tokent lejáró AES-256-GCM titkosítással a szülő privát profiljában tároljuk; a lezáró kulcsot a Google Secret Manager őrzi. A Claude-nak kiadott token nem tartalmaz Google-hitelesítő adatot, csak profilhivatkozást.

Az Üzenőfüzet főoldalán a kapcsolatból csak a csatlakoztatott iskolai e-mail-cím és az állapot látszik. A szolgáltatás Google Cloud Runon fut az EU-ban (europe-west1). A teljes leírás az adatkezelési tájékoztatóban és a Hogy működik? oldalon olvasható.

Visszavonás

  • Az Admin konzolból: az Alkalmazáshozzáférés kezelése listán a kliensazonosítót blokkolhatod; ettől a további lekérdezések azonnal elakadnak.
  • A tanuló fiókjából: a Google-fiók engedélyeinél a hozzáférés bármikor visszavonható.
  • Az Üzenőfüzet főoldaláról: a kapcsolat törlésekor megkíséreljük a Google-engedély visszavonását, és töröljük a helyi titkosított tokent.

Kérdés esetén

Az Üzenőfüzet független, nyílt forrású projekt: nem áll kapcsolatban az eKRÉTA Zrt.-vel, és nem hivatalos KRÉTA-termék. A teljes forráskód — a Classroom-hívásokkal együtt — átnézhető, kérdés vagy kifogás pedig ott jelezhető.

Forráskód a GitHubon