Authentication and Access Tokens

Knowledge Base > Products > Software > Loop CloudAuthentication and Access Tokens

Overview

Currently, all API Requests require the usage of a token to provide access to Loop Cloud v2’s API Endpoints. Each generated token will only provide access for up to 1 hour and will only provide access to the organization data associated with that specific user. Below is an overview of the token generation and method of how to use this token. 

 

Table of Contents

Token Generation

API Request Overview

 

Endpoint

https://api.us.loop.bluecats.com/oauth/token

Method

POST

Content-type

application/x-www-form-urlencoded

Body

username=XXXXX
&password=YYYYY
&grant_type=password
 
Example Response Body

 


{"access_token": "abc123","token_type": "Bearer","expires_in": 3600
}

Key

Format

Usage

access_token

string

Temporary Access Token which can be used in Loop Cloud API Requests

token_type

string

Information of token type, i.e. Bearer

expires_in

int (seconds)

Number of seconds remaining until token expires

Target Organization and Group

Each API Request requires the the specification of the target Organization Id and Group Id that is being accessed. Both the target Organization Id and Group Id can be accessed in the profile menu as shown below:

Token Usage

Below is an example of a user with access to a sample BlueCats organization requesting logs using a valid temporary token for a target date range.

Endpoint https://api.us.loop.bluecats.com/schemas/objectTypes

Method

GET

Headers

authorization: Bearer {access_token}
bc-loop-orgid: bc000000-a1a1-b2b2-c3c3-d4d4e5e5f6

Navigation