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.4.8
PowerShell	v2.2.9
Go	v0.20.0
TypeScript	v0.6.0
Rust	v0.7.0
Ruby	v1.2.0

Operation	Description
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_validate_tenancy `validate_tenancy`	Validate the OCI account in CSPM for a provided CID. For internal clients only.
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_update_account `update_account`	Update an existing OCI account.
cloud_security_registration_oci_download_script `download_script`	Retrieve script to create resources in tenancy OCID

cloud_security_registration_oci_get_account

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

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

Scope Cloud Security OCI Registration: READ Consumes · Produces application/json

PEP 8 get_account

Parameters

Name	Type	Data type	Description
filter	query	string	FQL (Falcon Query Language) string for filtering results. Allowed filters: `home_region`, `key_age`, `overall_status`, `created_at`, `updated_at`, `tenancy_ocid`, and `tenancy_name`.
sort	query	string	Field and direction for sorting results - allowed sort fields: `home_region`, `key_age`, `overall_status`, `created_at`, `updated_at`, `tenancy_ocid`, and `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.

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

cloud_security_registration_oci_rotate_key

Refresh key for the OCI tenancy.

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

Scope Cloud Security OCI Registration: WRITE Consumes · Produces application/json

PEP 8 rotate_key

Parameters

Name	Type	Data type	Description
body	body	dictionary	Full body payload in JSON format.
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

cloud_security_registration_oci_validate_tenancy

Validate the OCI account in CSPM for a provided CID. For internal clients only.

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

Scope Cloud Security OCI Registration: WRITE Consumes · Produces application/json

PEP 8 validate_tenancy

Parameters

Name	Type	Data type	Description
body	body	dictionary	Full body payload in JSON format.
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
                              )

response = falcon.validate_tenancy(products=[{"key": "value"}],
                                   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_validate_tenancy(products=[{"key": "value"}],
                                                                   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

cloud_security_registration_oci_create_account

Create OCI tenancy account in CSPM

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

Scope Cloud Security OCI Registration: WRITE Consumes · Produces application/json

PEP 8 create_account

Parameters

Name	Type	Data type	Description
body	body	dictionary	Full body payload in JSON format.
group_name	body	string	OCI group name.
home_region	body	string	OCI home region.
policy_name	body	string	OCI policy name.
products	body	list of dictionaries	OCI products to validate.
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
                              )

response = falcon.create_account(group_name="string",
                                 home_region="string",
                                 policy_name="string",
                                 products=[{"key": "value"}],
                                 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
                              )

response = falcon.cloud_security_registration_oci_create_account(group_name="string",
                                                                 home_region="string",
                                                                 policy_name="string",
                                                                 products=[{"key": "value"}],
                                                                 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"
                }
            ],
            "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"
  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,
            },
          },
          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"
          }],
        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'
        }],
      tenancy_ocid: 'string',
      user_email: 'string',
      user_name: 'string'
    }]
)

response = api.cloud_security_registration_oci_create_account(body)

puts response

cloud_security_registration_oci_delete_account

Delete an existing OCI tenancy in CSPM.

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

Scope Cloud Security OCI Registration: WRITE Consumes · Produces application/json

PEP 8 delete_account

Parameters

Name	Type	Data type	Description
ids	query	array (string)	OCI tenancy ocids to remove.
parameters	query	dictionary	Full query string parameters payload in JSON format.

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

cloud_security_registration_oci_update_account

Update an existing OCI account.

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

Scope Cloud Security OCI Registration: WRITE Consumes · Produces application/json

PEP 8 update_account

Parameters

Name	Type	Data type	Description
body	body	dictionary	Full body payload in JSON format.
group_name	body	string	OCI group name.
home_region	body	string	OCI home region.
policy_name	body	string	OCI policy name.
products	body	list of dictionaries	OCI products to validate.
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
                              )

response = falcon.update_account(group_name="string",
                                 home_region="string",
                                 policy_name="string",
                                 products=[{"key": "value"}],
                                 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
                              )

response = falcon.cloud_security_registration_oci_update_account(group_name="string",
                                                                 home_region="string",
                                                                 policy_name="string",
                                                                 products=[{"key": "value"}],
                                                                 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"
                }
            ],
            "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"
  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,
            },
          },
          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"
          }],
        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'
        }],
      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

cloud_security_registration_oci_download_script

Retrieve script to create resources in tenancy OCID.

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

Scope Cloud Security OCI Registration: WRITE Consumes · Produces application/json

PEP 8 download_script

Parameters

Name	Type	Data type	Description
body	body	dictionary	Full body payload in JSON format.
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

Cloud OCI Registration

Table of Contents

cloud_security_registration_oci_get_account

Parameters

Code Examples

cloud_security_registration_oci_rotate_key

Parameters

Code Examples

cloud_security_registration_oci_validate_tenancy

Parameters

Code Examples

cloud_security_registration_oci_create_account

Parameters

Code Examples

cloud_security_registration_oci_delete_account

Parameters

Code Examples

cloud_security_registration_oci_update_account

Parameters

Code Examples

cloud_security_registration_oci_download_script

Parameters

Code Examples