Merge branch 'main' into msdefender_integration

docs/resources/integration_zendesk.md

@@ -0,0 +1,87 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "mondoo_integration_zendesk Resource - terraform-provider-mondoo"
+subcategory: ""
+description: |-
+  Zendesk integration to keep track of security tasks and add Zendesk tickets directly from within the Mondoo Console.
+---
+
+# mondoo_integration_zendesk (Resource)
+
+Zendesk integration to keep track of security tasks and add Zendesk tickets directly from within the Mondoo Console.
+
+## Example Usage
+
+```terraform
+variable "zendesk_token" {
+  description = "The GitHub Token"
+  type        = string
+  sensitive   = true
+}
+
+provider "mondoo" {
+  space = "hungry-poet-123456"
+}
+
+# Setup the zendesk integration
+resource "mondoo_integration_zendesk" "zendesk_integration" {
+  name      = "My Zendesk Integration"
+  subdomain = "your-subdomain"
+  email     = "[email protected]"
+
+  custom_fields = [
+    {
+      id    = "123456"
+      value = "custom_value_1"
+    },
+    {
+      id    = "123457"
+      value = "custom_value_2"
+    }
+  ]
+
+  auto_create = true
+  auto_close  = true
+
+  credentials = {
+    token = var.zendesk_token
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `credentials` (Attributes) (see [below for nested schema](#nestedatt--credentials))
+- `email` (String) Zendesk email.
+- `name` (String) Name of the integration.
+- `subdomain` (String) Zendesk subdomain.
+
+### Optional
+
+- `auto_close` (Boolean) Automatically close tickets.
+- `auto_create` (Boolean) Automatically create tickets.
+- `custom_fields` (Attributes List) Custom fields to be added to the Zendesk ticket. (see [below for nested schema](#nestedatt--custom_fields))
+- `space_id` (String) Mondoo Space Identifier. If it is not provided, the provider space is used.
+
+### Read-Only
+
+- `mrn` (String) Integration identifier
+
+<a id="nestedatt--credentials"></a>
+### Nested Schema for `credentials`
+
+Required:
+
+- `token` (String, Sensitive) Token for GitHub integration.
+
+
+<a id="nestedatt--custom_fields"></a>
+### Nested Schema for `custom_fields`
+
+Required:
+
+- `id` (Number) Custom field ID.
+- `value` (String) Custom field value.

examples/resources/mondoo_integration_zendesk/main.tf

@@ -0,0 +1,8 @@
+terraform {
+  required_providers {
+    mondoo = {
+      source  = "mondoohq/mondoo"
+      version = ">= 0.19"
+    }
+  }
+}

examples/resources/mondoo_integration_zendesk/resource.tf

@@ -0,0 +1,34 @@
+variable "zendesk_token" {
+  description = "The GitHub Token"
+  type        = string
+  sensitive   = true
+}
+
+provider "mondoo" {
+  space = "hungry-poet-123456"
+}
+
+# Setup the zendesk integration
+resource "mondoo_integration_zendesk" "zendesk_integration" {
+  name      = "My Zendesk Integration"
+  subdomain = "your-subdomain"
+  email     = "[email protected]"
+
+  custom_fields = [
+    {
+      id    = "123456"
+      value = "custom_value_1"
+    },
+    {
+      id    = "123457"
+      value = "custom_value_2"
+    }
+  ]
+
+  auto_create = true
+  auto_close  = true
+
+  credentials = {
+    token = var.zendesk_token
+  }
+}

internal/provider/gql.go

@@ -626,6 +626,19 @@ type MicrosoftDefenderConfigurationOptionsInput struct {
 	ClientSecret           string
 }
 
+type ZendeskConfigurationOptions struct {
+	Subdomain         string
+	Email             string
+	AutoCloseTickets  bool
+	AutoCreateTickets bool
+	CustomFields      []ZendeskCustomField
+}
+
+type ZendeskCustomField struct {
+	ID    int64
+	Value string
+}
+
 type JiraConfigurationOptions struct {
 	Host             string
 	Email            string
@@ -657,6 +670,7 @@ type ClientIntegrationConfigurationOptions struct {
 	HostedAwsConfigurationOptions              HostedAwsConfigurationOptions              `graphql:"... on HostedAwsConfigurationOptions"`
 	ShodanConfigurationOptions                 ShodanConfigurationOptions                 `graphql:"... on ShodanConfigurationOptions"`
 	MicrosoftDefenderConfigurationOptionsInput MicrosoftDefenderConfigurationOptionsInput `graphql:"... on MicrosoftDefenderConfigurationOptionsInput"`
+  ZendeskConfigurationOptions                ZendeskConfigurationOptions                `graphql:"... on ZendeskConfigurationOptions"`
   JiraConfigurationOptions                   JiraConfigurationOptions                   `graphql:"... on JiraConfigurationOptions"`
 	EmailConfigurationOptions                  EmailConfigurationOptions                  `graphql:"... on EmailConfigurationOptions"`
 	GitlabConfigurationOptions                 GitlabConfigurationOptions                 `graphql:"... on GitlabConfigurationOptions"`