Skip to content

Akamai: add the Guardicore documentation#2925

Open
squioc wants to merge 1 commit intomainfrom
feat/AkamaiGuardicoreDocumentation
Open

Akamai: add the Guardicore documentation#2925
squioc wants to merge 1 commit intomainfrom
feat/AkamaiGuardicoreDocumentation

Conversation

@squioc
Copy link
Copy Markdown
Contributor

@squioc squioc commented Apr 9, 2026

No description provided.

@squioc squioc requested review from a team and Copilot April 9, 2026 15:34
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Sekoia.io integration documentation page for Akamai Guardicore and wires it into the MkDocs navigation.

Changes:

  • Add Akamai Guardicore integration guide (configuration steps + troubleshooting) under Network Security.
  • Add the Guardicore screenshot assets used by the guide.
  • Register the new page in mkdocs.yml nav.

Reviewed changes

Copilot reviewed 2 out of 10 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
mkdocs.yml Adds the new Guardicore page to the Network Security navigation.
docs/integration/categories/network_security/akamai_guardicore.md New integration documentation page with setup steps and shared-content includes.
docs/assets/operation_center/integration_catalog/network_security/akamai_guardicore/Step 02.png Screenshot asset referenced by the new doc.
docs/assets/operation_center/integration_catalog/network_security/akamai_guardicore/Step 05 bis.png Screenshot asset referenced by the new doc.
docs/assets/operation_center/integration_catalog/network_security/akamai_guardicore/Step 07.png Screenshot asset referenced by the new doc.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +148 to +155
{!_shared_content/operations_center/integrations/generated/f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5_sample.md!}

{!_shared_content/integration/detection_section.md!}

{!_shared_content/operations_center/detection/generated/suggested_rules_f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5_do_not_edit_manually.md!}

{!_shared_content/operations_center/integrations/generated/f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5.md!}

Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This page includes generated-snippet includes for UUID f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5, but the referenced _shared_content/operations_center/.../generated/*f1eb2bd3* files are not present in the repo. MkDocs will fail to build/render these includes unless the corresponding generated *_sample.md, suggested rules, and details files are committed (or the includes are removed).

Suggested change
{!_shared_content/operations_center/integrations/generated/f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5_sample.md!}
{!_shared_content/integration/detection_section.md!}
{!_shared_content/operations_center/detection/generated/suggested_rules_f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5_do_not_edit_manually.md!}
{!_shared_content/operations_center/integrations/generated/f1eb2bd3-dd6d-4b41-b3be-80874d1bd2d5.md!}
{!_shared_content/integration/detection_section.md!}

Copilot uses AI. Check for mistakes.
Comment on lines +63 to +66
The previous domain works for the FRA1 region. For any other region, replace the domain “intake.sekoia.io” with your region’s Syslog-intake domain—for example:

intake.usa1.sekoia.io:10514

Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The warning suggests using intake.usa1.sekoia.io:10514 as a replacement for the Syslog domain, but earlier steps split Syslog host and Syslog port into separate fields. Using host:port in the host field may lead to misconfiguration; please clarify whether the host should be intake.<region>.sekoia.io with port 10514, or update the instructions accordingly.

Suggested change
The previous domain works for the FRA1 region. For any other region, replace the domain “intake.sekoia.io” with your region’s Syslog-intake domain—for example:
intake.usa1.sekoia.io:10514
The previous domain works for the FRA1 region. For any other region, replace the `Syslog host` value `intake.sekoia.io` with your region’s Syslog-intake domain—for example:
`intake.usa1.sekoia.io`
Keep `10514` as the `Syslog port`.

Copilot uses AI. Check for mistakes.
- Replace `<YOUR_INTAKE_KEY_HERE>` with the intake key created with the intake
- Click `OK`

![Step 05 bis](/assets/operation_center/integration_catalog/network_security/akamai_guardicore/Step 05 bis.png){: style="max-width:100%"}
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The image filename Step 05 bis.png contains spaces. This can introduce URL-encoding / portability issues and is inconsistent with most other asset naming in the docs. Consider renaming the asset to a space-free name (e.g., step_05_bis.png) and updating all references.

Suggested change
![Step 05 bis](/assets/operation_center/integration_catalog/network_security/akamai_guardicore/Step 05 bis.png){: style="max-width:100%"}
![Step 05 bis](/assets/operation_center/integration_catalog/network_security/akamai_guardicore/step_05_bis.png){: style="max-width:100%"}

Copilot uses AI. Check for mistakes.
Comment on lines +43 to +44
- Log in the Akamai Guardicore console
- With the left panel, go to `System` > `INTEGRATION` >`Data Exporters`
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor grammar: consider changing “Log in the Akamai Guardicore console” to “Log in to …”, and “With the left panel” to “In the left panel” for clarity.

Suggested change
- Log in the Akamai Guardicore console
- With the left panel, go to `System` > `INTEGRATION` >`Data Exporters`
- Log in to the Akamai Guardicore console
- In the left panel, go to `System` > `INTEGRATION` >`Data Exporters`

Copilot uses AI. Check for mistakes.

### No event is received

In the Akamai Guardicore console, for each data exporters for Sekoia.io, check, in the `Message format` section:
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor grammar: “for each data exporters” should be singular (“for each data exporter”) or rephrased (e.g., “for each data exporter configured for Sekoia.io”).

Suggested change
In the Akamai Guardicore console, for each data exporters for Sekoia.io, check, in the `Message format` section:
In the Akamai Guardicore console, for each data exporter for Sekoia.io, check, in the `Message format` section:

Copilot uses AI. Check for mistakes.
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 9, 2026

Newest code from squioc has been published to preview environment

🚀 Latest deployment was built on 2026-04-09 15:40:57 (55d503563eb994521d5c7f08963d9729303e6b9e).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants