docs(adt): add endpoint macros

Author: nerda-codes

macros/audit-trail/iam-endpoints.mdx

@@ -0,0 +1,24 @@
+---
+macro: audit-trail-iam-endpoints
+---
+
+### Supported endpoints
+
+The following IAM endpoints are supported and will be logged in Audit Trail:
+
+- CreateSSHKey (`POST /iam/v1alpha1/ssh-keys`)
+- UpdateSSHKey (`PATCH /iam/v1alpha1/ssh-keys/{ssh_key_id}`)
+- DeleteSSHKey
+
+### Non supported endpoints
+
+The following IAM endpoints are not supported and will not be logged in Audit Trail:
+
+- 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.

macros/audit-trail/key-manager-endpoints.mdx

@@ -0,0 +1,28 @@
+---
+macro: audit-trail-key-manager-endpoints
+---
+
+### Supported endpoints
+
+The following Key Manager endpoints are supported and will be logged in Audit Trail:
+
+- 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`)
+
+### 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`)

macros/audit-trail/kubernetes-endpoints.mdx

@@ -0,0 +1,28 @@
+---
+macro: audit-trail-kubernetes-endpoints
+---
+
+### Supported endpoints
+
+The following Kubernetes endpoints are supported and will be logged in Audit Trail:
+
+- 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`)
+
+### 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`)

macros/audit-trail/secret-manager-endpoints.mdx

@@ -0,0 +1,30 @@
+---
+macro: audit-trail-secret-manager-endpoints
+---
+
+### Supported endpoints
+
+The following Secret Manager endpoints are supported and will be logged in Audit Trail:
+
+- 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`)
+
+### 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`)

pages/audit-trail/reference-content/resource-integration-with-adt.mdx

@@ -17,19 +17,32 @@ The following table provides details about the Scaleway products that are integr
 
 ## Product integration available
 
-| **Product Name**           | **Audit Trail Integration**     |
+| **Product name**           | **Audit Trail integration**     |
 |----------------------------|---------------------------------|
 | IAM                        | **Integrated**                  |
 | Key Manager                | **Integrated**                  |
 | Kubernetes                 | **Integrated**                  |
 | 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.
 
 
-| **Product Name**           | **Audit Trail Integration**     |
+| **Product name**           | **Audit Trail integration**     |
 |----------------------------|---------------------------------|
 | Object Storage             | **Not integrated yet**                     |
 | Billing                    | **Not integrated yet**                 |