Skip to main content

Manage GCP integrations with VRM using API endpoints

This page outlines the key API endpoints and provides example cURL commands for managing Google Cloud Platform (GCP) integrations with VRM.

Create the GCP integration​

Use this method to create a new integration with GCP in the VRM.

Endpoint:

POST https://api.longbow.security:443/v1/integrations

Headers:

Content-Type: application/json
Authorization: Bearer <Token>
(OR)
X-API-KEY: <API_KEY>

Payload:

{
"name": "GCP-20250529112357-07",
"cloudServiceProvider": "GCP"
}

cURL Example:

curl --location 'https://api.longbow.security:443/v1/integrations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <Token>' \
--data '{
"name": "GCP-20250529112357-07",
}'

OR (authenticate using API Key):

curl --location 'https://api.longbow.security:443/v1/integrations' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <API_KEY>' \
--data '{
"name": "GCP-20250529112357-07",
"cloudServiceProvider": "GCP"
}'

Update the access information from file​

Use this option to upload access credentials or configuration details required for the integration. Endpoint:

PUT https://api.longbow.security:443/v1/integrations/{{integrationId}}/accessInfo

Headers:

Content-Type: application/json  
Authorization: Bearer <Token>
(OR)
X-API-KEY: <API_KEY>

cURL:

curl --location --request PUT 'https://api.longbow.security:443/v1/integrations/{{integrationId}}/accessInfo' \
--header 'Authorization: Bearer <Token>' \
--form 'file=@"<path_to_file>"'

OR (Authenticate using API Key):

curl --location --request PUT 'https://api.longbow.security:443/v1/integrations/{{integrationId}}/accessInfo' \
--header 'X-API-KEY: <API_KEY>' \
--form 'file=@"<path_to_file>"'
note

When you work with MultiPart files, allow your browser to automatically set the Content-Type header.

Update the VRM integration settings (optional)​

Use this option to update metadata related to the VRM integration, such as asset value mappings and other configuration fields.

Endpoint:

PUT https://api.longbow.security:443/v1/integrations/{{integrationId}}

Headers:

Content-Type: application/json  
Authorization: Bearer <Token>
(OR)
X-API-KEY: <API_KEY>

Payload:

{
"assetValueMapping": {
"tagMappings": {
"CROWN_JEWEL": [
{
"key": "name",
"value": "ajay"
},
{
"key": "Application Role",
"value": "HR"
}
],
"HIGH": [
{
"key": "Application Type",
"value": "Finance"
}
]
}
}
}

cURL Example:

curl --location --request PUT 'http://api.longbow.security:443/v1/integrations/{{integrationId}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <Token>' \
--data '{
"assetValueMapping": {
"tagMappings": {
"CROWN_JEWEL": [
{
"key": "name",
"value": "ajay"
},
{
"key": "Application Role",
"value": "HR"
}
],
"HIGH": [
{
"key": "Application Type",
"value": "Finance"
}
]
}
}
}'

Using API Key:

curl --location --request PUT 'http://api.longbow.security:443/v1/integrations/{{integrationId}}' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <API_KEY>' \
--data '{
"assetValueMapping": {
"tagMappings": {
"CROWN_JEWEL": [
{
"key": "name",
"value": "ajay"
},
{
"key": "Application Role",
"value": "HR"
}
],
"HIGH": [
{
"key": "Application Type",
"value": "Finance"
}
]
}
}
}'
Last updated on