Kuruluşlar, SSO ve SCIM

Bona Fide’daki her şey bir kuruluşa (bir çalışma alanına) aittir: şablonlar, zarflar, imzalama bağlantıları, webhook uç noktaları, API anahtarları ve plan. Her kayıt kişisel bir kuruluş alır ve kişiler birden fazla kuruluşun üyesi olabilir. API anahtarları, kendilerine sahip olan tek kuruluş adına işlem yapar.

Panel oturumları üyenin etkin kuruluşu üzerinde işlem yapar; API’yi bir oturum çereziyle çağıran bir entegrasyon, x-organization-id başlığıyla kullanıcının kuruluşlarından başka birini seçebilir.

Roller ve izinler

Üyelerin tek bir rolü vardır. Her rol sabit bir izin kümesidir ve her uç nokta bir izni kontrol eder:

Rol	İzinler
`owner`	Her şey
`admin`	`billing:manage` dışında her şey
`sender`	`envelope:read`, `envelope:send`, `envelope:void`, `template:read`
`template_manager`	`template:read`, `template:write`, `template:publish`, `envelope:read`
`auditor`	`envelope:read`, `template:read`, `audit:read`
`billing`	`billing:manage`

İzinlerin tam listesi şöyledir: envelope:read, envelope:send, envelope:void, template:read, template:write, template:publish, org:manage, member:manage, sso:manage, apikey:manage, billing:manage ve audit:read. API anahtarları bunların bir alt kümesini kapsam olarak taşır.

Üyeler, davetler, ekipler ve kuruluş markası panelde yönetilir. Kuruluş logoları bir panel oturumundan POST /v1/organization/logo ile yüklenir (PNG, JPEG, SVG veya WebP, en fazla 512 KB).

Çoklu oturum açma

Sahipler ve yöneticiler kimlik sağlayıcılarını Ayarlar › Güvenlik › SSO bölümünden SAML 2.0 veya OIDC ile kendileri bağlar:

Bağlantıyı IdP’nizin meta verileriyle kaydedin (panel bir SAML meta veri URL’sini sizin için getirebilir).
E-posta alan adınızı bir DNS TXT kaydıyla doğrulayın (belirteç bona-fide-verify ile başlar).
Ayarları seçin: tam zamanında hazırlama (ilk IdP girişi üyeyi oluşturur), yeni üyelerin varsayılan rolü ve zorunlu kılma: doğrulanmış alan adında e-postası olan üyeler IdP üzerinden giriş yapmalıdır; sahipler acil durum girişini korur.
Zorunlu kılmadan önce bağlantı sayfasından bir test girişi yapın.

Bağlantı durumu (son giriş, son 30 gündeki girişler, sertifika son geçerlilik tarihi) ve her SSO ve SCIM değişikliğinin denetim kaydı (GET /v1/sso/audit) aynı sayfalarda gösterilir.

Giriş sayfası, bir adresin şirket SSO’su kullanıp kullanmadığını GET /v1/sso/discover?email=… ile sorar; bu uç nokta herkese açıktır ve hız limitine tabidir. SSO zorunlu kılındığında o alan adı için parola, e-posta kodu ve sihirli bağlantı ile giriş reddedilir.

SCIM dizin eşitlemesi

SCIM 2.0 ile IdP’niz üyeleri otomatik olarak oluşturur, günceller ve devre dışı bırakır. Ayarlar › Güvenlik › SCIM bölümünde bir bearer belirteci oluşturun (bir kez gösterilir) ve IdP’nize SCIM temel URL’sini ve belirteci verin. Temel URL https://api.bonafidesign.com/api/auth/scim/v2 adresidir. Yeni bir belirteç oluşturmak öncekinin yerini alır; belirteci iptal etmek hazırlamayı durdurur.