Skip to content

API Authentication

All Nullafi Shield API requests require authentication using API Keys as Bearer tokens.


Overview

API Keys provide secure, programmatic access to Shield's REST API endpoints. Each key acts as a Bearer token in the Authorization header and can be configured with specific permissions and expiration dates.

API Keys are shown only once at creation. Shield does not store the keys, so it is the administrator's responsibility to save them securely.


Authentication Method

Use the API Key as a Bearer token in the Authorization header:

Authorization: Bearer <your-api-key>

No OAuth flows or client credentials are required. All authentication is handled through the single Bearer token.


For complete API endpoint documentation and interactive testing, access the Swagger UI:

https://<shield-hostname>/swagger/index.html

The Swagger interface is accessible from the Admin Console via Configuration → API Keys → API Documentation.