Claus API

1. Què hi ha a la pantalla

A dalt, el bloc «Crear una clau» amb el camp «Nom», els «Àmbits» («Lectura» i «Escriptura») i el botó «Crear una clau». A sota, la llista de claus de l'empresa; si no n'hi ha cap, diu «Encara no hi ha claus API.».

2. Crear una clau

1. Escriu un «Nom» que digui qui la fa servir (per exemple, “ERP de nòmines” o “quadre de comandament de direcció”).

2. Marca els «Àmbits»: «Lectura» si el sistema només consulta dades; afegeix «Escriptura» només si ha de crear o modificar registres.

3. Prem «Crear una clau».

4. Apareix “Copia aquesta clau ara — no es tornarà a mostrar:”. Copia-la i guarda-la al sistema que la farà servir; després prem “Fet”. Si la perds, n'hauràs de crear una altra o rotar-la.

3. Rotar, revocar i vigilar l'ús

Cada clau de la llista mostra el nom, els àmbits i l'“últim ús”. “Rotar” genera un valor nou per a la mateixa clau (l'anterior deixa de valer) i el mostra una sola vegada. “Revocar” l'anul·la de seguida i no es pot desfer: fes-lo servir quan un sistema ja no la necessita o si sospites que s'ha filtrat. Les claus revocades o caducades apareixen marcades com a “revocada” o “caducada”.

El consum de l'API davant la quota del teu pla es veu a “Monitoratge d'integracions”.

4. Una clau per sistema

Crea una clau diferent per a cada sistema que es connecti: així, si un es retira o es compromet, revoques només la seva i els altres continuen funcionant, i a “últim ús” saps quin està actiu. La clau dona accés a les dades de tota l'empresa amb els àmbits que li has donat: guarda-la al gestor de secrets del sistema que la fa servir, mai en un correu ni en un full de càlcul.