# Az API-hozzáférés használata

> Hozz létre személyes hozzáférési tokeneket szkriptekhez és MCP-kliensekhez, és küldd el a Livespace eseményeit a saját rendszereidbe webhookokkal.

A Beállítások › **API-hozzáférés** alatt személyes hozzáférési tokeneket hozhatsz létre, hogy egy szkript vagy MCP-kliens a nevedben használhassa a Dvina szolgáltatást. Az adminisztrátorok ugyanitt webhookokat is hozzáadhatnak, hogy a Livespace eseményeit a saját rendszereikbe küldjék.

Az API-hozzáférés az Enterprise csomag része. Minden tag létrehozhat saját tokeneket; a **Webhookok** csak a tulajdonosok és az adminisztrátorok számára láthatók.

## Token létrehozása

1. Nyisd meg a Beállításokat, és válaszd az **API-hozzáférés** lehetőséget.
2. A **Személyes hozzáférési tokenek** alatt válaszd a **Token létrehozása** lehetőséget.
3. Adj meg egy **Nevet**, hogy később is tudd, mi használja a tokent.
4. Válaszd ki a **Hozzáférést**: **Csak olvasás** vagy **Olvasás és írás**.
5. Válaszd ki a **Lejáratot**: **30 nap múlva**, **90 nap múlva**, **365 nap múlva** vagy **Soha nem jár le**.
6. Válaszd a **Token létrehozása** lehetőséget.
7. A **Token másolása** alatt másold ki a tokent, és tárold biztonságos helyen. Csak ekkor jelenik meg.

A token a nevedben működik abban a Livespace-ben, ahol létrehoztad, az ottani aktuális szerepkörödnek megfelelően. A **Csak olvasás** token olvasásra használható, de semmit sem adhat hozzá vagy módosíthat.

Ha MCP-klienssel szeretnéd használni a tokent, lásd: [Csatlakozás API-kulccsal OAuth helyett](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Token ellenőrzése, cseréje vagy visszavonása

A tokenjeid a **Személyes hozzáférési tokenek** alatt jelennek meg a hozzáférésükkel együtt. Válassz ki egyet a **Kezdete**, a **Hozzáférés**, az **Utolsó használat** és a **Lejárat** megtekintéséhez.

- **Token cseréjéhez** válaszd a **Csere…** lehetőséget, majd erősítsd meg a **Csere** gombbal. Egy új token váltja fel a régit, amely azonnal leáll. Másold ki az új tokent a **Token másolása** alatt.
- **Token leállításához** válaszd a **Visszavonás…** lehetőséget, majd erősítsd meg a **Visszavonás** gombbal. Minden, ami ezt a tokent használja, azonnal leáll.

A token létrehozása, cseréje és visszavonása bekerül az [auditnaplóba](/docs/teams/audit-log).

## Webhook hozzáadása

A webhook elküldi a Livespace eseményeit – az [auditnaplóban](/docs/teams/audit-log) szereplő bejegyzésekkel megegyező adatokat – egy általad megadott címre.

1. A Beállítások › **API-hozzáférés** oldalon, a **Webhookok** alatt válaszd a **Webhook hozzáadása** lehetőséget.
2. Adj meg egy **Nevet** és az **URL-t**. Nyilvános HTTPS URL-t használj.
3. Az **Események** mezőt hagyd üresen, ha minden eseményt szeretnél megkapni, vagy sorold fel a műveleteket és területeket, például: `member.added` vagy `sharing.*`.
4. Válaszd a **Hozzáadás** lehetőséget.
5. Az **Aláírási titok másolása** alatt másold ki a titkot. Csak ekkor jelenik meg.

Ha a Dvina a **Ez a cím nem érhető el a Dvina szolgáltatásból** üzenetet jeleníti meg, használj nyilvános HTTPS URL-t.

### Minden kérés aláírásának ellenőrzése

A Dvina kötegekben, JSON formátumban küldi az eseményeket, és minden kérést aláír. Az aláírási titokkal ellenőrizd, hogy a kérés a Dvina szolgáltatásból érkezett-e:

- Minden kérés tartalmaz egy `X-Dvina-Signature` fejlécet, amelynek formátuma: `t=<timestamp>,v1=<signature>`.
- Az aláírás az időbélyegből, egy pontból és a kérés törzséből, az aláírási titkoddal képzett HMAC-SHA256 érték, hexadecimális formátumban.
- Számítsd ki te is, és hasonlítsd össze. Utasítsd el a kérést, ha az aláírás nem egyezik, vagy az időbélyeg túl régi.

## Webhook ellenőrzése vagy módosítása

A webhookjaid a **Webhookok** alatt jelennek meg az állapotukkal együtt: **Bekapcsolva**, **Szüneteltetve** vagy **Hibás**. Válassz ki egyet a részletei megtekintéséhez.

- **A módosításhoz** szerkeszd a **Név**, **URL** vagy **Események** mezőt, majd válaszd a **Mentés** lehetőséget.
- **A szüneteltetéshez** kapcsold ki az **Események küldése** beállítást. Az események küldésének folytatásához kapcsold be újra.
- **A működés ellenőrzéséhez** nézd meg az **Állapot** mezőt és az **Elküldött** események számát. A hibás webhooknál megjelenik a **Legutóbbi hiba**. A Dvina tovább próbálkozik, és rögzíti a hibát az auditnaplóban.
- **A titkos kulcs módosításához** válaszd az **Új aláírási titkos kulcs…** lehetőséget, majd erősítsd meg. A kéréseket azonnal az új titkos kulccsal írja alá a rendszer, ezért rögtön frissítsd a fogadó oldalt.
- **Az eltávolításhoz** válaszd a **Törlés…**, majd a megerősítéshez a **Törlés** lehetőséget. Ezután már nem küld semmit erre a webhookra a rendszer.

## Kapcsolódó témák

- [A Dvina használata más alkalmazásokból MCP-vel](/docs/dvina-mcp/overview)
- [Az auditnapló használata](/docs/teams/audit-log)
- [Csapatok áttekintése](/docs/teams/overview)