Get Service History
Description
Get cloud service OAuth history of the business unit.
URL
/api/v1/service/history/{application}
Method: GET
Request Headers
|
Key |
Value |
Type |
Description |
|---|---|---|---|
| Authorization | Bearer <Authorization Token> | String | Authorization credential generated by FortiCASB |
| Content-Type | application/json | String | |
|
buId |
<Business Unit ID> |
Long |
The targeted business unit ID on FortiCASB. Business unit ID can be obtained through . Alternatively, it can also be obtained from the REST API Get Resource Map |
|
application |
<Cloud Service application> |
String |
Cloud service application name such as Salesforce, Office365, etc. |
| companyId | <Company ID> | Integer | Company ID of which the business unit is under, can be obtained through Get Resource Map. |
|
roleId |
<User ID> |
Integer |
Login user ID, can be obtained through Get Resource Map. |
Sample Request
|
Request URL |
GET https://www.forticasb.com/api/v1/service/history/Salesforce |
| Request Header |
Authorization: Bearer <Authorization_Token> Content-Type: application/json buid: 6384 companyId: 62598 roleId: 36241 |
Response Variables
|
Name |
Required |
Type |
Description |
|---|---|---|---|
| id | Required | long | The OAuth history ID |
| buId | Required | Long | Business unit ID |
| application | Required | String | Cloud service application name |
| scanId | Optional | String | Application name + company name |
| actionStatusCode | Optional | String | The user name that is registered with this cloud service |
| message | Optional | String | The returned message of cloud service status history |
| date | Optional | long | Timestamp, the time that processed this step |
| lastStep | Optional | String | The last process step |
| casbUser | Optional | String | The user email that is used in FortiCASB |
| cloudUser | Optional | String | The user name that is registered in this cloud service account |
Sample Response
[
{
"id":31289,
"scanId":"SALESFORCEVb-gvLgmSLCWw8U_BSh6Vw",
"buId":6384,
"application":"SALESFORCE",
"actionStatusCode":"Success",
"message":"",
"date":1583432356528,
"lastStep":"Update OAuth Data",
"casbUser":"qa.casb1@gmail.com",
"cloudUser":"yuezhang@yue.com"
},
{
"id":31267,
"scanId":"SALESFORCEVb-gvLgmSLCWw8U_BSh6Vw",
"buId":6384,
"application":"SALESFORCE",
"actionStatusCode":"Success",
"message":"",
"date":1583378643280,
"lastStep":"Update OAuth Data",
"casbUser":"qa.casb1@gmail.com",
"cloudUser":"mhuang@fortinet-uk.com"
},
{
"id":24433,
"scanId":"SALESFORCEVb-gvLgmSLCWw8U_BSh6Vw",
"buId":6384,
"application":"SALESFORCE",
"actionStatusCode":"Success",
"message":"",
"date":1582918837831,
"lastStep":"Update OAuth Data",
"casbUser":"qa.casb1@gmail.com",
"cloudUser":"yuezhang@yue.com"
},
{
"id":16572,
"scanId":"SALESFORCEVb-gvLgmSLCWw8U_BSh6Vw",
"buId":6384,
"application":"SALESFORCE",
"actionStatusCode":"Success",
"message":"",
"date":1582585855516,
"lastStep":"Save OAuth Data",
"casbUser":"qa.casb1@gmail.com",
"cloudUser":"mh20170918@126.com"
}
]