Ana içeriğe geç

Tümleşik Hizmetler

Tümleşik Hizmetler, Emakin'in oturum açma, tek oturum açma ve ilgili harici kaynaklara erişim gibi işlevler için kullanabileceği, harici OpenAuth tabanlı hizmetleri tanımlar.

Kimlik Doğrulama → AçıkTümleşik Hizmetler. Kimlik Doğrulama'nın diğer alt sekmesi olan Oturum Açma Hizmetleri, kullanıcıların oturum açmak için bu tümleştirmelerden hangilerini gerçekten kullanabileceğini belirler.

Bu Sayfa Ne Zaman Kullanılır

Şunları yapmanız gerektiğinde bu sayfayı kullanın:

  • Google veya Office 365 gibi bir OpenAuth sağlayıcısını kaydetme
  • istemci kimlik bilgilerini ve geri çağırma davranışını yapılandırma
  • sağlayıcı için kapsamları tanımlama
  • arka plan veya yükseltilmiş erişim için hizmet hesabı kimlik bilgilerini yapılandırma

Ortam Değişkeni Başvuruları

Hassas OpenAuth alanları, sağlayıcı gizli anahtarlarının doğrudan Host Administration'da saklanmasını önlemek için ortam değişkeni yer tutucularını destekler.

Desteklenen gizli alanlar şunlardır:

  • İstemci Gizli Anahtarı
  • Hizmet Hesabı Anahtarı

Örnekler:

1
2
${GOOGLE_CLIENT_SECRET}
${OFFICE365_SERVICE_ACCOUNT_KEY}

Temel Hizmet Tanımı

Her tümleşik hizmet için aşağıdaki ayarlar tanımlanabilir.

Etkin mi?

Hizmetin etkin olup olmadığını denetler. Hizmetin devre dışı bırakılması, oturum açma tümleştirmesi gibi ilişkili bağımlı özellikleri de devre dışı bırakır.

Hizmet Türü

Google, Office 365, Keycloak veya desteklenen başka bir OpenAuth hizmeti gibi sağlayıcı türünü tanımlar.

Ad

Emakin tarafından kullanılan dahili hizmet tanımlayıcısıdır. Son kullanıcıya gösterilecek ad olarak tasarlanmamıştır.

Bağlantıyı Test Et

Yapılandırılan hizmetin oturum açma, e-posta, dosya, takvim veya diğer bağımlı özellikler tarafından kullanılmadan önce doğrulanmasını sağlar.

Temel URL

İsteğe bağlı sağlayıcı uç noktasıdır. Sağlayıcı varsayılan olmayan veya kendi barındırdığınız bir OpenAuth uç noktası gerektirdiğinde kullanın.

İstemci Kimliği

Sağlayıcı tarafından verilen istemci tanımlayıcısıdır.

İstemci Gizli Anahtarı

Sağlayıcı tarafından verilen istemci gizli anahtarıdır.

Kiracı Kimliği

Belirli bir organizasyon kiracısında çalışan sağlayıcıların gerektirdiği isteğe bağlı kiracı veya dizin tanımlayıcısıdır.

Hizmet Geri Çağrısı

Yönlendirme URI'sinin nasıl oluşturulacağını tanımlar.

  • Uygulama Geri Çağrısı: uygulama adı altında genel bir geri çağrı kullanır
  • Alanadı Geri Çağrısı: geri çağrı temel adresi olarak etkin alanadı adresini kullanır

Kapsamlar

Harici hizmetten istenen kapsamları tanımlar.

Hizmet Kimlik Doğrulaması

Varsayılan olarak tümleşik hizmetler şu yöntemlerle kimlik doğrular: Client Id ve Client Secret. Ayrıcalıklı veya gözetimsiz erişim için hizmet hesabı ayarları da yapılandırılabilir.

Hizmet Hesabı Kimliği

Hizmet hesabının tanımlayıcısı.

Hizmet Hesabı Anahtar Türü

Hizmet hesabı anahtarının nasıl sağlanacağını tanımlar:

  • FilePath
  • Base64
  • Json

Hizmet Hesabı Anahtarı

Gerçek anahtar değerini yapılandırılan biçimde saklar.

Mevcut belgelerde bu ayar için tam bir JSON örneği bulunur. Bu örnek, operasyonel açıdan yararlı olduğundan sayfa üzerinde daha sonra yapılacak düzenlemelerde korunmalıdır.