Cloud OCI Registration

The Cloud OCI Registration service collection provides operations for registering and managing Oracle Cloud Infrastructure (OCI) tenancies in CrowdStrike Falcon CSPM. Create, update, delete, and validate OCI tenancy accounts, rotate keys, and retrieve setup scripts.

Language	Last Update
Python	v1.6.5
PowerShell
Go	v0.22.0
TypeScript	v0.6.0
Rust	v0.7.1
Ruby	v1.4.0

Operation	Description
cloud-security-registration-oci-create-account `create_account`	Create OCI tenancy account in CSPM
cloud-security-registration-oci-delete-account `delete_account`	Delete an existing OCI tenancy in CSPM.
cloud-security-registration-oci-download-script `download_script`	Retrieve script to create resources in tenancy OCID
cloud-security-registration-oci-get-account `get_account`	Retrieve a list of OCI tenancies with support for FQL filtering, sorting, and pagination
cloud-security-registration-oci-rotate-key `rotate_key`	Refresh key for the OCI Tenancy
cloud-security-registration-oci-update-account `update_account`	Patch an existing OCI account in our system for a customer.
cloud-security-registration-oci-validate-tenancy `validate_tenancy`	Validate the OCI account in CSPM for a provided CID.

cloud-security-registration-oci-create-account

Create OCI tenancy account in CSPM

Method POST

Route /cloud-security-registration-oci/entities/accounts/v1

Scope Cloud Security OCI Registration: WRITE

PEP 8 create_account

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

resources body · array

group_name body · string

OCI group name.

home_region body · string

OCI home region.

policy_name body · string

Policy name.

products body · list of dictionaries

OCI products.

tenancy_ocid body · string

OCI tenancy ID.

user_email body · string

User email address.

user_name body · string

OCI user name.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

products = [
    {
        "features": [
            {
                "deployment_method": "string",
                "feature": "string",
                "is_enabled": True,
                "persona": "string",
                "registration_detailed_status": "string"
            }
        ],
        "product": "string"
    }
]

response = falcon.create_account(group_name="string",
                                 home_region="string",
                                 policy_name="string",
                                 products=products,
                                 tenancy_ocid="string",
                                 user_email="string",
                                 user_name="string")
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

products = [
    {
        "features": [
            {
                "deployment_method": "string",
                "feature": "string",
                "is_enabled": True,
                "persona": "string",
                "registration_detailed_status": "string"
            }
        ],
        "product": "string"
    }
]

response = falcon.cloud_security_registration_oci_create_account(group_name="string",
                                                                 home_region="string",
                                                                 policy_name="string",
                                                                 products=products,
                                                                 tenancy_ocid="string",
                                                                 user_email="string",
                                                                 user_name="string")
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "resources": [
        {
            "group_name": "string",
            "home_region": "string",
            "policy_name": "string",
            "products": [
                {
                    "features": ["string"],
                    "product": "string"
                }
            ],
            "registration_description": "string",
            "registration_name": "string",
            "tenancy_ocid": "string",
            "user_email": "string",
            "user_name": "string"
        }
    ]
}

