İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Microsoft Entra ID SAML Kurulumu

Kullanıcılarınızın Entra ID hesaplarıyla SAML 2.0 üzerinden ajan'a giriş yapmasını sağlayın.

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.

Kullanıcılarınızın Entra ID hesaplarıyla SAML 2.0 üzerinden ajan'a giriş yapmasını sağlayın.

Genel Bakış

Bu kılavuz, Microsoft Entra ID ile SAML single sign-on yapılandırmasını adım adım anlatır. Entra ID'de bir Enterprise uygulaması oluşturur, SAML ayarlarını yapılandırır ve kimlik sağlayıcınız ile ajan arasında güvenli bir bağlantı kurarsınız.

Tamamlandığında kullanıcılarınız Entra ID kimlik bilgileriyle ajan'a giriş yapabilir.

Kurulum Kontrol Listesi

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

* ajan çalışma alanınızda yönetici hesabına erişiminiz var * ajan güvenlik ayarlarında "Join by domain" etkin * Alan adınız ajan güvenlik ayarlarında eklenmiş ve doğrulanmış * Enterprise uygulamaları oluşturup yönetebilen bir Entra ID hesabınız var

Entra ID'de yeni bir Enterprise uygulaması oluşturma

Ardından Entra ID portalınızda yeni bir Enterprise uygulaması oluşturmanız gerekir.

Şu adımları izleyin:

  1. In your Entra ID portal navigate to the Overview page and add a new Enterprise application under "+ Add" → "Enterprise application"
  2. Create a new custom application by clicking on "+ Create your own application"
  3. Name your application (e.g., "ajan")
  4. Select the option "Integrate any other application you don't find in the gallery (Non-gallery)"

SAML Yapılandırması

ajan, SSO kimlik doğrulaması için standart olarak SAML 2.0 kullanır. Uygulamayı oluşturduktan sonra ajan'ın kullanıcıları SAML ile kimlik doğrulayabilmesi için SAML ayarlarını yapılandırmanız gerekir.

First, navigate to the "Single sign-on" settings of your newly created application, by selecting "Set up single sign on" and choosing "SAML" as the single sign-on method.

Next, you need to get the SAML metadata from ajan, which you can find in your Security settings.

Here, you need to copy two values from the SAML metadata:

  1. The "Audience URI (SP Entity ID)" value(ajan.com)
  2. The "Assertion Consumer Service (ACS) URL" value

Now, you can configure the SAML settings in your Entra ID portal, by first clicking "Edit" in the "Basic SAML Configuration" section, and then filling in the following values:

  1. "Identifier (Entity ID)": The "Audience URI (SP Entity ID)" value from ajan
  2. "Reply URL (Assertion Consumer Service URL)": The "Assertion Consumer Service (ACS) URL" value from ajan

You can leave the other fields empty or with their default values. Finally, save the configuration by clicking "Save".

You also need to modify the default SAML Certificate configuration, by clicking "Edit" in the "SAML Certificates" → "Token signing certificate" section and:

  1. Setting the "Signing Option" to "Sign SAML response and assertion"
  2. Setting the "Signing Algorithm" to "SHA-256"

Finally, save the SAML Certificate configuration by clicking "Save".

To finalize the SAML setup, you need to copy the Login URL and the SAML Signing certificate from Entra ID to ajan.

  1. In the "SAML Signing Certificate" section of your Entra ID portal, click on "Download" next to "Certificate (Base64)" link to download the certificate. Copy the entire certificate so that the beginning and end match the example below:
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
  1. Copy the "Login URL" value from the "Set up ajan" section in your Entra ID portal.

In your ajan workspace, navigate to the Security settings again and paste the copied values into the respective fields:

  1. Fill in the "Issuer" field with the Audience URI specified earlier (ajan.com).
  2. Paste the "Login URL" value from Entra ID into the "Sign on URL" field
  3. Paste the SAML Signing certificate content into the "Certificate" field

Finally, to test your SAML setup, you need to activate it by enabling the "SAML Active" toggle.

If you want people outside your verified domains to sign in without Entra ID, turn on Allow External Authentication in SAML settings.

If your organization requires signed requests, you can then turn on Sign SAML requests. In Entra ID, open "Verification certificates" under "SAML Certificates" and click "Edit". Select "Require verification certificates", upload the certificate from Download SP certificate, and click "Save".

Uygulamaya Kullanıcı Atama

Kullanıcılar SAML üzerinden ajan'a giriş yapmadan önce Entra ID'deki Enterprise uygulamasına erişim atanmalıdır.

