# Orca Security

### Integration Setup

To configure the Orca Security integration, follow these steps:

1. Within the Gomboc portal, create an access token, either a personal or organization API token will work. Once the token is created, copy it to your clipboard.

<div align="left" data-full-width="false"><figure><img src="/files/tDwVbGlXQvm1IXLhbbay" alt=""><figcaption></figcaption></figure></div>

2. Go to `Settings > Integrations > Orca`

<div align="left" data-full-width="false"><figure><img src="/files/1sy84CTHXWYXjTwRqYDg" alt=""><figcaption></figcaption></figure></div>

2. Insert the Gomboc token you just copied and paste it within the 'Gomboc Token' field

<div align="left"><figure><img src="/files/Onp3TeoMcc1QIHuPjF9f" alt=""><figcaption></figcaption></figure></div>

3. On a separate tab go to your Orca Security account and create an API token.`Account settings > Users & Permissions > API > Add api token`\
   The token should never expire and should have access to the cloud account you would like to remediate.

<div align="left"><figure><img src="/files/drExL6Q9Tdi3YcjnzKht" alt=""><figcaption></figcaption></figure></div>

4. Once the secret is created, copy it and paste it within the 'Orca Token' field on Gomboc.AI. Make sure to select the correct region of your Orca account.

<div align="left"><figure><img src="/files/lnwu4kpJQKC2P7PHX1Av" alt=""><figcaption></figcaption></figure></div>

5.Once the integration is complete you will receive an Access token you will need to use to create the webhook on Orca Security.

<div align="left"><figure><img src="/files/It1EyZQd2noJ7JF0QUiG" alt=""><figcaption></figcaption></figure></div>

6. Within you Orca Security account go to`Settings > Connections > Integrations > Webhook`\
   When creating the webhook, be sure to include the access token you received from the Gomboc integration and include it within the 'API key' field. The trigger URL should also be set to <https://cspm.app.gomboc.ai/api/v1/observations/orca>.

<div align="left"><figure><img src="/files/1tyJDAecS0pgpAnvzpwi" alt=""><figcaption></figcaption></figure></div>

7. Once the webhook is created, you can create an automation with the webhook. Go to the Orca Security automations tab and create a new automation.

<div align="left"><figure><img src="/files/sGFh9of2gkrDZfzRteCp" alt=""><figcaption></figcaption></figure></div>

8. Create the automation to trigger on Alerts with the open state, and have the Webhook URL to be the one you just created in step 7. You can also send existing alerts through the webhook by checking the 'Apply to Existing Alerts' option.

<div align="left"><figure><img src="/files/iFRjHJsMnC9RrE6bj8EW" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gomboc.ai/integrations/cloud-security-posture-management-cspm/orca.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.