Skip to content

A terraform module for allowing KSOC to connect to your Azure account.

License

Notifications You must be signed in to change notification settings

ksoclabs/terraform-azurerm-ksoc-connect

Repository files navigation

terraform-azurerm-ksoc-connect

Allows KSOC to connect to your Azure accounts to allow for AKS cluster discovery.

Terraform Registry

This module is available in the Terraform Registry see here.

Contributing

The most important thing to be aware of when contributing is that we leverage the Semantic Release Action to automate our changelog, see here.

This requires us to use conventional git commits when committing to this repository.

Each PR merge into the main branch will execute the release process defined here.

Usage

During the sign-up process, you will need to execute this module to allow KSOC to discovery AKS clusters and perform monitoring.

Use the following to configure the Azure Terraform provider:

provider "azuread" {
  tenant_id = "YOUR_AZURE_TENANT_ID"
}

provider "azurerm" {
  features {}
  client_id       = "YOUR_AZURE_CLIENT_ID"
  subscription_id = "YOUR_AZURE_SUBSCRIPTION_ID"
  tenant_id       = "YOUR_AZURE_TENANT_ID"
}

provider "ksoc" {
    access_key_id = "KSOC_ACCESS_KEY"
    secret_key    = "KSOC_SECRET_KEY"
}
module "ksoc-connect" {
  source  = "ksoclabs/ksoc-connect/azurerm"
  version = "<version>"
}

Once applied, KSOC will start synchronizing your resources with KSOC.

Requirements

Name Version
terraform >= 1.0.8
azuread 2.38.0
azurerm 3.54.0
ksoc >= 0.1.0

Providers

Name Version
azuread 2.38.0
azurerm 3.54.0
ksoc >= 0.1.0

Modules

No modules.

Resources

Name Type
azuread_app_role_assignment.ksoc resource
azuread_service_principal.ksoc resource
azurerm_role_assignment.ksoc resource
azurerm_role_definition.ksoc resource
ksoc_azure_register.this resource
azurerm_subscription.primary data source

Inputs

Name Description Type Default Required
ksoc_app_id The ID of the KSOC Azure application. string "4ba48a95-c5da-41d1-897a-57bdf7e34e5b" no
ksoc_role_name Name of custom role to assume string "ksoc-connect" no

Outputs

No outputs.

License

Apache 2 Licensed. See LICENSE for full details.