Fleet (FleetDM) Las claves API le permiten interactuar directamente con su instancia Fleet, por ejemplo, para ejecutar scripts, consultar datos del dispositivo o integrarse con otras herramientas.
Puede crear claves Fleet API directamente desde Primo o mediante el panel de control Fleet.
Generar una clave Fleet API desde Primo
- Vaya a Configuración > Desarrolladores > Claves Fleet API.
- Haga clic en Crear clave API.
- Asigne un nombre a la clave y configure los permisos.
- Haga clic en Crear.
- Copie el token inmediatamente; no se volverá a mostrar.
Mantenga su token Fleet API en secreto y no lo comparta. Tiene los permisos que configuraste durante la creación.
Genere una clave Fleet API desde el panel Fleet
- Abra su panel de Fleet (accesible desde la cabina de Primo a través de Configuración > MDM > Abrir Fleet).
- Haz clic en tu avatar en la esquina superior derecha y ve a Mi cuenta.
- Desplácese hasta Token API.
- Haga clic en Obtener token API.
- Copie el token: está vinculado a su cuenta de usuario Fleet.
Su token Fleet API tiene los mismos permisos que su cuenta de usuario Fleet. Mantenlo en secreto y no lo compartas.
Genere una clave Fleet API desde CLI
También puede crear claves Fleet API mediante programación utilizando la CLI Fleet:
fleetctl login --email your-email@example.com --url https://<your-fleet-instance>
fleetctl get api-token
O cree una clave API directamente a través de Fleet API:
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"
Utilice la clave Fleet API
Pase el token en el encabezado Authorization:
curl https://<your-fleet-instance>/api/v1/fleet/hosts \
-H "Authorization: Bearer YOUR_FLEET_API_TOKEN"
Regenerar o revocar un token
Los tokens Fleet API no caducan automáticamente. Para revocar el acceso, vaya a Mi cuenta en Fleet y haga clic en Regenerar token API. Esto invalida inmediatamente el token anterior.