adding powerplatform_connection and powerplatform_connection_share (#377)

* wip

* Squashed commit of the following:

commit 1b8c806
Author: mawasile <[email protected]>
Date:   Wed May 15 01:37:57 2024 +0200

    resource/datasource primary id should not changes on reapply (#292)

    * chore: making unique resource/datasource id stable & fixing unit tests

    * chore: fixing acceptance tests

    * chore: update display_name in powerplatform environment resources

    * adding new acceptance tests for dlp policies

    ---------

    Co-authored-by: Eduardo Sanchez <[email protected]>

commit 6142aaf
Author: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Date:   Tue May 14 17:21:38 2024 -0600

    Bump hashicorp/local in /examples/resources/powerplatform_solution (#298)

    Bumps [hashicorp/local](https://github.com/hashicorp/terraform-provider-local) from 2.4.0 to 2.5.1.
    - [Release notes](https://github.com/hashicorp/terraform-provider-local/releases)
    - [Changelog](https://github.com/hashicorp/terraform-provider-local/blob/main/CHANGELOG.md)
    - [Commits](hashicorp/terraform-provider-local@v2.4.0...v2.5.1)

    ---
    updated-dependencies:
    - dependency-name: hashicorp/local
      dependency-type: direct:production
      update-type: version-update:semver-minor
    ...

    Signed-off-by: dependabot[bot] <[email protected]>
    Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

commit 54a1173
Author: Matt Dotson <[email protected]>
Date:   Mon May 13 23:46:54 2024 -0700

    Addition of example directories for dependabot scanning (#296)

    * manual addition of example directories

    * fix duplicate path

commit b6b0eec
Author: Eduardo Sanchez <[email protected]>
Date:   Mon May 13 15:30:55 2024 -0600

    Updating Go version and modify tfproviderlint actions to use specified go version (#284)

    * Updating Go version.

    * Disable tfproviderlint.

    * Testing with go vet.

    * Changing run order.

    * Placing all runs inside one job.

    * testing with:         /usr/bin/tfproviderlint ./...

    * changing path for tfproviderlint.

    * testing setup go.

    * Show directory path.

    * Applying comments and updating version.

    * Updating devcontainer version.

    * Disabling tfproviderlint.

    ---------

    Co-authored-by: Eduardo Sanchez <[email protected]>
    Co-authored-by: mawasile <[email protected]>

commit 236a1bf
Author: mawasile <[email protected]>
Date:   Mon May 13 20:02:26 2024 +0200

    Updating developer guide with additional Information (#290)

    * chore: Update documentation for developer workflow and setup instructions

    * chore: Update developer documentation and add unit tests for new feature

    * update docs

    * chore: Update developer documentation, add unit tests, and regenerate docs

    * Update DEVELOPER.md

    Co-authored-by: Matt Dotson <[email protected]>

    ---------

    Co-authored-by: Matt Dotson <[email protected]>

commit ff470f7
Author: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Date:   Mon May 13 11:25:35 2024 -0600

    Bump goreleaser/goreleaser-action from 5.0.0 to 5.1.0 (#293)

    Bumps [goreleaser/goreleaser-action](https://github.com/goreleaser/goreleaser-action) from 5.0.0 to 5.1.0.
    - [Release notes](https://github.com/goreleaser/goreleaser-action/releases)
    - [Commits](goreleaser/goreleaser-action@7ec5c2b...5742e2a)

    ---
    updated-dependencies:
    - dependency-name: goreleaser/goreleaser-action
      dependency-type: direct:production
      update-type: version-update:semver-minor
    ...

    Signed-off-by: dependabot[bot] <[email protected]>
    Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

commit dce39d9
Author: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Date:   Mon May 13 11:25:04 2024 -0600

    Bump goreleaser/goreleaser-action in /.github/workflows (#294)

    Bumps [goreleaser/goreleaser-action](https://github.com/goreleaser/goreleaser-action) from 5.0.0 to 5.1.0.
    - [Release notes](https://github.com/goreleaser/goreleaser-action/releases)
    - [Commits](goreleaser/goreleaser-action@7ec5c2b...5742e2a)

    ---
    updated-dependencies:
    - dependency-name: goreleaser/goreleaser-action
      dependency-type: direct:production
      update-type: version-update:semver-minor
    ...

    Signed-off-by: dependabot[bot] <[email protected]>
    Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

commit 0db25c3
Author: Raphael Pothin <[email protected]>
Date:   Fri May 10 11:12:33 2024 -0400

    Fix proposition for the inversion between "Business" and "Non-business" connectors groups in Power Platform DLP policies (#291)

* addind datasource_connections

* wip

* feat: Add GetConnectorDefinition method to ConnectionsClient

* wip

* ading basic functionality

* lint fix

* connection shares datsource

* feat: Add Azure OpenAI connection output

The code changes add a new output for the Azure OpenAI connection in the `powerplatform_connection` module. This output provides the description, value, and sensitivity of the connection.

* change to documentation

* adding TestAccConnectionssDataSource_Validate_Read

* adding tests

* adding test

* adding acceptance tests

* adding unit tests

* chore: Add connection shares data source

* removing unused method

* filename typo fix

Author: mawasile

docs/data-sources/connection_shares.md

@@ -0,0 +1,64 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "powerplatform_connection_shares Data Source - powerplatform"
+subcategory: ""
+description: |-
+  
+---
+
+# powerplatform_connection_shares (Data Source)
+
+
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    powerplatform = {
+      source = "microsoft/power-platform"
+    }
+  }
+}
+
+provider "powerplatform" {
+  use_cli = true
+}
+
+data "powerplatform_connection_shares" "all_shares" {
+  environment_id = var.environment_id
+  connector_name = "shared_azureopenai"
+  connection_id  = var.azure_openai_connection_id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `connection_id` (String) Connection Id. The unique identifier of the connection that the shares are associated with.
+- `connector_name` (String) Connector Name. The unique identifier of the connector that the connection are associated with.
+- `environment_id` (String) Environment Id. The unique identifier of the environment that the connection are associated with.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+- `shares` (Attributes List) List of shares for a given connection. (see [below for nested schema](#nestedatt--shares))
+
+<a id="nestedatt--shares"></a>
+### Nested Schema for `shares`
+
+Read-Only:
+
+- `id` (String) Unique share id
+- `principal` (Attributes) (see [below for nested schema](#nestedatt--shares--principal))
+- `role_name` (String) Role name of the share
+
+<a id="nestedatt--shares--principal"></a>
+### Nested Schema for `shares.principal`
+
+Read-Only:
+
+- `display_name` (String) Principal Display Name
+- `entra_object_id` (String) Entra Object Id of the principal

docs/data-sources/connections.md

@@ -0,0 +1,57 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "powerplatform_connections Data Source - powerplatform"
+subcategory: ""
+description: |-
+  Fetches a list of Connection https://learn.microsoft.com/en-us/power-apps/maker/canvas-apps/add-manage-connections for a given environment. Each connection represents an connection instance to an external data source or service.
+---
+
+# powerplatform_connections (Data Source)
+
+Fetches a list of [Connection](https://learn.microsoft.com/en-us/power-apps/maker/canvas-apps/add-manage-connections) for a given environment. Each connection represents an connection instance to an external data source or service.
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    powerplatform = {
+      source = "microsoft/power-platform"
+    }
+  }
+}
+
+provider "powerplatform" {
+  use_cli = true
+}
+
+data "powerplatform_environments" "all_environments" {}
+
+data "powerplatform_connections" "all_connections" {
+  environment_id = data.powerplatform_environments.all_environments.environments[0].id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `environment_id` (String) Environment Id. The unique identifier of the environment that the connection are associated with.
+
+### Read-Only
+
+- `connections` (Attributes List) List of Connections (see [below for nested schema](#nestedatt--connections))
+- `id` (String) The ID of this resource.
+
+<a id="nestedatt--connections"></a>
+### Nested Schema for `connections`
+
+Read-Only:
+
+- `connection_parameters` (String) Connection parameters. Json string containing the authentication connection parameters (if connection is interactive, leave blank), (for example)[https://learn.microsoft.com/en-us/power-automate/desktop-flows/alm/alm-connection#create-a-connection-using-your-service-principal]. Depending on required authentication parameters of a given connector, the connection parameters can vary.
+- `connection_parameters_set` (String) Set of connection parameters. Json string containing the authentication connection parameters (if connection is interactive, leave blank), (for example)[https://learn.microsoft.com/en-us/power-automate/desktop-flows/alm/alm-connection#create-a-connection-using-your-service-principal]. Depending on required authentication parameters of a given connector, the connection parameters can vary.
+- `display_name` (String) Display name of the connection.
+- `id` (String) Unique connection id
+- `name` (String) Name of the connection.
+- `status` (Set of String) List of connection statuses

docs/resources/connection.md

@@ -0,0 +1,65 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "powerplatform_connection Resource - powerplatform"
+subcategory: ""
+description: |-
+  Manages a Connection https://learn.microsoft.com/en-us/power-apps/maker/canvas-apps/add-manage-connections. A connection in Power Platform serves as a means to integrate external data sources and services with your Power Platform apps, flows, and other solutions. It acts as a bridge, facilitating secure communication between your solutions and various external systems.
+---
+
+# powerplatform_connection (Resource)
+
+Manages a [Connection](https://learn.microsoft.com/en-us/power-apps/maker/canvas-apps/add-manage-connections). A connection in Power Platform serves as a means to integrate external data sources and services with your Power Platform apps, flows, and other solutions. It acts as a bridge, facilitating secure communication between your solutions and various external systems.
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    powerplatform = {
+      source = "microsoft/power-platform"
+    }
+  }
+}
+
+provider "powerplatform" {
+  use_cli = true
+}
+
+
+resource "powerplatform_connection" "azure_openai_connection" {
+  environment_id = var.environment_id
+  name           = "shared_azureopenai"
+  display_name   = "OpenAI Connection"
+  connection_parameters = jsonencode({
+    "azureOpenAIResourceName" : "${var.azure_openai_resource_name}",
+    "azureOpenAIApiKey" : "${var.azure_openai_api_key}"
+    "azureSearchEndpointUrl" : "${var.azure_search_endpoint_url}",
+    "azureSearchApiKey" : "${var.azure_search_api_key}"
+  })
+
+  lifecycle {
+    ignore_changes = [
+      connection_parameters
+    ]
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `display_name` (String) Display name of the connection
+- `environment_id` (String) Environment id where the connection is to be created
+- `name` (String) Name of the connection. This can be found using `powerplatform_connectors` data source by using the `name` attribute
+
+### Optional
+
+- `connection_parameters` (String) Connection parameters. Json string containing the authentication connection parameters (if connection is interactive, leave blank), (for example)[https://learn.microsoft.com/en-us/power-automate/desktop-flows/alm/alm-connection#create-a-connection-using-your-service-principal]. Depending on required authentication parameters of a given connector, the connection parameters can vary. Due to how connection parameters and served by the platform, not all values are retrieved. If you don't want the connection to requried in-place-update all the time, consider using `ignore_changes` in the resource block.
+- `connection_parameters_set` (String) Set of connection parameters. Json string containing the authentication connection parameters (if connection is interactive, leave blank), (for example)[https://learn.microsoft.com/en-us/power-automate/desktop-flows/alm/alm-connection#create-a-connection-using-your-service-principal]. Depending on required authentication parameters of a given connector, the connection parameters can vary. Due to how connection parameters and served by the platform, not all values are retrieved. If you don't want the connection to requried in-place-update all the time, consider using `ignore_changes` in the resource block.
+
+### Read-Only
+
+- `id` (String) Unique connection id
+- `status` (Set of String) List of connection statuses

docs/resources/connection_share.md

@@ -0,0 +1,93 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "powerplatform_connection_share Resource - powerplatform"
+subcategory: ""
+description: |-
+  
+---
+
+# powerplatform_connection_share (Resource)
+
+
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    powerplatform = {
+      source = "microsoft/power-platform"
+    }
+  }
+}
+
+provider "powerplatform" {
+  use_cli = true
+}
+
+
+resource "powerplatform_connection" "new_sql_connection" {
+  environment_id = var.environment_id
+  name           = "shared_sql"
+  display_name   = "My SQL Connection"
+  connection_parameters_set = jsonencode({
+    "name" : "oauthSP",
+    "values" : {
+      "token" : {
+        "value" : "https://global.consent.azure-apim.net/redirect/sql"
+      },
+      "token:TenantId" : {
+        "value" : "${var.tenant_id}"
+      },
+      "token:clientId" : {
+        "value" : "${var.client_id}"
+      },
+      "token:clientSecret" : {
+        "value" : "${var.client_secret}"
+      }
+    }
+  })
+
+  lifecycle {
+    ignore_changes = [
+      connection_parameters_set
+    ]
+  }
+}
+
+resource "powerplatform_connection_share" "share_with_admin" {
+  environment_id = var.environment_id
+  connector_name = powerplatform_connection.new_sql_connection.name
+  connection_id  = powerplatform_connection.new_sql_connection.id
+  role_name      = "CanEdit"
+  principal = {
+    entra_object_id = var.user_object_id
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `connection_id` (String) Unique identifier of the connection
+- `connector_name` (String) Name of the connector
+- `environment_id` (String) Unique identifier of the environment
+- `principal` (Attributes) Principal to share the connection with (see [below for nested schema](#nestedatt--principal))
+- `role_name` (String) Name of the role to assign to the principal
+
+### Read-Only
+
+- `id` (String) Unique identifier of the connection share
+
+<a id="nestedatt--principal"></a>
+### Nested Schema for `principal`
+
+Required:
+
+- `entra_object_id` (String) Entra Object Id of the principal
+
+Read-Only:
+
+- `display_name` (String) Display name of the principal

examples/data-sources/powerplatform_connection_shares/data-source.tf

@@ -0,0 +1,18 @@
+terraform {
+  required_providers {
+    powerplatform = {
+      source = "microsoft/power-platform"
+    }
+  }
+}
+
+provider "powerplatform" {
+  use_cli = true
+}
+
+data "powerplatform_connection_shares" "all_shares" {
+  environment_id = var.environment_id
+  connector_name = "shared_azureopenai"
+  connection_id  = var.azure_openai_connection_id
+}
+

examples/data-sources/powerplatform_connection_shares/output.tf

@@ -0,0 +1,4 @@
+output "all_shared_connections" {
+  description = "All shares for a given connection and a given environment"
+  value       = data.powerplatform_connection_shares.all_shares
+}

examples/data-sources/powerplatform_connection_shares/variables.tf

@@ -0,0 +1,12 @@
+variable "environment_id" {
+  default     = "00000000-0000-0000-0000-000000000001"
+  description = "Unique identifier of the environment"
+  type        = string
+}
+
+variable "azure_openai_connection_id" {
+  default     = "00000000-0000-0000-0000-000000000002"
+  description = "Unique identifier of the connection"
+  type        = string
+
+}

examples/data-sources/powerplatform_connections/data-source.tf

@@ -0,0 +1,17 @@
+terraform {
+  required_providers {
+    powerplatform = {
+      source = "microsoft/power-platform"
+    }
+  }
+}
+
+provider "powerplatform" {
+  use_cli = true
+}
+
+data "powerplatform_environments" "all_environments" {}
+
+data "powerplatform_connections" "all_connections" {
+  environment_id = data.powerplatform_environments.all_environments.environments[0].id
+}

examples/data-sources/powerplatform_connections/output.tf

@@ -0,0 +1,4 @@
+output "all_connections" {
+  description = "All connections avaiable in Power Platform for a given environment"
+  value       = data.powerplatform_connections.all_connections
+}

examples/resources/powerplatform_connection/outputs.tf

@@ -0,0 +1,6 @@
+
+output "azure_openai_connection" {
+  description = "New Azure Open AI connection"
+  value       = powerplatform_connection.azure_openai_connection
+  sensitive   = true
+}