Fortinet black logo

online help

Get Service History

Copy Link
Copy Doc ID d2c8e2ba-6afb-11ea-9384-00505692583a:831744

Get Service History

Description

Get cloud service OAuth history of the business unit.

URL

/api/v1/service/history/{service}

Method: GET

Request Header

Key

Value

Type

Description

Authorization Bearer <Authorization Token> String Authorization credential generated by FortiCASB

buId

<Business Unit ID>

Long

The targeted business unit ID on FortiCASB. Business unit ID can be obtained through View or Remove Business User. Alternatively, it can also be obtained from the REST API Get Resource Map

service

<Cloud Service>

String

Cloud service name such as Salesforce, Office365, etc.

Content-Type application/json String

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

Response Variable

Name

Required

Type

Description

id Required long The OAuth history ID
buId Required Long Business unit ID
service Required Application Cloud service 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"

}

]

Get Service History

Description

Get cloud service OAuth history of the business unit.

URL

/api/v1/service/history/{service}

Method: GET

Request Header

Key

Value

Type

Description

Authorization Bearer <Authorization Token> String Authorization credential generated by FortiCASB

buId

<Business Unit ID>

Long

The targeted business unit ID on FortiCASB. Business unit ID can be obtained through View or Remove Business User. Alternatively, it can also be obtained from the REST API Get Resource Map

service

<Cloud Service>

String

Cloud service name such as Salesforce, Office365, etc.

Content-Type application/json String

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

Response Variable

Name

Required

Type

Description

id Required long The OAuth history ID
buId Required Long Business unit ID
service Required Application Cloud service 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"

}

]