# netskopeoss/terraform-provider-netskope architecture

> Architecture diagram of the GitHub repository netskopeoss/terraform-provider-netskope, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/netskopeoss/terraform-provider-netskope
- Repository: https://github.com/netskopeoss/terraform-provider-netskope

## Overview

Netskope Terraform Provider lets users declare Netskope infrastructure in Terraform, then create, refresh, update, delete, or query tenant resources through the provider and its API client. The tree and README show broad resource families, including AI Gateway, private access, device classification, RBAC, and network profiles. The service-object excerpts expose one concrete path from Terraform resource handling into SDK operations; most other resource implementations and provider registration were not sampled, so their internal links are left unverified rather than inferred.

Main entry points: [`internal/provider`](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider) (Provider resources), [`internal/sdk/serviceobject.go`](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/sdk/serviceobject.go) (Service object SDK), [`internal/provider/serviceobject_resource.go`](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobject_resource.go) (Service object resource), [`main.go`](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/main.go) (Provider server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Provider entry"]
  node_provider_server["Provider server<br/>[main.go]"]
end

subgraph group_terraform["Terraform resources"]
  node_resource_catalog["Provider resources"]
  node_service_object["Service object resource"]
  node_service_object_read["Service object lookup"]
  node_service_object_list["Service object listing"]
  node_plan_modifiers["Plan modifiers"]
end

subgraph group_security["Access and security"]
  node_npa["Private access"]
  node_device_class["Device classification"]
  node_rbac["RBAC management"]
end

subgraph group_network["Network and profiles"]
  node_ai_gateway["AI Gateway"]
  node_network_profiles["Network profiles"]
  node_other_catalogs["Other catalogs"]
end

subgraph group_sdk["API client"]
  node_service_sdk["Service object SDK<br/>[serviceobject.go]"]
  node_query_serialization["Query serialization<br/>[queryparams.go]"]
  node_service_operations["Service object operations"]
end

node_terraform_user(("Terraform user"))
node_netskope_api{{"Netskope API"}}

node_terraform_user -->|"starts provider"| node_provider_server
node_provider_server -.->|"serves resources"| node_resource_catalog
node_terraform_user -.->|"declares or queries"| node_resource_catalog
node_resource_catalog -.->|"includes"| node_npa
node_resource_catalog -.->|"includes"| node_device_class
node_resource_catalog -.->|"includes"| node_rbac
node_resource_catalog -.->|"includes"| node_ai_gateway
node_resource_catalog -.->|"includes"| node_network_profiles
node_resource_catalog -.->|"includes"| node_other_catalogs
node_service_object -->|"calls CRUD"| node_service_sdk
node_service_object_read -->|"fetches object"| node_service_sdk
node_service_object_list -->|"lists objects"| node_service_sdk
node_service_sdk -->|"uses operations"| node_service_operations
node_service_sdk -.->|"sends requests"| node_netskope_api
node_service_sdk -.->|"serializes queries"| node_query_serialization
node_service_object -.->|"applies planning"| node_plan_modifiers
node_npa -.->|"manages tenant data"| node_netskope_api
node_device_class -.->|"manages tenant data"| node_netskope_api
node_rbac -.->|"manages tenant data"| node_netskope_api
node_ai_gateway -.->|"manages tenant data"| node_netskope_api
node_network_profiles -.->|"manages tenant data"| node_netskope_api

click node_provider_server "https://github.com/netskopeoss/terraform-provider-netskope/blob/main/main.go"
click node_resource_catalog "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_service_object "https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobject_resource.go"
click node_service_object_read "https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobject_data_source.go"
click node_service_object_list "https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobjectlist_data_source.go"
click node_npa "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_device_class "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_rbac "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_ai_gateway "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_network_profiles "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_other_catalogs "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider"
click node_service_sdk "https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/sdk/serviceobject.go"
click node_query_serialization "https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/sdk/internal/utils/queryparams.go"
click node_service_operations "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/sdk/models/operations"
click node_plan_modifiers "https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/planmodifiers"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_provider_server,node_terraform_user toneBlue
class node_resource_catalog,node_service_object,node_service_object_read,node_service_object_list,node_plan_modifiers toneAmber
class node_npa,node_device_class,node_rbac,node_netskope_api toneMint
class node_ai_gateway,node_network_profiles,node_other_catalogs toneRose
class node_service_sdk,node_query_serialization,node_service_operations toneIndigo
```

## Components

### Provider entry

- [Provider server](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/main.go): `main.go`

### Terraform resources

- [Provider resources](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`
- [Service object resource](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobject_resource.go): `internal/provider/serviceobject_resource.go`
- [Service object lookup](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobject_data_source.go): `internal/provider/serviceobject_data_source.go`
- [Service object listing](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/provider/serviceobjectlist_data_source.go): `internal/provider/serviceobjectlist_data_source.go`
- [Plan modifiers](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/planmodifiers): `internal/planmodifiers`

### Access and security

- [Private access](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`
- [Device classification](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`
- [RBAC management](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`

### Network and profiles

- [AI Gateway](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`
- [Network profiles](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`
- [Other catalogs](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/provider): `internal/provider`

### API client

- [Service object SDK](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/sdk/serviceobject.go): `internal/sdk/serviceobject.go`
- [Query serialization](https://github.com/netskopeoss/terraform-provider-netskope/blob/main/internal/sdk/internal/utils/queryparams.go): `internal/sdk/internal/utils/queryparams.go`
- [Service object operations](https://github.com/netskopeoss/terraform-provider-netskope/tree/main/internal/sdk/models/operations): `internal/sdk/models/operations`

### Other components

- **Terraform user**
- **Netskope API**

## Connections

- Terraform user → Provider server: starts provider (evidence: `main.go`)
- Provider server → Provider resources: serves resources (evidence: `main.go`)
- Terraform user → Provider resources: declares or queries (evidence: `README.md`)
- Provider resources → Private access: includes (evidence: `README.md`)
- Provider resources → Device classification: includes (evidence: `README.md`)
- Provider resources → RBAC management: includes (evidence: `README.md`)
- Provider resources → AI Gateway: includes (evidence: `README.md`)
- Provider resources → Network profiles: includes (evidence: `README.md`)
- Provider resources → Other catalogs: includes (evidence: `README.md`)
- Service object resource → Service object SDK: calls CRUD (evidence: `internal/provider/serviceobject_resource.go`)
- Service object lookup → Service object SDK: fetches object (evidence: `internal/provider/serviceobject_data_source.go`)
- Service object listing → Service object SDK: lists objects (evidence: `internal/provider/serviceobjectlist_data_source.go`)
- Service object SDK → Service object operations: uses operations (evidence: `internal/sdk/serviceobject.go`)
- Service object SDK → Netskope API: sends requests
- Service object SDK → Query serialization: serializes queries (evidence: `internal/sdk/internal/utils/queryparams.go`)
- Service object resource → Plan modifiers: applies planning (evidence: `internal/provider/serviceobject_resource.go`)
- Private access → Netskope API: manages tenant data (evidence: `README.md`)
- Device classification → Netskope API: manages tenant data (evidence: `README.md`)
- RBAC management → Netskope API: manages tenant data (evidence: `README.md`)
- AI Gateway → Netskope API: manages tenant data (evidence: `README.md`)
- Network profiles → Netskope API: manages tenant data (evidence: `README.md`)
