SCIM 2.0 ile üye sağlama
Kimlik sağlayıcınız (Okta, Microsoft Entra ID, OneLogin, JumpCloud…) Pushizo üyelerini SCIM 2.0 ile otomatik ekler, rollerini günceller ve ayrılanları kaldırır. SCIM Enterprise planındadır ve SSO ile birlikte kullanılır…
Kimlik sağlayıcınız (Okta, Microsoft Entra ID, OneLogin, JumpCloud…) Pushizo üyelerini SCIM 2.0 ile otomatik ekler, rollerini günceller ve ayrılanları kaldırır. SCIM Enterprise planındadır ve SSO ile birlikte kullanılır (SSO rehberi, docs/adr/0023-kurumsal-kimlik-sso-scim-jwt.md §8).
Kurulum
- Organizasyon → Güvenlik ve SSO → SCIM üye sağlama'da bir belirteç oluşturun. Belirteç (
scim_…) yalnızca bir kez gösterilir. - IdP'nin SCIM ayarlarına girin:
- SCIM taban URL:
https://<API>/scim/v2 - Kimlik doğrulama: HTTP Header / Bearer token → oluşturduğunuz belirteç
- Benzersiz tanımlayıcı:
userName(e-posta)
- SCIM taban URL:
- Kullanıcıların e-posta alan adı organizasyonda doğrulanmış olmalıdır; aksi halde oluşturma 400
invalidValuedöner.
Desteklenen işlemler
| Kaynak | İşlemler |
|---|---|
/Users | GET (filtre: userName eq "…", externalId eq "…"; startIndex, count), POST, GET /{id}, PUT /{id}, PATCH /{id} (active, name, displayName, externalId), DELETE /{id} |
/Groups | GET (filtre: displayName eq "…"), POST, GET/PUT/PATCH/DELETE /{id} (üye ekle/çıkar; Entra ID members[value eq "…"] biçimi) |
/ServiceProviderConfig, /ResourceTypes, /Schemas | Keşif |
Yanıtlar application/scim+json, hatalar RFC 7644 hata şemasıyla döner.
Davranış
- Oluşturma: hesap yoksa parolasız açılır (giriş SSO ile), üyelik ilk SSO bağlantısının varsayılan rolüyle eklenir. Üye kotası ve plan rol kapısı uygulanır.
- Devre dışı bırakma / silme (
active: falseveyaDELETE): üyelik kaldırılır, kullanıcının bu organizasyon için açılmış oturumları kapanır. Organizasyon sahibi SCIM ile kaldırılamaz. - Gruplar → rol: grup adı, SSO bağlantısındaki grup → rol eşlemesinde varsa üyelerine o rol verilir; birden çok grupta en yetkili rol uygulanır. Eşlemesi olmayan gruplar rolü değiştirmez.
userName(e-posta) değiştirilemez: hesaplar organizasyonlar arası ortaktır (400mutability).
Güvenlik
Belirteçler yalnızca SHA-256 özetiyle saklanır, panelden iptal edilir ve son kullanım zamanı gösterilir. Bir belirteç yalnızca kendi organizasyonunun üyelerini görür ve değiştirir.
Kurumsal SSO (SAML 2.0 / OpenID Connect)
Pushizo paneline girişi kimlik sağlayıcınıza (Okta, Microsoft Entra ID, Google Workspace, Keycloak, OneLogin…) bağlayın. SSO Enterprise planındadır. Kararlar: ADR-0023.
Bot koruması (Cloudflare Turnstile)
Kayıt, parola sıfırlama ve doğrulama e-postası yeniden gönderimini Cloudflare Turnstile ile koruma — ortam değişkenleri, dashboard davranışı, API hataları, CSP ve devre dışı durum.