docs(adt): add

nerda-codes · nerda-codes · commit 1e4f07dacab1 · 2025-03-20T16:38:48.000+01:00
diff --git a/macros/audit-trail/iam-endpoints.mdx b/macros/audit-trail/iam-endpoints.mdx
@@ -1,24 +1,20 @@
 ---
-macro: audit-trail-iam-endpoints
+macro: adt-iam-endpoints
 ---
 
-### Supported endpoints
+<Concept>
+  ## IAM
 
-The following IAM endpoints are supported and will be logged in Audit Trail:
+  ### IAM supported endpoints
 
-- CreateSSHKey (`POST /iam/v1alpha1/ssh-keys`)
-- UpdateSSHKey (`PATCH /iam/v1alpha1/ssh-keys/{ssh_key_id}`)
-- DeleteSSHKey
+    The following IAM endpoints are supported and will be logged in Audit Trail:
 
-### Non supported endpoints
+    - CreateSSHKey (`POST /iam/v1alpha1/ssh-keys`)
+    - UpdateSSHKey (`PATCH /iam/v1alpha1/ssh-keys/{ssh_key_id}`)
+    - DeleteSSHKey (`DELETE /iam/v1alpha1/ssh-keys/{ssh_key_id}`)
 
-The following IAM endpoints are not supported and will not be logged in Audit Trail:
+    ### Additional information
 
-- ListSSHKeys (`GET /iam/v1alpha1/ssh-keys`)
-- GeSSHKey (`GET /iam/v1alpha1/ssh-keys/{ssh_key_id}`)
-
-### Additional information
-
-- At the creation of the Organization, default policies and groups are created. These actions are logged in Audit Trail.
-
-- Invitation expire after 7 days. At D+7, the user is removed and the creation is logged.
+    - When a Scaleway Organization is created, default policies and groups are automatically generated. These actions are logged in Audit Trail.
+    - Invitations to join a Scaleway Organization expire after seven days. On day seven, the user is removed, and this action is logged in Audit Trail.
+</Concept>
diff --git a/macros/audit-trail/key-manager-endpoints.mdx b/macros/audit-trail/key-manager-endpoints.mdx
@@ -1,28 +1,22 @@
 ---
-macro: audit-trail-key-manager-endpoints
+macro: adt-key-manager-endpoints
 ---
 
-### Supported endpoints
+<Concept>
+  ## Key Manager
 
-The following Key Manager endpoints are supported and will be logged in Audit Trail:
+  ### Key Manager supported endpoints
 
-- CreateKey (`POST /key-manager/v1alpha1/regions/{region}/keys`)
-- UpdateKey (`PATCH /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
-- DeleteKey (`DELETE /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
-- ProtectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/protect`)
-- UnprotectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/unprotect`)
-- RotateKey (Manual rotation) (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/rotate`)
-- DisableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/disable`)
-- EnableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/enable`)
-- ImportKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/import-key-material`)
-- DeleteKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/delete-key-material`)
+    The following Key Manager endpoints are supported and will be logged in Audit Trail:
 
-### Non supported endpoints
-
-The following Key Manager endpoints are not supported and will not be logged in Audit Trail:
-
-- ListKeys (`GET /key-manager/v1alpha1/regions/{region}/keys`)
-- GetKey (`GET /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
-- GenerateDataKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/generate-data-key`)
-- Encrypt (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/encrypt`)
-- Decrypt (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/decrypt`)
+    - CreateKey (`POST /key-manager/v1alpha1/regions/{region}/keys`)
+    - UpdateKey (`PATCH /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
+    - DeleteKey (`DELETE /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
+    - ProtectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/protect`)
+    - UnprotectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/unprotect`)
+    - RotateKey (Manual rotation) (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/rotate`)
+    - DisableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/disable`)
+    - EnableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/enable`)
+    - ImportKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/import-key-material`)
+    - DeleteKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/delete-key-material`)
+</Concept>
diff --git a/macros/audit-trail/kubernetes-endpoints.mdx b/macros/audit-trail/kubernetes-endpoints.mdx
@@ -1,28 +1,22 @@
 ---
-macro: audit-trail-kubernetes-endpoints
+macro: adt-kubernetes-endpoints
 ---
 
-### Supported endpoints
+<Concept>
+  ## Kubernetes
 
-The following Kubernetes endpoints are supported and will be logged in Audit Trail:
+  ### Kubernetes supported endpoints
 
-- CreateKey (`POST /key-manager/v1alpha1/regions/{region}/keys`)
-- UpdateKey (`PATCH /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
-- DeleteKey (`DELETE /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
-- ProtectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/protect`)
-- UnprotectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/unprotect`)
-- RotateKey (Manual rotation) (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/rotate`)
-- DisableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/disable`)
-- EnableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/enable`)
-- ImportKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/import-key-material`)
-- DeleteKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/delete-key-material`)
+    The following Kubernetes endpoints are supported and will be logged in Audit Trail:
 
-### Non supported endpoints
-
-The following Kubernetes endpoints are not supported and will not be logged in Audit Trail:
-
-- ListKeys (`GET /key-manager/v1alpha1/regions/{region}/keys`)
-- GetKey (`GET /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
-- GenerateDataKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/generate-data-key`)
-- Encrypt (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/encrypt`)
-- Decrypt (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/decrypt`)
+    - CreateKey (`POST /key-manager/v1alpha1/regions/{region}/keys`)
+    - UpdateKey (`PATCH /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
+    - DeleteKey (`DELETE /key-manager/v1alpha1/regions/{region}/keys/{key_id}`)
+    - ProtectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/protect`)
+    - UnprotectKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/unprotect`)
+    - RotateKey (Manual rotation) (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/rotate`)
+    - DisableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/disable`)
+    - EnableKey (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/enable`)
+    - ImportKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/import-key-material`)
+    - DeleteKeyMaterial (`POST /key-manager/v1alpha1/regions/{region}/keys/{key_id}/delete-key-material`)
+</Concept>
diff --git a/macros/audit-trail/secret-manager-endpoints.mdx b/macros/audit-trail/secret-manager-endpoints.mdx
@@ -1,30 +1,23 @@
 ---