Varsayılan olarak Entra ID yetkisiz erişimi önlemek için açık kullanıcı ataması ister. Kullanıcılara erişim vermek için şu adımları izleyin:

  1. In your Entra ID portal, navigate to the ajan Enterprise application you created
  2. In the left menu, select "Users and groups"
  3. Click on "+ Add user/group"
  4. Under "Users", click on "None Selected" and search for the users you want to grant access to
  5. Select the users or groups that should have access to ajan
  6. Click "Select" and then "Assign"

En iyi uygulama: Birden fazla kullanıcısı olan kuruluşlar için özel bir Entra ID güvenlik grubu (ör. "ajan Users") oluşturup bu grubu uygulamaya atamanızı öneririz. Ekibiniz büyüdükçe erişimi yönetmek kolaylaşır.

Alternatif: Tüm Kullanıcılara İzin Ver

Kuruluşunuzdaki tüm kullanıcıların açık atama olmadan otomatik olarak ajan'a erişmesine izin vermek istiyorsanız:

  1. In your Entra ID portal, navigate to the ajan Enterprise application
  2. In the left menu, select "Properties"
  3. Set "Assignment required?" to "No"
  4. Click "Save"

Atama gereksinimlerini kapatmak, Entra ID kiracınızdaki herhangi bir kullanıcının ajan'a erişmesine izin verir. Yalnızca kuruluş geneli erişim vermek istiyorsanız kullanın.

SAML kurulumunu test etme

Kurulumu test etmek için geçerli tarayıcı oturumunda oturum açık kalın ve ayrı bir tarayıcı veya gizli pencere açarak https://app.ajan.com adresine gidin.

Entra ID hesabınızdaki bir kullanıcının e-posta adresini girin ve "Continue" düğmesine tıklayın.

Kimlik bilgilerinizi girebileceğiniz Entra ID giriş sayfasına yönlendirilirsiniz.

Başarılı kimlik doğrulamadan sonra ajan'a geri yönlendirilir ve oturum açarsınız.

Tek Çalışma Alanıyla Birden Fazla Entra ID Kiracısı

ajan çalışma alanı başına tek bir kimlik sağlayıcıyla entegre olur; bu yüzden birden fazla Entra kiracısını doğrudan bağlamak desteklenmez.

Önerilen yaklaşım, tüm kimlik doğrulamayı tek bir hub kiracı üzerinden yönlendirmek ve diğer kiracılardaki kullanıcıları otomatik getirmek için Microsoft B2B, kiracılar arası senkronizasyon ve kiracılar arası erişim politikalarını kullanmaktır.

Aynı Entra ID Kiracısıyla Birden Fazla Çalışma Alanı

Birden fazla ajan çalışma alanını aynı Entra ID kiracısına bağlamak istiyorsanız bu mümkündür ancak ajan ekibinin manuel yapılandırmasını gerektirir.

Her ek çalışma alanı için şunları yapmanız gerekir:

  1. Ask the ajan Team at support@ajan.com to create a new Workspace and provide you with the Assertion Consumer Service (ACS) URL.
  2. Create a separate Enterprise application in Entra ID for each workspace you want to connect (following the same steps as above)
  3. Use a unique Identifier (Entity ID) for each app registration. Instead of using ajan.com, use a unique identifier like yourcompany.ajan.com or workspace-name.ajan.com
  4. Enter the Assertion Consumer Service (ACS) URL provided by the ajan Team.
  5. Contact ajan support at support@ajan.com and provide the following information for each additional workspace:
    • The Issuer (your unique Entity ID)
    • The Login URL (Sign-on URL)
    • The Certificate (Base64)
    • All E-Mail domains of users that should be able to join the workspace. More details on that here.

Birden fazla SAML çalışma alanını kendiniz yapılandıramazsınız. ajan ekibinin ek çalışma alanlarını arka uçta manuel yapılandırması gerekir. Bunu yalnızca kurumsal müşterilerimize sunuyoruz. Ayrıca kullanıcıları / sohbetleri / temsilcileri diğer çalışma alanlarına taşıyamayız.

Çalışma Alanı Değiştirme Davranışı

Kullanıcıların aynı alan adıyla birden fazla SAML etkin çalışma alanına erişimi olduğunda:

  • Giriş sırasında e-posta adreslerini girdikten sonra hangi çalışma alanına erişeceklerini seçmek için bir workspace picker görürler
  • SAML kullanıcıları için normal "switch workspace" düğmesi kullanılamaz
  • Çalışma alanları arasında geçiş için kullanıcıların oturumu kapatıp yeniden giriş yapması, ardından seçiciden istenen çalışma alanını seçmesi gerekir

Sorun Giderme

Kurulum sırasında sorun yaşarsanız yardım için support@ajan.com adresine yazın.