Implement the tor_family_identity resource

docs/resources/family_identity.md

@@ -0,0 +1,42 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "tor_family_identity Resource - tor"
+subcategory: ""
+description: |-
+  Generates a Tor family identity key as described in proposal 321 (Happy Families).
+---
+
+# tor_family_identity (Resource)
+
+Generates a Tor family identity key as described in proposal 321 (Happy Families).
+
+## Example Usage
+
+```terraform
+resource "tor_family_identity" "example" {
+  family_name = "MyFamily"
+}
+
+# Access the generated family identity
+output "family_id" {
+  value = tor_family_identity.example.id
+}
+
+# Use the secret key to configure your Tor relay
+resource "local_sensitive_file" "family_key" {
+  content_base64 = tor_family_identity.example.secret_key
+  filename       = "MyFamily.secret_family_key"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `family_name` (String) Name of the family
+
+### Read-Only
+
+- `id` (String) Base64-encoded public key (as stored in public_family_id file)
+- `secret_key` (String, Sensitive) Binary contents of the secret family key file (base64 encoded)