response = falcon.command("cloud_security_registration_oci_create_account", body=body_payload)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  group_name := "string"
  home_region := "string"
  policy_name := "string"
  product := "string"
  registration_description := "string"
  registration_name := "string"
  tenancy_ocid := "string"
  user_email := "string"
  user_name := "string"

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciCreateAccount(
    &cloud_oci_registration.CloudSecurityRegistrationOciCreateAccountParams{
      Body: &models.DomainOCITenancyCreateRequestExtV1{
        Resources: []interface{}{
          {
          GroupName: &group_name,
          HomeRegion: &home_region,
          PolicyName: &policy_name,
          Products: []interface{}{
            {
            Features: []interface{}{},
            Product: &product,
            },
          },
          RegistrationDescription: &registration_description,
          RegistrationName: &registration_name,
          TenancyOcid: &tenancy_ocid,
          UserEmail: &user_email,
          UserName: &user_name,
          },
        },
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciCreateAccount(
  {
    resources: [{
        groupName: "string",
        homeRegion: "string",
        policyName: "string",
        products: [{
            features: [],
            product: "string"
          }],
        registrationDescription: "string",
        registrationName: "string",
        tenancyOcid: "string",
        userEmail: "string",
        userName: "string"
      }]
}  // body
);

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_create_account;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::DomainOciTenancyCreateRequestExtV1;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = DomainOciTenancyCreateRequestExtV1 {
        resources: vec![OCITenancyCreateExtV1 {
            home_region: Some("string".to_string()),
            products: vec![CloudOCIProductFeature {
                features: vec![],
                product: Some("string".to_string()),
                ..Default::default()
            }],
            tenancy_ocid: Some("string".to_string()),
            user_email: Some("string".to_string()),
            ..Default::default()
        }],
        ..Default::default()
    };

    let response = cloud_security_registration_oci_create_account(
        &falcon.cfg,  // configuration
        body,  // body
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

body = Falcon::DomainOCITenancyCreateRequestExtV1.new(
  resources: [{
      group_name: 'string',
      home_region: 'string',
      policy_name: 'string',
      products: [{
          features: [],
          product: 'string'
        }],
      registration_description: 'string',
      registration_name: 'string',
      tenancy_ocid: 'string',
      user_email: 'string',
      user_name: 'string'
    }]
)

response = api.cloud_security_registration_oci_create_account(body)

puts response

Responses

[
  {
    "cid": "string",
    "tenancy_ocid": "string"
  }
]

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "tenancy_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "tenancy_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "tenancy_ocid": "string"
    }
  ]
}

cloud-security-registration-oci-delete-account

Delete an existing OCI tenancy in CSPM.

Method DELETE

Route /cloud-security-registration-oci/entities/accounts/v1

Scope Cloud Security OCI Registration: WRITE

PEP 8 delete_account

Parameters

ids query · string or list of strings

OCI tenancy ocids to remove

parameters query · dictionary

Full query string parameters payload in JSON format. Not required when using other keywords.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.delete_account(ids=id_list)
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.cloud_security_registration_oci_delete_account(ids=id_list)
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.command("cloud_security_registration_oci_delete_account",
                          ids=id_list)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciDeleteAccount(
    &cloud_oci_registration.CloudSecurityRegistrationOciDeleteAccountParams{
      Ids: []string{"ID1", "ID2", "ID3"},
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciDeleteAccount(["ID1", "ID2", "ID3"]);  // ids

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_delete_account;
use rusty_falcon::easy::client::FalconHandle;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let response = cloud_security_registration_oci_delete_account(
        &falcon.cfg,  // configuration
        Some(vec!["string".to_string()]),  // ids
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

response = api.cloud_security_registration_oci_delete_account(ids: ['ID1', 'ID2', 'ID3'])

puts response

Responses

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

cloud-security-registration-oci-download-script

Retrieve script to create resources in tenancy OCID

Method POST

Route /cloud-security-registration-oci/entities/scripts/v1

Scope Cloud Security OCI Registration: READ

PEP 8 download_script

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

resources body · array

deployment_method body · string

Deployment method.

is_download body · boolean

Flag indicating if the script is intended for download.

tenancy_ocid body · string

OCI tenancy ID.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

response = falcon.download_script(deployment_method="string",
                                  is_download=boolean,
                                  tenancy_ocid="string")
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

response = falcon.cloud_security_registration_oci_download_script(deployment_method="string",
                                                                  is_download=boolean,
                                                                  tenancy_ocid="string")
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "resources": [
        {
            "deployment_method": "string",
            "is_download": boolean,
            "tenancy_ocid": "string"
        }
    ]
}

response = falcon.command("cloud_security_registration_oci_download_script", body=body_payload)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  deployment_method := "string"
  is_download := boolean
  tenancy_ocid := "string"

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciDownloadScript(
    &cloud_oci_registration.CloudSecurityRegistrationOciDownloadScriptParams{
      Body: &models.DomainOCIDownloadScriptRequestV1{
        Resources: []interface{}{
          {
          DeploymentMethod: &deployment_method,
          IsDownload: &is_download,
          TenancyOcid: &tenancy_ocid,
          },
        },
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciDownloadScript(
  {
    resources: [{
        deploymentMethod: "string",
        isDownload: boolean,
        tenancyOcid: "string"
      }]
}  // body
);

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_download_script;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::DomainOciDownloadScriptRequestV1;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = DomainOciDownloadScriptRequestV1 {
        resources: vec![OCIDownloadScriptRequestData {
            deployment_method: Some("string".to_string()),
            is_download: Some(boolean),
            ..Default::default()
        }],
        ..Default::default()
    };

    let response = cloud_security_registration_oci_download_script(
        &falcon.cfg,  // configuration
        body,  // body
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

body = Falcon::DomainOCIDownloadScriptRequestV1.new(
  resources: [{
      deployment_method: 'string',
      is_download: boolean,
      tenancy_ocid: 'string'
    }]
)

response = api.cloud_security_registration_oci_download_script(body)

puts response

Responses

[
  {
    "cid": "string",
    "stack_url": "string",
    "tenancy_ocid": "string",
    "version": "string",
    "zip_url": "string"
  }
]

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

cloud-security-registration-oci-get-account

Retrieve a list of OCI tenancies with support for FQL filtering, sorting, and pagination

Method GET

Route /cloud-security-registration-oci/combined/accounts/v1

Scope Cloud Security OCI Registration: READ

PEP 8 get_account

Parameters

filter query · string

FQL (Falcon Query Language) string for filtering results. Allowed filters are:

Available values (8)

`tenancy_name`	`home_region`	`key_age`
`overall_status`	`created_at`	`updated_at`
`registration_name`	`tenancy_ocid`

sort query · string

Field and direction for sorting results - allowed sort fields are Set{created_at, updated_at, registration_name, tenancy_ocid, tenancy_name, home_region, key_age, overall_status}

Available values (7)

`home_region`	`key_age`	`overall_status`
`created_at`	`updated_at`	`tenancy_ocid`
`tenancy_name`

next_token query · string

Token for cursor-based pagination. Currently unsupported.

limit query · integer

Maximum number of records to return (default: 100, max: 10000)

offset query · integer

Starting index of result

parameters query · dictionary

Full query string parameters payload in JSON format. Not required when using other keywords.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

response = falcon.get_account(filter="string",
                              sort="string",
                              next_token="string",
                              limit=integer,
                              offset=integer)
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

response = falcon.cloud_security_registration_oci_get_account(filter="string",
                                                              sort="string",
                                                              next_token="string",
                                                              limit=integer,
                                                              offset=integer)
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("cloud_security_registration_oci_get_account",
                          filter="string",
                          sort="string",
                          next_token="string",
                          limit=integer,
                          offset=integer)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  filter := "string"
  sort := "string"
  nextToken := "string"
  limit := int64(0)
  offset := int64(0)

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciGetAccount(
    &cloud_oci_registration.CloudSecurityRegistrationOciGetAccountParams{
      Filter: &filter,
      Sort: &sort,
      NextToken: &nextToken,
      Limit: &limit,
      Offset: &offset,
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciGetAccount(
  "string",  // filter
  "string",  // sort
  "string",  // nextToken
  integer,  // limit
  integer  // offset
);

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_get_account;
use rusty_falcon::easy::client::FalconHandle;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let response = cloud_security_registration_oci_get_account(
        &falcon.cfg,  // configuration
        Some("string"),  // filter
        Some("string"),  // sort
        Some("string"),  // next_token
        Some(integer),  // limit
        Some(integer),  // offset
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

response = api.cloud_security_registration_oci_get_account(filter: 'string',
                                                           sort: 'string',
                                                           next_token: 'string',
                                                           limit: integer,
                                                           offset: integer)

puts response

Responses

[
  {
    "cid": "string",
    "cloud_registration_enabled": false,
    "conditions": [],
    "created_at": "string",
    "cspm_enabled": false,
    "finger_print": "string",
    "group_name": "string",
    "group_ocid": "string",
    "home_region": "string",
    "is_connected": false,
    "key_age": 0,
    "overall_status": "string",
    "policy_name": "string",
    "policy_ocid": "string",
    "private_key": "string",
    "products": {},
    "public_key": "string",
    "registration_description": "string",
    "registration_id": "string",
    "registration_name": "string",
    "stack_name": "string",
    "stack_ocid": "string",
    "tenancy_name": "string",
    "tenancy_ocid": "string",
    "updated_at": "string",
    "user_email": "string",
    "user_name": "string",
    "user_ocid": "string"
  }
]

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "cloud_registration_enabled": false,
      "conditions": [],
      "created_at": "string",
      "cspm_enabled": false,
      "finger_print": "string",
      "group_name": "string",
      "group_ocid": "string",
      "home_region": "string",
      "is_connected": false,
      "key_age": 0,
      "overall_status": "string",
      "policy_name": "string",
      "policy_ocid": "string",
      "private_key": "string",
      "products": {},
      "public_key": "string",
      "registration_description": "string",
      "registration_id": "string",
      "registration_name": "string",
      "stack_name": "string",
      "stack_ocid": "string",
      "tenancy_name": "string",
      "tenancy_ocid": "string",
      "updated_at": "string",
      "user_email": "string",
      "user_name": "string",
      "user_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "cloud_registration_enabled": false,
      "conditions": [],
      "created_at": "string",
      "cspm_enabled": false,
      "finger_print": "string",
      "group_name": "string",
      "group_ocid": "string",
      "home_region": "string",
      "is_connected": false,
      "key_age": 0,
      "overall_status": "string",
      "policy_name": "string",
      "policy_ocid": "string",
      "private_key": "string",
      "products": {},
      "public_key": "string",
      "registration_description": "string",
      "registration_id": "string",
      "registration_name": "string",
      "stack_name": "string",
      "stack_ocid": "string",
      "tenancy_name": "string",
      "tenancy_ocid": "string",
      "updated_at": "string",
      "user_email": "string",
      "user_name": "string",
      "user_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

cloud-security-registration-oci-rotate-key

Refresh key for the OCI Tenancy

Method POST

Route /cloud-security-registration-oci/entities/account-rotate-keys/v1

Scope Cloud Security OCI Registration: WRITE

PEP 8 rotate_key

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

resources body · array

tenancy_ocid body · string

OCI tenancy ID.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

response = falcon.rotate_key(tenancy_ocid="string")
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

response = falcon.cloud_security_registration_oci_rotate_key(tenancy_ocid="string")
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "resources": [
        {
            "tenancy_ocid": "string"
        }
    ]
}

response = falcon.command("cloud_security_registration_oci_rotate_key", body=body_payload)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  tenancy_ocid := "string"

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciRotateKey(
    &cloud_oci_registration.CloudSecurityRegistrationOciRotateKeyParams{
      Body: &models.DomainOCITenancyRotateKeyRequestExtV1{
        Resources: []interface{}{
          {
          TenancyOcid: &tenancy_ocid,
          },
        },
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciRotateKey(
  {
    resources: [{
        tenancyOcid: "string"
      }]
}  // body
);

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_rotate_key;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::DomainOciTenancyRotateKeyRequestExtV1;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = DomainOciTenancyRotateKeyRequestExtV1 {
        resources: vec![TenancyOCID {
            tenancy_ocid: Some("string".to_string()),
            ..Default::default()
        }],
        ..Default::default()
    };

    let response = cloud_security_registration_oci_rotate_key(
        &falcon.cfg,  // configuration
        body,  // body
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

body = Falcon::DomainOCITenancyRotateKeyRequestExtV1.new(
  resources: [{
      tenancy_ocid: 'string'
    }]
)

response = api.cloud_security_registration_oci_rotate_key(body)

puts response

Responses

[
  {
    "cid": "string",
    "finger_print": "string",
    "public_key": "string",
    "tenancy_ocid": "string"
  }
]

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "finger_print": "string",
      "public_key": "string",
      "tenancy_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

cloud-security-registration-oci-update-account

Patch an existing OCI account in our system for a customer.

Method PATCH

Route /cloud-security-registration-oci/entities/accounts/v1

Scope Cloud Security OCI Registration: WRITE

PEP 8 update_account

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

resources body · array

group_name body · string

OCI group name.

home_region body · string

OCI home region.

policy_name body · string

Policy name.

products body · list of dictionaries

OCI products.

stack_ocid body · string

OCI stack ID.

tenancy_ocid body · string

OCI tenancy ID.

user_email body · string

User email address.

user_name body · string

OCI user name.

user_ocid body · string

OCI user ID.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

products = [
    {
        "features": [
            {
                "deployment_method": "string",
                "feature": "string",
                "is_enabled": True,
                "persona": "string",
                "registration_detailed_status": "string"
            }
        ],
        "product": "string"
    }
]

response = falcon.update_account(group_name="string",
                                 home_region="string",
                                 policy_name="string",
                                 products=products,
                                 stack_ocid="string",
                                 tenancy_ocid="string",
                                 user_email="string",
                                 user_name="string",
                                 user_ocid="string")
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

products = [
    {
        "features": [
            {
                "deployment_method": "string",
                "feature": "string",
                "is_enabled": True,
                "persona": "string",
                "registration_detailed_status": "string"
            }
        ],
        "product": "string"
    }
]

response = falcon.cloud_security_registration_oci_update_account(group_name="string",
                                                                 home_region="string",
                                                                 policy_name="string",
                                                                 products=products,
                                                                 stack_ocid="string",
                                                                 tenancy_ocid="string",
                                                                 user_email="string",
                                                                 user_name="string",
                                                                 user_ocid="string")
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "resources": [
        {
            "group_name": "string",
            "home_region": "string",
            "policy_name": "string",
            "products": [
                {
                    "features": ["string"],
                    "product": "string"
                }
            ],
            "registration_description": "string",
            "registration_name": "string",
            "stack_ocid": "string",
            "tenancy_ocid": "string",
            "user_email": "string",
            "user_name": "string",
            "user_ocid": "string"
        }
    ]
}

response = falcon.command("cloud_security_registration_oci_update_account", body=body_payload)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  group_name := "string"
  home_region := "string"
  policy_name := "string"
  product := "string"
  registration_description := "string"
  registration_name := "string"
  stack_ocid := "string"
  tenancy_ocid := "string"
  user_email := "string"
  user_name := "string"
  user_ocid := "string"

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciUpdateAccount(
    &cloud_oci_registration.CloudSecurityRegistrationOciUpdateAccountParams{
      Body: &models.DomainOCITenancyUpdateRequestExtV1{
        Resources: []interface{}{
          {
          GroupName: &group_name,
          HomeRegion: &home_region,
          PolicyName: &policy_name,
          Products: []interface{}{
            {
            Features: []interface{}{},
            Product: &product,
            },
          },
          RegistrationDescription: &registration_description,
          RegistrationName: &registration_name,
          StackOcid: &stack_ocid,
          TenancyOcid: &tenancy_ocid,
          UserEmail: &user_email,
          UserName: &user_name,
          UserOcid: &user_ocid,
          },
        },
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciUpdateAccount(
  {
    resources: [{
        groupName: "string",
        homeRegion: "string",
        policyName: "string",
        products: [{
            features: [],
            product: "string"
          }],
        registrationDescription: "string",
        registrationName: "string",
        stackOcid: "string",
        tenancyOcid: "string",
        userEmail: "string",
        userName: "string",
        userOcid: "string"
      }]
}  // body
);

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_update_account;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::DomainOciTenancyUpdateRequestExtV1;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = DomainOciTenancyUpdateRequestExtV1 {
        resources: vec![OCITenancyUpdateExtV1 {
            products: vec![CloudOCIProductFeature {
                features: vec![],
                product: Some("string".to_string()),
                ..Default::default()
            }],
            ..Default::default()
        }],
        ..Default::default()
    };

    let response = cloud_security_registration_oci_update_account(
        &falcon.cfg,  // configuration
        body,  // body
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

body = Falcon::DomainOCITenancyUpdateRequestExtV1.new(
  resources: [{
      group_name: 'string',
      home_region: 'string',
      policy_name: 'string',
      products: [{
          features: [],
          product: 'string'
        }],
      registration_description: 'string',
      registration_name: 'string',
      stack_ocid: 'string',
      tenancy_ocid: 'string',
      user_email: 'string',
      user_name: 'string',
      user_ocid: 'string'
    }]
)

response = api.cloud_security_registration_oci_update_account(body)

puts response

Responses

[
  {
    "cid": "string",
    "cloud_registration_enabled": false,
    "conditions": [],
    "created_at": "string",
    "cspm_enabled": false,
    "finger_print": "string",
    "group_name": "string",
    "group_ocid": "string",
    "home_region": "string",
    "is_connected": false,
    "key_age": 0,
    "overall_status": "string",
    "policy_name": "string",
    "policy_ocid": "string",
    "private_key": "string",
    "products": {},
    "public_key": "string",
    "registration_description": "string",
    "registration_id": "string",
    "registration_name": "string",
    "stack_name": "string",
    "stack_ocid": "string",
    "tenancy_name": "string",
    "tenancy_ocid": "string",
    "updated_at": "string",
    "user_email": "string",
    "user_name": "string",
    "user_ocid": "string"
  }
]

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "cloud_registration_enabled": false,
      "conditions": [],
      "created_at": "string",
      "cspm_enabled": false,
      "finger_print": "string",
      "group_name": "string",
      "group_ocid": "string",
      "home_region": "string",
      "is_connected": false,
      "key_age": 0,
      "overall_status": "string",
      "policy_name": "string",
      "policy_ocid": "string",
      "private_key": "string",
      "products": {},
      "public_key": "string",
      "registration_description": "string",
      "registration_id": "string",
      "registration_name": "string",
      "stack_name": "string",
      "stack_ocid": "string",
      "tenancy_name": "string",
      "tenancy_ocid": "string",
      "updated_at": "string",
      "user_email": "string",
      "user_name": "string",
      "user_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "cloud_registration_enabled": false,
      "conditions": [],
      "created_at": "string",
      "cspm_enabled": false,
      "finger_print": "string",
      "group_name": "string",
      "group_ocid": "string",
      "home_region": "string",
      "is_connected": false,
      "key_age": 0,
      "overall_status": "string",
      "policy_name": "string",
      "policy_ocid": "string",
      "private_key": "string",
      "products": {},
      "public_key": "string",
      "registration_description": "string",
      "registration_id": "string",
      "registration_name": "string",
      "stack_name": "string",
      "stack_ocid": "string",
      "tenancy_name": "string",
      "tenancy_ocid": "string",
      "updated_at": "string",
      "user_email": "string",
      "user_name": "string",
      "user_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "cloud_registration_enabled": false,
      "conditions": [],
      "created_at": "string",
      "cspm_enabled": false,
      "finger_print": "string",
      "group_name": "string",
      "group_ocid": "string",
      "home_region": "string",
      "is_connected": false,
      "key_age": 0,
      "overall_status": "string",
      "policy_name": "string",
      "policy_ocid": "string",
      "private_key": "string",
      "products": {},
      "public_key": "string",
      "registration_description": "string",
      "registration_id": "string",
      "registration_name": "string",
      "stack_name": "string",
      "stack_ocid": "string",
      "tenancy_name": "string",
      "tenancy_ocid": "string",
      "updated_at": "string",
      "user_email": "string",
      "user_name": "string",
      "user_ocid": "string"
    }
  ]
}

cloud-security-registration-oci-validate-tenancy

Validate the OCI account in CSPM for a provided CID.

Method POST

Route /cloud-security-registration-oci/entities/account-validate/v1

Scope Cloud Security OCI Registration: WRITE

PEP 8 validate_tenancy

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

resources body · array

products body · list of dictionaries

OCI products to validate.

tenancy_ocid body · string

OCI tenancy ID.

Code Examples

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

products = [
    {
        "features": [
            "string"
        ],
        "product": "string"
    }
]

response = falcon.validate_tenancy(products=products, tenancy_ocid="string")
print(response)

from falconpy import CloudOCIRegistration

falcon = CloudOCIRegistration(client_id=CLIENT_ID,
                              client_secret=CLIENT_SECRET
                              )

products = [
    {
        "features": [
            "string"
        ],
        "product": "string"
    }
]

response = falcon.cloud_security_registration_oci_validate_tenancy(products=products,
                                                                   tenancy_ocid="string")
print(response)

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "resources": [
        {
            "products": [
                {
                    "features": ["string"],
                    "product": "string"
                }
            ],
            "tenancy_ocid": "string"
        }
    ]
}

response = falcon.command("cloud_security_registration_oci_validate_tenancy", body=body_payload)
print(response)

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/cloud_oci_registration"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  product := "string"
  tenancy_ocid := "string"

  response, err := client.CloudOciRegistration.CloudSecurityRegistrationOciValidateTenancy(
    &cloud_oci_registration.CloudSecurityRegistrationOciValidateTenancyParams{
      Body: &models.DomainOCIValidateRequestV1{
        Resources: []interface{}{
          {
          Products: []interface{}{
            {
            Features: []string{"string"},
            Product: &product,
            },
          },
          TenancyOcid: &tenancy_ocid,
          },
        },
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.cloudOciRegistration.cloudSecurityRegistrationOciValidateTenancy(
  {
    resources: [{
        products: [{
            features: [],
            product: "string"
          }],
        tenancyOcid: "string"
      }]
}  // body
);

console.log(response);

use rusty_falcon::apis::cloud_oci_registration_api::cloud_security_registration_oci_validate_tenancy;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::DomainOciValidateRequestV1;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = DomainOciValidateRequestV1 {
        resources: vec![OCIValidateRequestData {
            products: vec![ProductFeatures {
                features: vec!["string".to_string()],
                product: Some("string".to_string()),
                ..Default::default()
            }],
            tenancy_ocid: Some("string".to_string()),
            ..Default::default()
        }],
        ..Default::default()
    };

    let response = cloud_security_registration_oci_validate_tenancy(
        &falcon.cfg,  // configuration
        body,  // body
    ).await.expect("API call failed");

    println!("{:?}", response);
}

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::CloudOciRegistration.new

body = Falcon::DomainOCIValidateRequestV1.new(
  resources: [{
      products: [{
          features: [],
          product: 'string'
        }],
      tenancy_ocid: 'string'
    }]
)

response = api.cloud_security_registration_oci_validate_tenancy(body)

puts response

Responses

[
  {
    "cid": "string",
    "home_region": "string",
    "overall_status": "string",
    "products": {},
    "tenancy_ocid": "string"
  }
]

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "home_region": "string",
      "overall_status": "string",
      "products": {},
      "tenancy_ocid": "string"
    }
  ]
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  },
  "resources": [
    {
      "cid": "string",
      "home_region": "string",
      "overall_status": "string",
      "products": {},
      "tenancy_ocid": "string"
    }
  ]
}

Cloud OCI Registration

Table of Contents

cloud-security-registration-oci-create-account

Parameters

cloud-security-registration-oci-delete-account

Parameters

cloud-security-registration-oci-download-script

Parameters

cloud-security-registration-oci-get-account

Parameters

cloud-security-registration-oci-rotate-key

Parameters

cloud-security-registration-oci-update-account

Parameters

cloud-security-registration-oci-validate-tenancy

Parameters