Una clau API de Fleet et permet parlar directament amb la teva instància de Fleet. Utilitza'n una per executar scripts, obtenir dades dels dispositius o connectar Fleet amb altres eines.

Funció/Funcionalitat

Visió General

Les claus API de Fleet (FleetDM) autentiquen les sol·licituds enviades directament a la teva instància de Fleet. Pots crear-les de tres maneres:

• Des de Factorial IT, com una clau de només lectura.
• Des del tauler de control de Fleet, com un token vinculat al teu compte d'usuari de Fleet.
• Des de la línia de comandes, amb el Fleet CLI o l'API de Fleet.

Els tokens API de Fleet mai expiren per si sols.

Com utilitzar: crea una clau des de Factorial IT

1. Vés a Configuració > Desenvolupadors i desplaça't cap avall fins a la secció Clau API de FleetDM.
2. Escriu un Nom de la clau, per exemple, l'eina que utilitzarà la clau.
3. Fes clic a Generar clau.
4. Copia el token que apareix a la finestra Clau API de FleetDM creada. Es mantindrà disponible després a la taula de claus.

Les claus creades des de Factorial IT són de només lectura. Poden veure cada dispositiu i les seves dades, però no poden canviar configuracions ni executar accions dels dispositius. Són adequades per a integracions externes que només necessiten llegir la teva instància de Fleet.

Per revocar-ne una, obre el menú ⋯ a la seva fila a la taula de Clau API de FleetDM i fes clic a Revocar. Qualsevol integració que la utilitzi deixarà de funcionar immediatament.

Manten el token en secret. Qui el tingui pot llegir el teu inventari de dispositius.

Crea una clau des del tauler de control de Fleet

1. Obre el teu tauler de control de Fleet des de la consola a través de Configuració > MDM > Obre Fleet.
2. Fes clic a la teva imatge d'usuari a la cantonada superior dreta i selecciona El meu compte.
3. Desplaça't cap avall fins a Token API.
4. Fes clic a Obtenir token API.
5. Copia el token. Pertany al teu compte d'usuari de Fleet.

Aquest token té les mateixes permisos que el teu compte d'usuari de Fleet. Mantén-lo en secret.

Crea una clau des de la línia de comandes

Amb el Fleet CLI:

fleetctl login --email your-email@example.com --url https://<your-fleet-instance>
fleetctl get api-token

O directament a través de l'API de Fleet:

curl -X POST https://<your-fleet-instance>/api/v1/fleet/users/<user-id>/api_token \
  -H "Authorization: Bearer YOUR_EXISTING_TOKEN" \
  -H "Content-Type: application/json"

Utilitza la clau

Envia el token a l'encapçalament Authorization:

curl https://<your-fleet-instance>/api/v1/fleet/hosts \
  -H "Authorization: Bearer YOUR_FLEET_API_TOKEN"

Regenerar o revocar un token

• Clau creada des de Factorial IT: vés a Configuració > Desenvolupadors > Clau API de FleetDM, obre el menú ⋯ a la seva fila i fes clic a Revocar.
• Token vinculat al teu compte d'usuari de Fleet: a Fleet, vés a El meu compte i fes clic a Regenerar token API. El token antic deixarà de funcionar immediatament.

Solució de Problemes i FAQ

Solució de Problemes

• Una integració ha deixat de funcionar. La seva clau pot haver estat revocada, o el token d'usuari regenerat. Crea una nova clau i actualitza la integració.
• Una sol·licitud per canviar configuracions o executar una acció falla. Les claus creades des de Factorial IT són de només lectura. Utilitza un token vinculat a un compte d'usuari de Fleet amb els permisos adequats.
• Has perdut el token. Per a una clau creada des de Factorial IT, torna a trobar-la a la taula de claus. Per a un token d'usuari, regenerala a El meu compte a Fleet.

FAQ

1. Expiren els tokens API de Fleet?
   No. Es mantenen vàlids fins que els revocis o regeneris.
    
2. Què pot fer una clau creada des de Factorial IT?
   Llegir cada dispositiu i les seves dades. No pot canviar configuracions ni executar accions dels dispositius.
    
3. Quins permisos té un token del tauler de control de Fleet?
   Els mateixos que el teu compte d'usuari de Fleet.
    
4. Què passa quan revoco una clau?
   Tota integració que la utilitzi deixa de funcionar immediatament.