Voit luoda henkilökohtaisia käyttöoikeustunnuksia kohdassa Asetukset › API-käyttö, jotta skripti tai MCP-asiakas voi käyttää Dvinaa puolestasi. Ylläpitäjät voivat myös lisätä siellä webhookeja, jotka lähettävät Livespacen tapahtumat heidän omiin järjestelmiinsä.
API-käyttö sisältyy Enterprise-tilaukseen. Jokainen jäsen voi luoda omia tunnuksiaan. Vain omistajat ja ylläpitäjät näkevät kohdan Webhookit.
Luo tunnus
- Avaa Asetukset ja valitse API-käyttö.
- Valitse kohdassa Henkilökohtaiset käyttöoikeustunnukset vaihtoehto Luo tunnus.
- Anna Nimi, josta tunnistat myöhemmin, mihin tunnusta käytetään.
- Valitse Käyttöoikeus: Vain luku tai Luku ja kirjoitus.
- Valitse, milloin tunnus Vanhenee: 30 päivän kuluttua, 90 päivän kuluttua, 365 päivän kuluttua tai Ei vanhene koskaan.
- Valitse Luo tunnus.
- Kopioi tunnus kohdasta Kopioi tunnuksesi ja säilytä se turvallisessa paikassa. Tunnus näytetään vain tämän kerran.
Tunnus toimii puolestasi siinä Livespacessa, jossa loit sen, ja käyttää nykyisen roolisi oikeuksia kyseisessä Livespacessa. Vain luku -tunnuksella voi lukea tietoja, mutta ei lisätä tai muuttaa mitään.
Jos haluat käyttää tunnusta MCP-asiakkaan kanssa, katso Yhdistä API-avaimella OAuthin sijaan.
Tarkista, uusi tai peruuta tunnus
Tunnuksesi ja niiden käyttöoikeudet näkyvät kohdassa Henkilökohtaiset käyttöoikeustunnukset. Valitse tunnus, niin näet sen Alkumerkit ja Käyttöoikeuden sekä sen, milloin tunnusta on Käytetty viimeksi ja milloin se Vanhenee.
- Voit korvata tunnuksen valitsemalla Uusi… ja vahvistamalla valinnan painamalla Uusi. Uusi tunnus korvaa vanhan, ja vanha lakkaa toimimasta heti. Kopioi uusi tunnus kohdasta Kopioi tunnuksesi.
- Voit poistaa tunnuksen käytöstä valitsemalla Peruuta… ja vahvistamalla valinnan painamalla Peruuta. Kaikki tunnusta käyttävät yhteydet lakkaavat toimimasta heti.
Tunnuksen luominen, uusiminen ja peruuttaminen kirjataan valvontalokiin.
Lisää webhook
Webhook lähettää Livespacen tapahtumat valitsemaasi osoitteeseen. Tapahtumat ovat samoja tietueita kuin valvontalokissa.
- Valitse kohdassa Asetukset › API-käyttö › Webhookit vaihtoehto Lisää webhook.
- Anna Nimi ja URL. Käytä julkista HTTPS-osoitetta.
- Jätä Tapahtumat-kenttä tyhjäksi, jos haluat kaikki tapahtumat, tai luettele toiminnot ja alueet, kuten
member.addedtaisharing.*. - Valitse Lisää.
- Kopioi salainen avain kohdasta Kopioi allekirjoituksen salainen avain. Avain näytetään vain tämän kerran.
Jos Dvina ilmoittaa Tätä osoitetta ei voi tavoittaa Dvinasta, käytä julkista HTTPS-osoitetta.
Tarkista jokaisen pyynnön allekirjoitus
Dvina lähettää tapahtumat erissä JSON-muodossa ja allekirjoittaa jokaisen pyynnön. Tarkista allekirjoituksen salaisella avaimella, että pyyntö on tullut Dvinasta:
- Jokaisessa pyynnössä on
X-Dvina-Signature-otsake, jonka muoto ont=<timestamp>,v1=<signature>. - Allekirjoitus on heksadesimaalimuotoinen HMAC-SHA256, joka lasketaan aikaleimasta, pisteestä ja pyynnön rungosta käyttäen allekirjoituksen salaista avaintasi.
- Laske allekirjoitus itse ja vertaa sitä pyynnön allekirjoitukseen. Hylkää pyyntö, jos allekirjoitukset eivät täsmää tai aikaleima on liian vanha.
Tarkista webhook tai muuta sitä
Webhookit näkyvät kohdassa Webhookit, ja niiden tila on Käytössä, Keskeytetty tai Virhetilassa. Valitse webhook, niin näet sen tiedot.
- Jos haluat muuttaa webhookia, muokkaa sen Nimeä, URL-osoitetta tai Tapahtumia ja valitse Tallenna.
- Jos haluat keskeyttää lähettämisen, poista Lähetä tapahtumat käytöstä. Ota se uudelleen käyttöön, kun haluat jatkaa lähettämistä.
- Jos haluat tarkistaa webhookin toiminnan, katso sen Tila ja Lähetetty-tapahtumien määrä. Virhetilassa olevan webhookin tiedoissa näkyy Viimeisin virhe. Dvina jatkaa lähetysyrityksiä ja kirjaa epäonnistumisen auditointilokiin.
- Jos haluat vaihtaa webhookin salaisuuden, valitse Uusi allekirjoitussalaisuus… ja vahvista. Pyynnöt allekirjoitetaan heti uudella salaisuudella, joten päivitä vastaanottaja saman tien.
- Jos haluat poistaa webhookin, valitse Poista… ja vahvista valitsemalla Poista. Webhookiin ei enää lähetetä mitään.