# Alkalmazás regisztrálása az OpenPlatformban

> Az alkalmazásrekord mezői az OpenPlatformban: cím, a két megosztott token, a megnyitás módját eldöntő jelzők, a jogosultságai és az, hogy ki érheti el.

Framework: openplatform
Product: OpenPlatform (openplatform@5)
Language: hu
Content-SHA256: 6ea2218a6cbb38eacdf0b51c488846f51a455728a31c1404063c3df8d338d3ae
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: 
Review: not-recorded

Az alkalmazás egy rekord, amelyet az adminisztrátor a **beállítási** képernyőn hoz létre (`/setup/`, a `setup` bővítmény alkalmazás API-ja). A rekord a szerződés az OpenPlatform és az alkalmazásod között: hol él, hogyan igazolják egymásnak, kik ők, és mit tehet benne a felhasználó. A rekord sémája az `@Apps` a `plugins/setup/schemas/apps.js` fájlban.

| Mező | Kötelező | Jelentés |
|---|---|---|
| `name` | igen | a portálon megjelenő név |
| `url` | igen | az a cím, amelyet az OpenPlatform megnyit |
| `reqtoken` | igen | egy titok, amelyet te választasz és **mindkét fél ismer**: ez írja alá a kérést |
| `restoken` | igen | egy második titok, szintén megosztott: az alkalmazás ezzel írja alá a válaszát |
| `color`, `icon` | nem | hogyan néz ki az alkalmazás a portálon |
| `meta` | nem | egy cím (URL), amely visszaadja az alkalmazás metaadatait: a beállítási képernyő letöltheti (`Apps/download`), hogy kitöltse a rekordot |
| `sortindex` | nem | a sorrend a listában (az új alkalmazás a végére kerül) |
| `notifications` | nem | küldhet-e az alkalmazás értesítéseket |
| `isexternal` | nem | az alkalmazás **nem** a portál keretében nyílik meg: az alkalmazásnak adott válasz `iframe: false` értéket tartalmaz |
| `isbookmark` | nem | az alkalmazás egyszerű hivatkozás: nincs tokenegyeztetés, csak egy munkamenet-azonosító a lekérdezési karakterláncban |
| `isnewtab` | nem | új böngészőlapon nyílik meg a portál kerete helyett (a `newtab` beállítás ezt minden alkalmazásra megteszi) |
| `isscrollbar` | nem | az alkalmazás kerete a portálon megtartja a görgetősávját (a portál a `scrolling` értékét `yes` vagy `no` értékre állítja) |
| `isdisabled` | nem | kikapcsolja mindenki számára: a felhasználó az "App has been temporary disabled" üzenetet kapja |
| `permissions` | nem | az alkalmazás jogosultságainak listája: mindegyiknek van `id`, `name` és `value` értéke (lásd [csoportok és jogosultságok](/en/openplatform/groups-and-permissions/)) |

A `tbl_app` táblának van egy `allow` oszlopa is ("csak meghatározott IP-címeket enged"): ha címeket tartalmaz, az alkalmazás az OpenPlatform protokollvégpontjait csak onnan hívhatja. A fenti beállítási séma nem sorolja fel, tehát ez egy adatbázisoszlop, amelyet közvetlenül töltesz ki.

## A két token

A `reqtoken` és a `restoken` soha nem kerül a böngészőbe. Az OpenPlatform ezekből minden indításhoz levezeti az utazó értékeket: az alkalmazás címében lévő tokent és az alkalmazás által visszaküldött fejlécet. A levezetés a [hogyan csatlakozik egy app](/en/openplatform/how-an-app-connects/) részben van. Használj hosszú véletlen értékeket és minden alkalmazáshoz más párt.

## Eltávolítás és módosítás

Az alkalmazást soha nem törli a táblából: az eltávolítás (`Apps/remove`) beállítja az `isremoved` mezőt és az eltávolítás dátumát, törli a gyorsítótárat azoknál a felhasználóknál, akiknek megvolt, az `isdisabled` pedig eltávolítás nélkül kikapcsolja. Ha a platform címe (az `url` beállítás) megváltozik, az OpenPlatform törli minden felhasználó értesítési hivatkozásait és a nyitott alkalmazásmunkameneteket, mert mindkettő tartalmazza azt a címet ([beállítások és adatbázis](/en/openplatform/settings-and-database/)).

Emlékezz a README szabályára: egy regisztrált alkalmazás senki számára nem látható, amíg csoportot nem rendelsz hozzá.