🧹 integrate registration token docs into terraform docs schema

docs/create_spaces/README.md → docs/resources/mondoo_registration_token.md

@@ -1,29 +1,32 @@
-# Example to create spaces + get registration token
+# Example to Create Spaces and Get Registration Tokens
 
-This example creates 3 different Mondoo Spaces in a given Mondoo Organisation and provides the user for each Space a non-expiring Mondoo Registration Token.
+This example demonstrates how to create three different Mondoo Spaces in a Mondoo Organisation and obtain a non-expiring
+Mondoo Registration Token for each Space.
 
-## Prereqs
+## Prerequisites
+
+Before proceeding, make sure you have the following:
 
 - [Mondoo Platform account](https://mondoo.com/docs/platform/start/plat-start-acct/)
 - [Mondoo Organisation](https://mondoo.com/docs/platform/start/organize/overview/)
 - [Mondoo API Token](https://mondoo.com/docs/platform/maintain/access/api-tokens/)
 
 ## Usage
 
-Adjust the variables `space_names` and `org_id` in `terraform.tfvars`:
+1. Adjust the variables `space_names` and `org_id`  in the  `terraform.tfvars` file:
 
-```coffee
+```hcl
 space_names = ["Terraform Mondoo1", "Terraform Mondoo2", "Terraform Mondoo3"]
-org_id = "love-mondoo-131514041515"
+org_id      = "love-mondoo-131514041515"  
 ```
 
-Set the Mondoo API token
+2. Set the Mondoo Organization Service Account token
 
 ```bash
-export MONDOO_API_TOKEN="InsertTokenHere"
+export MONDOO_CONFIG_BASE64=""
 ```
 
-Initialize a working directory containing Terraform configuration files.
+3. Initialize a working directory containing Terraform configuration files:
 
 ```bash
 terraform init
@@ -40,18 +43,7 @@ selections it made above. Include this file in your version control repository
 so that Terraform can guarantee to make the same selections by default when
 you run "terraform init" in the future.
 
-╷
-│ Warning: Incomplete lock file information for providers
-│
-│ Due to your customized provider installation methods, Terraform was forced to calculate lock file checksums locally for the following providers:
-│   - mondoo/mondoo
-│
-│ The current .terraform.lock.hcl file only includes checksums for darwin_arm64, so Terraform running on another platform will fail to install these providers.
-│
-│ To calculate additional checksums for another platform, run:
-│   terraform providers lock -platform=linux_amd64
-│ (where linux_amd64 is the platform to generate)
-╵
+...
 
 Terraform has been successfully initialized!
 
@@ -64,7 +56,7 @@ rerun this command to reinitialize your working directory. If you forget, other
 commands will detect it and remind you to do so if necessary.
 ```
 
-Create an execution plan, which lets you preview the changes that the Terraform plan makes to your Mondoo Organisation:
+4. Create an execution plan to preview the changes that the Terraform plan will make to your Mondoo Organisation:
 
 ```bash
 terraform plan -out plan.out
@@ -133,15 +125,13 @@ Plan: 6 to add, 0 to change, 0 to destroy.
 Changes to Outputs:
   + complete_space_setup = (sensitive value)
 
-────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
-
 Saved the plan to: plan.out
 
 To perform exactly these actions, run the following command to apply:
     terraform apply "plan.out"
 ```
 
-Execute the actions proposed in the Terraform plan
+5. Apply the actions proposed in the Terraform plan:
 
 ```bash
 terraform apply -auto-approve plan.out
@@ -166,7 +156,7 @@ Outputs:
 complete_space_setup = <sensitive>
 ```
 
-Extract the value of the output variable `complete_space_setup` from the state file.
+6. Extract the value of the output variable `complete_space_setup` from the state file:
 
 ```bash
 terraform output -json complete_space_setup | jq
@@ -175,17 +165,20 @@ terraform output -json complete_space_setup | jq
   {
     "space-id": "sad-wescoff-418523",
     "space-name": "Terraform Mondoo1",
-    "token": "eyJhbGciOiJFUzM4NCIsInR5cCI6IkpXVCJ9.eyJhcGlfZW5kcG9pbnQiOiJodHRwczovL3VzLmFwaS5tb25kb28uY29tIiwiYXVkIjpbIm1vbmRvbyJdLCJjZXJ0X3ZhbGlkX3VudGlsIjoiOTk5OS0xMi0zMVQyMzo1OTo1OVoiLCJkZXNjIjoiR2V0IGEgbW9uZG9vIHJlZ2lzdHJhdGlvbiB0b2tlbiIsImlhdCI6MTY5OTA5NDA3MiwiaXNzIjoibW9uZG9vL2FtcyIsImxhYmVscyI6bnVsbCwibmJmIjoxNjk5MDk0MDcyLCJvd25lciI6IiIsInNjb3BlIjoiLy4NTI1Iiwic3ViIjoiLy9hZ2VudHMuYXBpLm1vbmRvby5hcHAvb3JnYW5pemF0aW9ucy9zdHVwZWZpZWQtam9obnNvbi02MzExNTUvc2VydmljZWFjY291bnRzLzJYZmxFU3NJN3VPbHc2VVhUMXlsbXdhUGRrciJ9.ajcJeYC5WTX7TwJdIO8wBITXwIGHuhxp2qGVgAWKaRgKTUlbEUkua898PBJWpseDDUpRZVKMBZpQjd78xglJtd0nUiBvg2b4py3XIPlutxBAhNHar"
+    "token": "eyJhbGciOiJFUzM4NCIsInR...XIPlutxBAhNHar"
   },
   {
     "space-id": "admiring-wiles-299863",
     "space-name": "Terraform Mondoo2",
-    "token": "eyJhbGciOiJFUzM4NCIsInR5cCI6IkpXVCJ9.eyJhcGlfZW5kcG9pbnQiOiJodHRwczovL3VzHJhdGlvbiB0b2tlbiIsImlhdCI6MTY5OTA5NDA3MiwiaXNzIjoibW9uZG9vL2FtcyIsImxhYmVscyI6bnVsbCwibmJmIjoxNjk5MDk0MDcyLCJvd25lciI6IiIsInNjb3BlIjoiLy9jYXB0YWluLmFwaS5tb25kb28uYXBwL3NwYWNlcy9hZG1pcmluZy13aWxlcy0yOTk4NjQiLCJzcGFjZSI6Ii8vY2FwdGFpbi5hcGkubW9uZG9vLmFwcC9zcGFjZXMvYWRtaXJpbmctd2lsZXMtMjk5ODY0Iiwic3ViIjoiLy9hZ2VudHMuYXBpLm1vbmRvby5hcHAvb3JnYW5pemF0aW9ucy9zdHVwZWZpZWQtam9obnNvbi02MzExNTUvc2VydmljZWFjY291bnRzLzJYZmxFU3NJN3VPbHc2VVhUMXlsbXdhUGRrciJ9.Dq98j1sWXShNxhWXJC0aqZsbcqcOyDH3SQdwU7S67bh_qQMgYS8WSQgM_0QmbVNOBYg3mNVEr2lwB45w105zXkvADk_KBpXgfIHS3rXQXJIK"
+    "token": "eyJhbGciOiJFUzM4NCIsI...5zXkvADk_KBpXgfIHS3rXQXJIK"
   },
   {
     "space-id": "inspiring-tesla-178593",
     "space-name": "Terraform Mondoo3",
-    "token": "eyJhbGciOiJFUzM4NCIsInR5cCI6IkpXVCJ9.eyJhcGlfZW5kcG9pbnQiOiJodHRwczovL3VzLmFwaS5tb25kb28uY29tIiwiYXVkIjpbIm1vbmRvbyJdLCJjZXJ0X3ZhbGlkX3VudGlsIjoiOTk5OS0xMi0zMVQyMzo1OTo1OVoiLCJkZXNjIjoiR2V0IGEgbW9uZG9vIHJlZ2lzdHJhdGlvbiB0b2tlbiIsImlhdCI6MTY5OTA5NDA3MiwiaXNzIjoibW9uZG9vL2FtcyIsImxhYmVscyI6bnVsbCwibmJmIjoxNjk5MDk0MDcyLCJvd25lciI6IiIsInNjb3BlIjopcmluZy10ZXNsYS0xNzg1OTIiLCJzdWIiOiIvL2FnZW50cy5hcGkubW9uZG9vLmFwcC9vcmdhbml6YXRpb25zL3N0dXBlZmllZC1qb2huc29uLTYzMTE1NS9zZXJ2aWNlYWNjb3VudHMvMlhmbEVTc0k3dUmaFeCIKxr6xbSDqNRIzEwSDVlx7TO2AVQm9w-k0hy8jCkfjXk6VBGwFOtz9TiWHeoQZz8igh5pOoeQwc-TjglUZx"
+    "token": "eyJhbGciOiJFUzM4...OoeQwc-TjglUZx"
   }
 ]
-```
+```
+
+You succesfully created Mondoo spaces and generated registration tokens for each space, which will be displayed in the
+output. 

docs/resources/registration_token.md

@@ -21,28 +21,46 @@ terraform {
   }
 }
 
-provider "mondoo" {
-  region = "us"
+provider "mondoo" {}
+
+variable "space_names" {
+  description = "Create Spaces with these names"
+  type        = list(string)
+  default     = []
+}
+
+variable "org_id" {
+  description = "The organization id to create the spaces in"
+  type        = string
+  default     = ""
 }
 
 resource "mondoo_space" "my_space" {
-  name = "My Space Name"
-  # space_id = "your-space-id" # optional
-  org_id = "your-org-1234567"
+  count  = length(var.space_names)
+  name   = var.space_names[count.index]
+  org_id = var.org_id
 }
 
 resource "mondoo_registration_token" "token" {
-  description   = "Service Account for Terraform"
-  space_id      = mondoo_space.my_space.id
+  description   = "Get a mondoo registration token"
+  count         = length(var.space_names)
+  space_id      = mondoo_space.my_space[count.index].id
   no_exipration = true
   // expires_in = "1h"
   depends_on = [
     mondoo_space.my_space
   ]
 }
 
-output "generated_token" {
-  value     = mondoo_registration_token.token.result
+output "complete_space_setup" {
+  value = [
+    for count, space in mondoo_space.my_space :
+    {
+      space-name : space.name,
+      space-id : space.id,
+      token : mondoo_registration_token.token[count].result
+    }
+  ]
   sensitive = true
 }
 ```

examples/resources/mondoo_registration_token/resource.tf

@@ -6,27 +6,45 @@ terraform {
   }
 }
 
-provider "mondoo" {
-  region = "us"
+provider "mondoo" {}
+
+variable "space_names" {
+  description = "Create Spaces with these names"
+  type        = list(string)
+  default     = []
+}
+
+variable "org_id" {
+  description = "The organization id to create the spaces in"
+  type        = string
+  default     = ""
 }
 
 resource "mondoo_space" "my_space" {
-  name = "My Space Name"
-  # space_id = "your-space-id" # optional
-  org_id = "your-org-1234567"
+  count  = length(var.space_names)
+  name   = var.space_names[count.index]
+  org_id = var.org_id
 }
 
 resource "mondoo_registration_token" "token" {
-  description   = "Service Account for Terraform"
-  space_id      = mondoo_space.my_space.id
+  description   = "Get a mondoo registration token"
+  count         = length(var.space_names)
+  space_id      = mondoo_space.my_space[count.index].id
   no_exipration = true
   // expires_in = "1h"
   depends_on = [
     mondoo_space.my_space
   ]
 }
 
-output "generated_token" {
-  value     = mondoo_registration_token.token.result
+output "complete_space_setup" {
+  value = [
+    for count, space in mondoo_space.my_space :
+    {
+      space-name : space.name,
+      space-id : space.id,
+      token : mondoo_registration_token.token[count].result
+    }
+  ]
   sensitive = true
 }