Legacy authentication

Before you can access the Knox Asset Intelligence API, you must set up authentication. This guide covers how to set up legacy authentication for secure access to the Knox Asset Intelligence API.

1. Sign up for Knox Asset Intelligence in your Samsung Knox account

1. Register for a Samsung Knox account. For more information, see Create a Samsung Knox account.

2. Sign in to your account once you’re approved for Knox Asset Intelligence. For more information, see Access the Knox Asset Intelligence console.

2. Request access to the Knox cloud services API

To apply for Knox cloud services API access, send an email to knoxapi@samsungknox.com with your user and tenant information. You can also create a Support ticket.

3. Generate your access token

After you get Knox cloud services API access, go to the Knox Developer Portal, click Knox Cloud API Portal on the navigation pane, and generate an access token. When making a Knox Asset Intelligence API request, include this access token in the request header.

To let your sub-admins generate access token, go to the Knox Admin Portal, and grant the Access Knox Cloud APIs portal permission to the roles associated with the sub-admins.

4. Test your access token

Ensure that your access token is correctly configured by making a test call to Knox Asset Intelligence API. See Knox Asset Intelligence API for a list of operations you can call.

API restrictions

Request limit

The rate limit set for Knox Asset Intelligence APIs is 25 requests per second. That is, an API can be called up to 25 times a second by the same Knox cloud services API key, also known as the x-knox-apitoken, or by the same user in a tenant.