🧹 improve the slack integration (#85)

- add markdown description
- use variable for slack token
- trigger scan with integration after the setup

Author: chris-rock

docs/resources/integration_slack.md

@@ -3,12 +3,12 @@
 page_title: "mondoo_integration_slack Resource - terraform-provider-mondoo"
 subcategory: ""
 description: |-
-  
+  Continuously scan your Slack Teams for security misconfigurations.
 ---
 
 # mondoo_integration_slack (Resource)
 
-
+Continuously scan your Slack Teams for security misconfigurations.
 
 ## Example Usage
 
@@ -18,6 +18,11 @@ variable "mondoo_org" {
   type        = string
 }
 
+variable "slack_token" {
+  description = "The Slack Token"
+  type        = string
+}
+
 provider "mondoo" {
   region = "us"
 }
@@ -33,7 +38,7 @@ resource "mondoo_integration_slack" "slack_integration" {
   space_id = mondoo_space.my_space.id
   name     = "My Slack Integration"
 
-  slack_token = "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+  slack_token = var.slack_token
 }
 ```
 

examples/resources/mondoo_integration_slack/resource.tf

@@ -3,6 +3,11 @@ variable "mondoo_org" {
   type        = string
 }
 
+variable "slack_token" {
+  description = "The Slack Token"
+  type        = string
+}
+
 provider "mondoo" {
   region = "us"
 }
@@ -18,5 +23,5 @@ resource "mondoo_integration_slack" "slack_integration" {
   space_id = mondoo_space.my_space.id
   name     = "My Slack Integration"
 
-  slack_token = "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+  slack_token = var.slack_token
 }

internal/provider/integration_slack_resource.go

@@ -41,6 +41,7 @@ func (r *integrationSlackResource) Metadata(ctx context.Context, req resource.Me
 
 func (r *integrationSlackResource) Schema(ctx context.Context, req resource.SchemaRequest, resp *resource.SchemaResponse) {
 	resp.Schema = schema.Schema{
+		MarkdownDescription: "Continuously scan your Slack Teams for security misconfigurations.",
 		Attributes: map[string]schema.Attribute{
 			"space_id": schema.StringAttribute{
 				MarkdownDescription: "Mondoo Space Identifier.",
@@ -116,6 +117,14 @@ func (r *integrationSlackResource) Create(ctx context.Context, req resource.Crea
 		return
 	}
 
+	// trigger integration to gather results quickly after the first setup
+	// NOTE: we ignore the error since the integration state does not depend on it
+	_, err = r.client.TriggerAction(ctx, string(integration.Mrn), mondoov1.ActionTypeRunScan)
+	if err != nil {
+		resp.Diagnostics.AddWarning("Client Error", fmt.Sprintf("Unable to trigger integration, got error: %s", err))
+		return
+	}
+
 	// Save space mrn into the Terraform state.
 	data.Mrn = types.StringValue(string(integration.Mrn))
 	data.Name = types.StringValue(string(integration.Name))