SCIM 2.0 · Okta · Microsoft Entra ID

SCIM hesap yönetimi

Temsor kullanıcılarını kimlik sağlayıcınız açsın, güncellesin ve kapatsın. Biri ayrıldığında, kimlik sağlayıcınız onu devre dışı bıraktığı anda Temsor erişimi biter — kimsenin elle silmeyi hatırlaması gerekmez.

Başlamadan önce

1. Temsor çalışma alanının sahibi ya da yöneticisisiniz.
2. Şirket e-posta alan adınız Temsor » Güvenlik » Tek oturum açma bölümünde doğrulanmış. Temsor yalnız e-posta adresi doğrulanmış alan adında olan kişileri açar.
3. Temsor » Güvenlik » SCIM hesap yönetimi bölümünde Belirteç oluştur’u seçin. 15 dakikadan önce giriş yaptıysanız Temsor önce yeniden giriş ister. Belirteci hemen kopyalayın — tscim_ ile başlar ve yalnız bir kez gösterilir.
4. Aynı karttaki SCIM temel adresini elinizin altında tutun: https://tr.temsor.com/scim/v2. Türkiye bölgesindeki çalışma alanları yalnız bu adresi kullanır; kullanıcı verisi Türkiye’den çıkmaz.

Okta

1. Okta Admin Console’da Applications » Applications » Create App Integration yolunu izleyin, SWA – Secure Web Authentication’ı seçin ve uygulamaya Temsor adını verin (giriş adresi https://tr.temsor.com/). Okta’da zaten bir Temsor uygulamanız varsa onu açın.
2. General sekmesinde App Settings altındaki Edit’i seçin, Provisioning’i SCIM yapın ve kaydedin.
3. Provisioning » Integration’da Edit’i seçin ve şunları girin: SCIM connector base URL https://tr.temsor.com/scim/v2; Unique identifier field for users userName; Supported provisioning actions Push New Users ve Push Profile Updates (Push Groups’u yalnız rolleri gruplarla yönetiyorsanız açın — bkz. Kimlik sağlayıcı gruplarından roller; Import Groups kapalı kalsın); Authentication Mode HTTP Header, belirteç Bearer token olarak yapıştırılır.
4. Test Connector Configuration’ı, ardından Save’i seçin.
5. Provisioning » To App’te Edit’i seçin ve Create Users, Update User Attributes ve Deactivate Users’ı açın.
6. Assignments sekmesinde Temsor’u kullanacak kişileri ya da grupları atayın. Okta onları hemen açar.

Okta, Okta kullanıcı adını userName olarak gönderir. Bu, kişinin doğrulanmış alan adınızdaki iş e-posta adresi olmalıdır.

Microsoft Entra ID

1. Microsoft Entra yönetim merkezinde Enterprise apps » New application » Create your own application yolunu izleyin, Temsor yazın, Integrate any other application you don’t find in the gallery (Non-gallery) seçeneğini seçin ve oluşturun.
2. Provisioning’i açın, Get started’ı (ya da New configuration’ı) seçin ve Provisioning Mode’u Automatic yapın.
3. Admin Credentials altında Tenant URL olarak https://tr.temsor.com/scim/v2 girin ve belirteci Secret Token olarak yapıştırın. Test Connection’ı, ardından Save’i seçin.
4. Mappings altında Provision Microsoft Entra ID Groups’u No yapın (rolleri gruplarla yönetiyorsanız Yes — bkz. Kimlik sağlayıcı gruplarından roller). Kullanıcı eşlemesinde userName ← userPrincipalName kalsın (UPN’leriniz e-posta adresi değilse mail kullanın) ve externalId ← objectId eşleyin. active’i Entra’nın eşlediği gibi bırakın.
5. Settings altında Scope’u Sync only assigned users and groups’ta bırakın, Provisioning Status’u On yapın ve kaydedin.
6. Users and groups altında Temsor’u kullanacak kişileri ya da grupları atayın. Entra yaklaşık 40 dakikada bir eşitleme turu çalıştırır; bir kişiyi hemen göndermek için Provision on demand’i kullanın.

Kimlik sağlayıcı gruplarından roller

Temsor’da her rol için bir tane olmak üzere dört sabit grup vardır: Temsor Admins, Temsor Developers, Temsor Billing ve Temsor Viewers. Tam bu adlarla grup gönderin; Temsor her kişinin rolünü gruplarından belirler. Gruplar isteğe bağlıdır — hiç göndermezseniz rolleri Temsor » Ekip’ten yönetin.

Grup göndermeden önce SCIM belirtecini oluşturan yöneticiyi Temsor Admins grubuna koyun. Bir grup gönderimi bu kişiye başka bir rol verirse Temsor belirtecini iptal eder ve bir yönetici yenisini oluşturana kadar hesap yönetimi 401 ile durur.

• Okta: Provisioning » Integration’da Edit’i seçin, Push Groups’u da açın ve kaydedin. Okta gruplarını tam yukarıdaki gibi adlandırın ve Assignments sekmesinde atayın. Ardından Push Groups sekmesinde Push Groups » Find groups by name’i seçin, grubu seçip kaydedin — Okta onu aynı adlı Temsor grubuna bağlar.
• Microsoft Entra ID: Mappings altında Provision Microsoft Entra ID Groups’u Yes yapın ve varsayılan grup eşlemesini koruyun (displayName ← displayName, members ← members, displayName ile eşleşir). Güvenlik gruplarını tam yukarıdaki gibi adlandırın ve Users and groups altında atayın — üyeleri de açılır.

• Birden fazla grup: en yetkili olan geçerlidir — önce Admins, sonra Developers, sonra Billing, sonra Viewers.
• Son Temsor grubundan çıkarılan kişi Viewer olarak etkin kalır. Erişimi kaldırmak için atamasını kaldırın ya da devre dışı bırakın.
• Çalışma alanınız grup kullanmaya başlayınca yeni kişiler, bir grup rol verene kadar Viewer olarak başlar. Kapatılıp geri gelen kişi de yeniden Viewer olarak başlar.
• Doğruluk kaynağı kimlik sağlayıcınızdır. Temsor » Ekip’te değiştirilen bir rol, kimlik sağlayıcınız o kişi için bir sonraki grup değişikliğini gönderdiğinde üzerine yazılır.
• Çalışma alanı sahibinin rolü gruplarla hiç değişmez. Üyelikleri kaydedilir; sahiplik devredildikten sonra önceki sahip gruplarının rolünü alır.
• Gruplar Temsor’da oluşturulamaz ya da yeniden adlandırılamaz. Başka bir ad göndermek 400 ile başarısız olur. Kimlik sağlayıcınızda bir grubu silmek herkesi ondan çıkarır; Temsor grubunun kendisi kalır.

Temsor her değişiklikte ne yapar

• Yeni kullanıcı: çalışma alanınıza Developer rolüyle, çalışma alanınız rolleri gruplarla yönetiyorsa Viewer olarak katılır. Rolleri Temsor » Ekip’ten ya da gruplarla değiştirin.
• Zaten üye: kişi çalışma alanınızda zaten varsa Temsor yeni hesap açmak yerine mevcut hesabı bağlar.
• Kimlik sağlayıcınızda devre dışı ya da ataması kaldırılmış (active = false): hesap askıya alınır, kişinin tüm Temsor oturumları — portal ve IVR Studio — hemen biter ve yeniden giriş yapamaz. Yeniden etkinleştirmek önceki erişimini geri verir.
• Silinmiş: kişi askıya alınır ve SCIM sonuçlarından kaybolur. Arama geçmişi, faturalar ve denetim kaydı korunur.
• Çalışma alanı sahibi SCIM ile devre dışı bırakılamaz ya da silinemez. Önce Temsor’da sahipliği devredin.
• E-posta adresi (userName) değişemez. Birini yeni bir adrese taşımak için eskisini kapatıp yenisini açın.
• API anahtarları kişiye değil çalışma alanına aittir. Birini askıya almak oluşturduğu anahtarları iptal etmez — gerekirse onları Temsor » Anahtarlar’dan iptal edin.

Başvuru

• Temel adres https://tr.temsor.com/scim/v2 · başlık Authorization: Bearer tscim_… · içerik türü application/scim+json.
• GET ve POST /Users; GET, PUT, PATCH ve DELETE /Users/{id}; GET ve POST /Groups; GET, PUT, PATCH ve DELETE /Groups/{id}; GET /ServiceProviderConfig, /ResourceTypes ve /Schemas.
• Süzgeçler: userName eq "…", externalId eq "…" ve id eq "…". Sayfalama startIndex ve count ile, sayfa başına en çok 200.
• Temsor userName, externalId, displayName, name.givenName, name.familyName ve active alanlarını okur. Kurumsal uzantılar dahil diğer alanlar yok sayılır.
• Gruplar: kimlikler role-admin, role-developer, role-billing ve role-viewer; süzgeçler displayName eq "…" ve id eq "…"; üye listelerini atlamak için excludedAttributes=members ekleyin; istek başına en çok 1000 üye. PATCH, Okta members[value eq "…"] çıkarmalarını ve Entra Add/Remove işlemlerini kabul eder.
• Desteklenmez: grup oluşturma ya da yeniden adlandırma, iç içe gruplar, toplu işlemler, sıralama, ETag’ler ve parola değişikliği.
• Çalışma alanı başına bir belirteç. Yeni belirteç oluşturmak eskisini hemen iptal eder. İptal hesap yönetimini durdurur; mevcut kullanıcıların erişimi sürer.

Sorun giderme

• 401 Missing or invalid SCIM bearer token — belirteç iptal edilmiş ya da değiştirilmiş. Yenisini oluşturup kimlik sağlayıcınıza yapıştırın.
• 400 This e-mail’s domain isn’t verified for this workspace — alan adını Temsor » Güvenlik » Tek oturum açma’da doğrulayın, sonra yeniden deneyin.
• 409 This e-mail already belongs to another Temsor workspace — kişinin kendi çalışma alanı var. Ondan ayrılmasını ya da onu silmesini isteyin, sonra yeniden deneyin.
• 400 The workspace owner can’t be deprovisioned — önce sahipliği devredin ya da sahibi atamadan çıkarın.
• 400 Temsor only has fixed role groups — kimlik sağlayıcıdaki grubu Temsor Admins, Temsor Developers, Temsor Billing ya da Temsor Viewers olarak yeniden adlandırıp tekrar gönderin.
• 401 bir grup gönderiminden hemen sonra — belirteci oluşturan yönetici Admin rolünü kaybetti. Onu Temsor Admins’e ekleyin ve yeni belirteç oluşturun.

Temsor, SCIM 2.0 User ve Group kaynaklarını (RFC 7643 ve RFC 7644) uygular.