PushizoDocs
Güvenlik & uyum

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

  1. Organizasyon → Güvenlik ve SSO → SCIM üye sağlama'da bir belirteç oluşturun. Belirteç (scim_…) yalnızca bir kez gösterilir.
  2. 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)
  3. Kullanıcıların e-posta alan adı organizasyonda doğrulanmış olmalıdır; aksi halde oluşturma 400 invalidValue döner.

Desteklenen işlemler

Kaynakİşlemler
/UsersGET (filtre: userName eq "…", externalId eq "…"; startIndex, count), POST, GET /{id}, PUT /{id}, PATCH /{id} (active, name, displayName, externalId), DELETE /{id}
/GroupsGET (filtre: displayName eq "…"), POST, GET/PUT/PATCH/DELETE /{id} (üye ekle/çıkar; Entra ID members[value eq "…"] biçimi)
/ServiceProviderConfig, /ResourceTypes, /SchemasKeş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: false veya DELETE): ü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 (400 mutability).

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.

Bu sayfada