Authentication

MetaDefender IT-OT Access APIs use the OAuth 2.0 protocol for authentication and authorization. The simplicity of OAuth 2.0 allows developers to start using and developing against MetaDefender IT-OT Access APIs almost immediately, the only thing which has to be done, before starting integration, is to register your application and obtain an unique set of Client Key and Client Secret from MetaDefender IT-OT Access OAuth Portal.

This step provides you ways to authorize with our platform to archive an access token which is required in each API as a parameter for security and authentication reasons.

We support authorization through the Client Credentials grant type.

Client Credentials grant type - No log in required from a user

Client credentials grant type is beneficial for use cases such as service calls or calls on behalf of the user who created the client application and has implicit access to the resources.

The client credentials grant type must be used by only confidential clients and has to be always used through a secure connection.

curl -X POST 'https://gears.opswat.com/o/oauth/token' -d 'client_id=YOUR_CLIENT_KEY&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials'

Request Example

curl -X POST https://gears.opswat.com/o/oauth/token -d 'grant_type=client_credentials&client_id=TestnFZFEjr1zCsicMWpAA&client_secret=E9SRTVJ93AASEWVXOJ3PRY1K7KFDEEQ679IX5SJMEMG2Y8AE'

Response Example

{

   "access_token": "TEST7P9ZMJ2LBF8AMOMJLFNPMMLO953AVQ4C9YFF52R64567",

   "token_type": "bearer",

   "expires_in": 43199,

   "scope": "read",

   "client_id": "2YotnFZFEjr1zCsicMWpAA"

}

If you provide invalid client credentials, the server will return the following error:

{

   "error": "invalid_client",

   "error_description": "Bad client credentials"

}