Creare e revocare i token API
Cosa può fare un token
Un token agisce a nome di chi lo ha creato, nel team attivo in quel momento. Può fare solo ciò che gli permetti alla creazione. Scegli uno di questi accessi:
- Controlla schermi e scene: vedere schermi, contenuti e scene, mostrare un contenuto su uno schermo, avviare e fermare le scene. Usalo per Bitfocus Companion.
- Sola lettura: vedere schermi, contenuti e scene, nient'altro.
- Accesso completo, inclusa la creazione di design: tutto quanto sopra, più la creazione di design.
Se chi ha creato il token perde l'accesso al team, il token smette di funzionare.
Creare un token
- Vai su Impostazioni > Connessioni.
- In Token API fai clic su Nuovo token API.
- Dai un nome al token, per esempio quello della sede o del programma che lo usa.
- In Accesso scegli cosa può fare il token.
- Fai clic su Crea token.
- Fai clic su Copia e conserva il token in un posto sicuro, per esempio nel programma che ne ha bisogno.
- Fai clic su Fatto.
Il token lo vedi una sola volta. Se lo perdi, revocalo e creane uno nuovo.
Il token funziona nel team attivo nel momento in cui lo crei. Per gli schermi di un altro team, passa prima a quel team e crea un token separato. Usa un token separato per ogni programma, così puoi revocarne uno senza fermare gli altri.
Per impostazione predefinita il proprietario e gli amministratori possono creare token. Dipende dal tuo ruolo. Lo cambi per ruolo in Gestire i team.
Email alla creazione di un token
Quando qualcuno crea un token, lui e i proprietari dell'account ricevono un'email. L'email indica di quale token si tratta, chi lo ha creato, per quale team, quando e cosa può fare. L'email non contiene mai il token stesso. Se non ti aspettavi quel token, revocalo subito.
Vedere i tuoi token
La scheda Token API mostra per ogni token:
- il nome e il tipo di accesso;
- gli ultimi quattro caratteri del token, per distinguere i token tra loro;
- il team;
- quando è stato usato l'ultima volta, oppure Mai usato.
Il proprietario vede i token di tutti gli utenti dell'account. Tutti gli altri vedono solo i propri.
Revocare un token
- Vai su Impostazioni > Connessioni.
- Fai clic su Revoca accanto al token.
- Conferma con Revoca.
Tutto ciò che usa il token si ferma subito.
Token che scadono
Un token non usato per un anno viene revocato automaticamente. Un token mai usato conta dal giorno in cui è stato creato. Se te ne serve di nuovo uno, creane uno nuovo.
Limite
Un account può avere un numero limitato di token. Quando lo raggiungi, Screenbird ti chiede di revocarne prima uno.
App collegate
Le app che colleghi con un accesso Screenbird, invece che con un token, compaiono in una scheda separata, App collegate, nella stessa pagina. Fai clic su Scollega per rimuoverne una.
Crea la tua connessione
Screenbird ha un'API pubblica. Invia il tuo token come bearer token a ogni richiesta. La descrizione completa dell'API, con tutte le richieste e i diritti necessari a ciascuna, si trova su api.screenbird.app/v1/openapi.json.