How to Access the Ciso API

Ciso employs a unified REST API across all its user interfaces. To work with this API, you need to generate an access token in the security settings section of the Ciso platform. The API provides the flexibility to integrate with external systems and develop new applications that can modify or retrieve data from Ciso.

You can view the API documentation and test your requests and tokens in the Swagger UI at {sub-domain}.ciso.se/swaggerui while logged in to Ciso ({sub-domain}.ciso.se).

Create Access Token

To create an access token for use with the Ciso API, do as follows:

1. In Ciso, on the right-hand side of the top-menu, click the cogwheel and then click Security Settings.
2. In the left-hand menu, select API Tokens.
3. On the right-hand side of the content area, find and click the button "New API Token".
4. Choose a service account to be associated with the token or create a new service account using the drop-down menu.
5. Set an expiry date for the token. Press OK.
6. In the pop-up, copy the generated token and save it in a safe place. You won't be able to access it again.

Note: The Service Account's permissions, which is determined by its roles, affects what parts of the API you can access. New roles can be created by a local Ciso Administrator.

Now you can try out your token by authorizing yourself in the Swagger UI (by using the "Authorize" button) or by adding it to your request header as Authorization: Bearer {token}.