Microsoft Entra ID Kurulumu

Planlanıyor: SAML 2.0 ve SCIM henüz ajan'da yok. Bugün e-posta / parola ve platformda açıksa Google, Microsoft veya LinkedIn hesabıyla giriş desteklenir. Kurumsal SSO ihtiyacınız için bizimle iletişime geçin.

SCIM kullanarak kullanıcıları Entra ID'den ajan'a sağlayın.

Genel Bakış

Bu kılavuz, Microsoft Entra ID ile SCIM kullanıcı sağlama yapılandırmasını adım adım anlatır. Mevcut Enterprise uygulamanızı ajan'ın SCIM uç noktasına bağlar ve otomatik kullanıcı senkronizasyonunu yapılandırırsınız.

Tamamlandığında Entra ID'deki kullanıcı değişiklikleri otomatik olarak ajan'a senkronize edilir.

Kurulum Kontrol Listesi

Kurulum kontrol listesinden şu adımları tamamladığınızı doğrulayın:

* ajan çalışma alanınız için SAML zaten yapılandırılmış * SAML için kurulmuş mevcut bir Enterprise uygulaması (bkz. Microsoft Entra ID SAML Kurulumu) * Enterprise uygulamalarını yönetme yetkisi olan bir Entra ID hesabı

Bağlantıyı Yapılandırma

1\. Navigate to the Enterprise application that you set up for the SAML connection in your Azure Portal (as described in /docs/settings/security/entra).

Click on "Get started" under "Provision User Accounts".

2\. Click "Connect your application"

3\. Go over to your ajan security settings and copy the "SCIM Base URL" value.

4\. Back in your Azure Portal, enter the SCIM Base URL into the "Tenant URL" field and (!) append ?aadOptscim062020 to the end of the URL to fix known issues in Microsoft's implementation of the SCIM protocol.

Your final "Tenant URL" will look like this: https://app.ajan.com/api/scim/v2?aadOptscim062020

5\. Copy the "SCIM Bearer Token (API Key)" value from your ajan security settings...

6\. ...and paste it into the "Secret token" field in your Azure Portal.

7\. Toggle "SCIM User Sync Active" to enable SCIM for your workspace in your ajan security settings. This is required to test the connection.

8\. Back in your Azure Portal click on "Test connection" and you should see a message confirming that the connection between Entra ID and ajan is working.

9\. Click "Create" to finish the configuration

İsteğe bağlı: Target Object Actions yapılandırma

Öznitelik eşlemesinde Target Object Actions öğesini açıp kapatarak Entra ID'nin ajan çalışma alanınızda hangi SCIM işlemlerini gerçekleştireceğini kontrol edebilirsiniz. Her eylem farklı bir sağlama isteği türünü kontrol eder:

Sağlama modelinize uyacak şekilde bu eylemleri birleştirebilirsiniz. Örneğin yalnızca Delete açarsanız:

• Yeni kullanıcılar ajan'da oluşturulmaz ve başka yolla eklenmelidir
• Ad, e-posta ve üyelik geri yükleme ajan'a senkronize edilmez
• Atanmamış veya devre dışı kullanıcılar Entra ID onları kalıcı silene kadar ajan'da kalır

Bu ayarları değiştirmek için "Manage" > "Provisioning" > "Mappings" yoluna gidin, kullanıcı eşlemesini seçin ve Target Object Actions onay kutularını ayarlayın.

İsteğe bağlı: Grup senkronizasyonunu kapatma

10\. (Optional) To customize your provisioning settings, go to "Manage" > "Provisioning". You might need this if you want to only synchronize users (but not groups) or if you want to disable one or more types of object actions (create, update or delete).

E.g. to disable synchronizing groups, click on "Mappings" and follow the optional steps below

11\. (Optional: Disabling group synchronization) Click "Provision Microsoft Entra ID Groups"

12\. (Optional: Disabling group synchronization) Click "No"

13\. (Optional: Disabling group synchronization) Click "Save" then "Yes" to confirm changes

Sağlamayı etkinleştirme

14\. Recommended: Open down "Settings", click "Send an email notification when a failure occurs" and enter your email address

15\. Click "On" to set provisioning status to enabled

16\. Click on "Save" to finalize your changes

Kurulumunuzu doğrulama

17\. To verify that the provisioning is working as expected, go to "Monitor" > "Provisioning logs" and check if your users have been successfully mapped to ajan.

In case you don't see any logs, make sure to wait and check back in a couple of minutes. It can take a bit until the first synchronization is triggered.

If your setup was successful, you will see "Success" values in the status column.

18\. You should also see the newly synchronized users in your ajan member settings.

Kullanıcı E-posta Adreslerini Güncelleme (Alan Değişiklikleri)

Kuruluşunuz e-posta alanlarını değiştirirse (ör. @old-company.de → @new-company.de), Entra ID'de güncellediğinizde SCIM kullanıcı e-posta adreslerini ajan'da otomatik güncelleyebilir. Ancak e-posta değişikliğinden önce yeni alanın ajan'da yapılandırılmış olması gerekir.

Entra'da kullanıcı e-postalarını ajan'da eklenmemiş ve doğrulanmamış bir alana değiştirirseniz SCIM senkronizasyonu bu kullanıcılar için başarısız olur.

Gereksinimler

Entra ID'de kullanıcı e-posta adreslerini güncellemeden önce:

1. The new email domain must be added to the allowed domains in your ajan security settings
2. The new domain must be verified (domain verification ensures you own the domain)

Süreç

Yeni alanı ajan çalışma alanınıza ekleyin

Go to your ajan security settings and add the new domain (e.g., new-company.de) to the list of allowed domains.

Yeni alanı doğrulayın

Add the new domain to the allowed domains in your workspace and then verify it by contacting the ajan Support.

Entra ID'de kullanıcı e-postalarını güncelleyin

Once the domain is added and verified in ajan, you can update the user email addresses in Microsoft Entra ID. The SCIM provisioning will automatically sync these changes to ajan.

Senkronizasyonu doğrulayın

Check the provisioning logs in Entra ID (Monitor > Provisioning logs) to confirm the email updates were successful. You can also verify in your ajan member settings that the user emails have been updated.

SCIM ile e-posta adreslerini güncellerken mevcut kullanıcı verileri (sohbet geçmişi, temsilciler vb.) korunur. Kullanıcılar e-posta adresleriyle değil SCIM ID'leriyle tanımlanır.