{"id":43231274,"url":"https://github.com/poweradmin/terraform-provider-poweradmin","last_synced_at":"2026-04-02T13:02:47.313Z","repository":{"id":322323615,"uuid":"1083579696","full_name":"poweradmin/terraform-provider-poweradmin","owner":"poweradmin","description":"Terraform Poweradmin provider","archived":false,"fork":false,"pushed_at":"2026-03-22T17:50:13.000Z","size":270,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-23T08:25:16.224Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/poweradmin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-26T10:13:52.000Z","updated_at":"2026-03-22T17:50:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/poweradmin/terraform-provider-poweradmin","commit_stats":null,"previous_names":["poweradmin/terraform-provider-poweradmin"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/poweradmin/terraform-provider-poweradmin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poweradmin%2Fterraform-provider-poweradmin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poweradmin%2Fterraform-provider-poweradmin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poweradmin%2Fterraform-provider-poweradmin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poweradmin%2Fterraform-provider-poweradmin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/poweradmin","download_url":"https://codeload.github.com/poweradmin/terraform-provider-poweradmin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poweradmin%2Fterraform-provider-poweradmin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31306712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-01T10:06:59.203Z","updated_at":"2026-04-02T13:02:47.298Z","avatar_url":"https://github.com/poweradmin.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terraform Provider for Poweradmin\n\nManage DNS zones, records, RRSets, users, and groups in [Poweradmin](https://www.poweradmin.org/) using Terraform or OpenTofu.\n\n## Features\n\n- **Zone Management**: Create, update, and delete DNS zones (MASTER, SLAVE, NATIVE types)\n- **Record Management**: Full CRUD for all DNS record types (A, AAAA, CNAME, MX, TXT, SRV, NS, PTR, CAA, and more)\n- **RRSet Management**: Manage multiple records with same name/type as a single atomic unit\n- **User Management**: Create and manage Poweradmin users with permission templates\n- **Group Management**: Organize users into groups with zone access control (Poweradmin 4.2.0+)\n- **Data Sources**: Query zones, records, RRSets, permissions, and groups\n- **Dual Authentication**: API key or HTTP basic authentication\n- **OpenTofu Compatible**: Works with both Terraform and OpenTofu\n\n## Version Compatibility\n\n| Provider Version | Poweradmin Version | Terraform | OpenTofu | Go (dev) |\n|---|---|---|---|---|\n| 0.4.0 | 4.3.0+ (wrapped API responses) | \u003e= 1.5 | \u003e= 1.6 | \u003e= 1.26 |\n| 0.3.0 | 4.2.0+ (groups), 4.1.0+ (core) | \u003e= 1.5 | \u003e= 1.6 | \u003e= 1.26 |\n| 0.2.0 | 4.1.0+ | \u003e= 1.0 | \u003e= 1.6 | \u003e= 1.25 |\n| 0.1.x | 4.1.0+ | \u003e= 1.0 | \u003e= 1.6 | \u003e= 1.24 |\n\n## Quick Start\n\n### Installation\n\n```hcl\nterraform {\n  required_providers {\n    poweradmin = {\n      source  = \"poweradmin/poweradmin\"\n      version = \"~\u003e 0.3\"\n    }\n  }\n}\n\nprovider \"poweradmin\" {\n  api_url = \"https://dns.example.com\"\n  api_key = var.poweradmin_api_key\n}\n```\n\nThe provider is available on both the [Terraform Registry](https://registry.terraform.io/providers/poweradmin/poweradmin) and the [OpenTofu Registry](https://search.opentofu.org/provider/poweradmin/poweradmin).\n\n### Minimal Example\n\n```hcl\n# Create a zone and add a record\nresource \"poweradmin_zone\" \"example\" {\n  name = \"example.com\"\n  type = \"MASTER\"\n}\n\nresource \"poweradmin_record\" \"www\" {\n  zone_id = poweradmin_zone.example.id\n  name    = \"www\"\n  type    = \"A\"\n  content = \"192.0.2.100\"\n  ttl     = 3600\n}\n```\n\n## Guides\n\nDetailed guides with examples for each feature area:\n\n- **[Zone Management](examples/guides/zone-management.md)** - Master/Slave/Native zones, templates, accounts, imports\n- **[Record Management](examples/guides/record-management.md)** - All DNS record types, priorities, TTLs, disabled records\n- **[RRSet Management](examples/guides/rrset-management.md)** - Atomic multi-record sets, load balancing, partial disabling\n- **[User Management](examples/guides/user-management.md)** - Users, permissions, LDAP, deactivation\n- **[Group Management](examples/guides/group-management.md)** - Groups, memberships, zone assignments, MFA enforcement (4.2.0+)\n- **[Data Sources](examples/guides/data-sources.md)** - Querying zones, records, RRSets, permissions, groups\n\n## Resources and Data Sources\n\n### Resources\n\n| Resource | Description | Min Poweradmin |\n|----------|-------------|----------------|\n| `poweradmin_zone` | DNS zones (MASTER, SLAVE, NATIVE) | 4.1.0 |\n| `poweradmin_record` | Individual DNS records | 4.1.0 |\n| `poweradmin_rrset` | Resource Record Sets (atomic multi-record) | 4.1.0 |\n| `poweradmin_user` | Users with permission templates | 4.1.0 |\n| `poweradmin_group` | User groups with MFA enforcement | 4.2.0 |\n| `poweradmin_group_membership` | Group member associations | 4.2.0 |\n| `poweradmin_group_zone_assignment` | Group zone access associations | 4.2.0 |\n\n### Data Sources\n\n| Data Source | Description | Min Poweradmin |\n|-------------|-------------|----------------|\n| `poweradmin_zone` | Look up zone by ID or name | 4.1.0 |\n| `poweradmin_records` | List records with optional type filter | 4.1.0 |\n| `poweradmin_rrsets` | List RRSets with optional type filter | 4.1.0 |\n| `poweradmin_permission` | Look up permission by ID or name | 4.1.0 |\n| `poweradmin_group` | Look up group by ID or name | 4.2.0 |\n\n## Provider Configuration\n\n| Argument | Type | Required | Description |\n|----------|------|----------|-------------|\n| `api_url` | string | Yes | Poweradmin API base URL (e.g., `https://dns.example.com`) |\n| `api_key` | string | No* | API key for authentication (recommended) |\n| `username` | string | No* | Username for HTTP basic authentication |\n| `password` | string | No* | Password for HTTP basic authentication |\n| `api_version` | string | No | API version: only `v2` supported. Defaults to `v2` |\n| `insecure` | bool | No | Skip TLS verification (default: `false`) |\n\n\\* Either `api_key` OR both `username` and `password` must be provided.\n\n### Authentication Methods\n\n```hcl\n# API Key (recommended)\nprovider \"poweradmin\" {\n  api_url = \"https://dns.example.com\"\n  api_key = var.poweradmin_api_key\n}\n\n# Basic Auth\nprovider \"poweradmin\" {\n  api_url  = \"https://dns.example.com\"\n  username = var.poweradmin_username\n  password = var.poweradmin_password\n}\n```\n\n## Poweradmin API Setup\n\nEnable the API in your Poweradmin `config/settings.php`:\n\n```php\n'api' =\u003e [\n    'enabled' =\u003e true,\n    'basic_auth_enabled' =\u003e true,  // Optional: for basic auth\n]\n```\n\nTo create an API key: log in as admin, navigate to API Keys, create a new key, and store it securely:\n\n```bash\nexport TF_VAR_poweradmin_api_key=\"your-api-key-here\"\n```\n\n## Development\n\nSee [DEVELOPMENT.md](DEVELOPMENT.md) for the full development guide and release process.\n\n```bash\nmake build       # Build provider\nmake test        # Unit tests\nmake testacc     # Acceptance tests (requires API credentials)\nmake generate    # Generate docs\nmake lint        # Run linter\n```\n\n## Documentation\n\n- [Provider Documentation](docs/index.md) (auto-generated schema reference)\n- [Poweradmin Documentation](https://docs.poweradmin.org/)\n- [Poweradmin API Documentation](https://docs.poweradmin.org/configuration/api/)\n- [Poweradmin GitHub](https://github.com/poweradmin/poweradmin)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and code style guidelines.\n\n## License\n\nMPL-2.0 - see [LICENSE](LICENSE).\n\n## Support\n\n- [GitHub Issues](https://github.com/poweradmin/terraform-provider-poweradmin/issues)\n\n## Sponsors\n\n\u003ca href=\"https://www.stepping-stone.ch/\"\u003e\n  \u003cimg src=\".github/stepping_stone_logo.svg\" alt=\"stepping stone AG\" height=\"60\"\u003e\n\u003c/a\u003e\n\nWe thank [stepping stone AG](https://www.stepping-stone.ch/) for their support of this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpoweradmin%2Fterraform-provider-poweradmin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpoweradmin%2Fterraform-provider-poweradmin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpoweradmin%2Fterraform-provider-poweradmin/lists"}