keenauth_role

keenauth_role kaynağı, ortamın bir rolünü ve bu role ait tam izin kümesini yönetir. Tek bir kuruluşa ait olan rol ise farklı bir kaynaktır: keenauth_organization_role. keenauth_role veri kaynağı, bir rolü id veya key ile okur.

resource "keenauth_permission" "invoices_read" {
  api_id = "api_01j9zq3v8c5m2x7k4t6r1n0b3d"
  value  = "invoices:read"
}

resource "keenauth_role" "billing" {
  key         = "billing"
  name        = "Billing"
  description = "Invoices and payment methods."

  permission_ids = [keenauth_permission.invoices_read.id]
}

data "keenauth_role" "billing" {
  key = "billing"
}

Yaşam döngüsü

• key ortamda benzersizdir, org_roles talebinde görünür ve değiştirilemez: yeni bir anahtar rolün yerini alır.
• name 1 ile 128 karakter arasında, description en fazla 1024 karakter olabilir. API bu değerleri kırptığı için ikisi de boşlukla başlayamaz veya boşlukla bitemez.
• permission_ids tam kümedir (en fazla 500). Rol alanlarından sonra ayrı bir istekle yazılır; oluşturma sırasında bu istek başarısız olursa rol, işaretlenmiş (tainted) olarak durumda kalır ve bir sonraki uygulamada yeniden oluşturulur. Başka bir yerde eklenen veya kaldırılan bir izin, bir sonraki uygulamada geri alınır.
• is_privileged bir rolü ayrıcalıklı olarak işaretler. Self-service ortamda bunu yalnızca kuruluş yönetici rolüne sahip bir yönetici atayabilir; bu role eşlenen harici bir grubun ise roles:write yetkisine ve bir onaya ihtiyacı vardır. Mevcut bir rolü ayrıcalıklı yapmak, grup eşlemelerini onaylanana kadar onaysız bırakır. Varsayılan değer false'tur; ayrıcalıklı bir rolü içe aktardığınızda is_privileged = true değerini açıkça yazın, aksi halde bir sonraki uygulama rolü ayrıcalıksız hale getirir.
• Güncellemeler ve silmeler, son okunan ETag ile birlikte If-Match gönderir. Plan oluşturulduktan sonra rol değiştiyse API 412 yanıtı verir ve hiçbir şey değişmez; plan komutunu yeniden çalıştırın.
• force_destroy = true ile atanmış bir rol de silinir ve atamaları aynı istekte kaldırılır; aksi halde atanmış bir rolü silmek 409 role_in_use hatasıyla başarısız olur. Bir kuruluşun yönetici veya varsayılan üye rolü olarak kullanılan bir rol hiç silinemez. Yalnızca force_destroy değiştirildiğinde istek gönderilmez.
• Rollerin kullanıcılara ve üyeliklere atamaları kaynak değildir. Bunlar kişisel veridir ve hiçbir zaman durumda (state) tutulmaz; bunları API, CLI veya kontrol paneli ile yönetin.

İçe aktarma

Anahtarla veya kimlikle içe aktarın:

tofu import keenauth_role.billing billing
tofu import keenauth_role.billing rol_01j9zq3v8c5m2x7k4t6r1n0b3d