feat: added zendesk integration (#170)

* feat: added zendesk integration Signed-off-by: Matthias Theuermann <[email protected]> * fix: requested changes Signed-off-by: Matthias Theuermann <[email protected]> * fix: acceptance tests Signed-off-by: Matthias Theuermann <[email protected]> --------- Signed-off-by: Matthias Theuermann <[email protected]>
mondoohq · Dec 13, 2024 · ebbac97 · ebbac97
1 parent bb85c20
commit ebbac97
Show file tree

Hide file tree

Showing 7 changed files with 592 additions and 0 deletions.
diff --git a/docs/resources/integration_zendesk.md b/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.
diff --git a/examples/resources/mondoo_integration_zendesk/main.tf b/examples/resources/mondoo_integration_zendesk/main.tf
@@ -0,0 +1,8 @@
+terraform {
+  required_providers {
+    mondoo = {
+      source  = "mondoohq/mondoo"
+      version = ">= 0.19"
+    }
+  }
+}
diff --git a/examples/resources/mondoo_integration_zendesk/resource.tf b/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
+  }
+}
diff --git a/internal/provider/gql.go b/internal/provider/gql.go
@@ -617,6 +617,19 @@ type ShodanConfigurationOptions struct {
 	Targets []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
@@ -647,6 +660,7 @@ type ClientIntegrationConfigurationOptions struct {
 	GithubConfigurationOptions    GithubConfigurationOptions    `graphql:"... on GithubConfigurationOptions"`
 	HostedAwsConfigurationOptions HostedAwsConfigurationOptions `graphql:"... on HostedAwsConfigurationOptions"`
 	ShodanConfigurationOptions    ShodanConfigurationOptions    `graphql:"... on ShodanConfigurationOptions"`
+	ZendeskConfigurationOptions   ZendeskConfigurationOptions   `graphql:"... on ZendeskConfigurationOptions"`
 	JiraConfigurationOptions      JiraConfigurationOptions      `graphql:"... on JiraConfigurationOptions"`
 	EmailConfigurationOptions     EmailConfigurationOptions     `graphql:"... on EmailConfigurationOptions"`
 	GitlabConfigurationOptions    GitlabConfigurationOptions    `graphql:"... on GitlabConfigurationOptions"`