-macro: audit-trail-secret-manager-endpoints
+macro: adt-secret-manager-endpoints
 ---
 
-### Supported endpoints
+<Concept>
+  ## Secret Manager
 
-The following Secret Manager endpoints are supported and will be logged in Audit Trail:
+  ### Secret Manager supported endpoints
 
-- Create a secret (`POST /secret-manager/v1beta1/regions/{region}/secrets`)
-- Update metadata of a secret (`PATCH /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}`)
-- Delete a secret (`DELETE /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}`)
-- Allow a product to use the secret (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/add-owner`)
-- Enable secret protection (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/protect`)
-- Disable secret protection (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/unprotect`)
-- Create a version (`/secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions`)
-- Update metadata of a version (`PATCH /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}`)
-- Delete a version (`DELETE /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}`)
-- Disable a version (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}/disable`)
-- Enable a version (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}/disable`)
+    The following Secret Manager endpoints are supported and will be logged in Audit Trail:
 
-### Non supported endpoints
-
-The following Secret Manager endpoints are not supported and will not be logged in Audit Trail:
-
-- List secrets (Listing page) (`GET /secret-manager/v1beta1/regions/{region}/secrets`)
-- Get metadata using the secret's ID (Overview) (`GET /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}`)
-- List versions of a secret using the secret's ID (List versions of a secret without seing the payload) (`GET /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions`)
-- Get metadata of a secret's version using the secret's ID (Overview) (`GET /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}`)
-- Access a secret's version using the secret's ID (`GET /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}/access`)
-- Access a secret's version using the secret's name and path (`GET /secret-manager/v1beta1/regions/{region}/secrets-by-path/versions/{revision}/access`)
+    - Create a secret (`POST /secret-manager/v1beta1/regions/{region}/secrets`)
+    - Update metadata of a secret (`PATCH /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}`)
+    - Delete a secret (`DELETE /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}`)
+    - Allow a product to use the secret (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/add-owner`)
+    - Enable secret protection (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/protect`)
+    - Disable secret protection (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/unprotect`)
+    - Create a version (`/secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions`)
+    - Update metadata of a version (`PATCH /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}`)
+    - Delete a version (`DELETE /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}`)
+    - Disable a version (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}/disable`)
+    - Enable a version (`POST /secret-manager/v1beta1/regions/{region}/secrets/{secret_id}/versions/{revision}/disable`)
+</Concept>
diff --git a/menu/navigation.json b/menu/navigation.json
@@ -516,6 +516,10 @@
                   {
                     "label": "Audit Trail product integration",
                     "slug": "resource-integration-with-adt"
+                  },
+                  {
+                    "label": "Supported endpoints for Audit Trail",
+                    "slug": "adt-supported-endpoints"
                   }
                 ],
                 "label": "Additional Content",
diff --git a/pages/audit-trail/reference-content/adt-supported-endpoints.mdx b/pages/audit-trail/reference-content/adt-supported-endpoints.mdx
@@ -0,0 +1,28 @@
+---
+meta:
+  title: Supported endpoints for Audit Trail
+  description: Discover current Scaleway product integrations and endpoints supported in Audit Trail for event tracking.
+content:
+  h1: Supported endpoints for Audit Trail
+  paragraph: Discover current Scaleway product integrations and endpoints supported in Audit Trail for event tracking.
+tags: audit-trail product-integration products endpoints
+dates:
+  validation: 2025-03-20
+  posted: 2025-03-20
+categories:
+  - identity-and-access-management
+---
+
+This page provides information on the specific endpoints logged in [Audit Trail](/audit-trail/) for Scaleway products. Refer to the [dedicated documentation](/audit-trail/reference-content/resource-integration-with-adt/) for a list of Scaleway products integrated with Audit Trail.
+
+
+<Macro id="adt-iam-endpoints" />
+
+
+<Macro id="adt-key-manager-endpoints" />
+
+
+<Macro id="adt-kubernetes-endpoints" />
+
+
+<Macro id="adt-secret-manager-endpoints" />
diff --git a/pages/audit-trail/reference-content/resource-integration-with-adt.mdx b/pages/audit-trail/reference-content/resource-integration-with-adt.mdx
@@ -25,18 +25,6 @@ The following table provides details about the Scaleway products that are integr
 | Secret Manager             | **Integrated**                  |
 
 
-## Key Manager
-
-<Macro id="audit-trail-key-manager-endpoints" />
-
-## Kubernetes
-
-<Macro id="audit-trail-kubernetes-endpoints" />
-
-## Secret Manager
-
-<Macro id="audit-trail-secret-manager-endpoints" />
-
 ## Planned product integration
 
 The following table provides details about the Scaleway products that will be integrated with Audit Trail.

Original file line number	Diff line number	Diff line change
`@@ -516,6 +516,10 @@`
`516`	`516`	`{`
`517`	`517`	`"label": "Audit Trail product integration",`
`518`	`518`	`"slug": "resource-integration-with-adt"`
	`519`	`+ },`
	`520`	`+ {`
	`521`	`+ "label": "Supported endpoints for Audit Trail",`
	`522`	`+ "slug": "adt-supported-endpoints"`
`519`	`523`	`}`
`520`	`524`	`],`
`521`	`525`	`"label": "Additional Content",`