Google Workspace ile SAML SSO yapılandırma

Bu kılavuzda, SSO sağlayıcısı olarak Google Workspace ve tercih edilen kimlik protokolü olarak Security Assertion Markup Language (SAML) protokolünü kullanacağız.

Şu anda SP başlatmalı ve IdP başlatmalı kimlik doğrulamayı destekliyoruz. Kullanıcı sağlama için bkz. SCIM.

Bu özellik, Team & Enterprise planlarının bir parçasıdır.

Adım 1: Google Workspace'ta SAML Uygulaması Oluşturma

• Google Workspace yönetici konsolunuzda Admin > Apps > Web and mobile apps yolunu izleyin.
• Add app ve ardından Add custom SAML app öğelerine tıklayın.
• Uygulamanız için “App name” alanında bir ad belirtmeniz gerekir.
• Continue'e tıklayın.

Adım 2: Hugging Face'i Google'ın IdP ayrıntılarıyla yapılandırın

• Google kurulumundaki bir sonraki ekran, uygulamanızın SSO bilgilerini içerir.
• Hugging Face organizasyon ayarlarınızda SSO sekmesine gidin ve SAML protokolünü seçin.
• Google'dan SSO URL'sini Hugging Face'teki Sign-on URL alanına kopyalayın.
• Google'dan Sertifika dosyasını Hugging Face'teki ilgili alana kopyalayın. Genel sertifika aşağıdaki biçimde olmalıdır:
  Kopyalandı

  -----BEGIN CERTIFICATE-----
  {certificate}
  -----END CERTIFICATE-----

• Google Workspace kurulumunda Continue düğmesine tıklayın.

Adım 3: Google'ı Hugging Face'in SP Detaylarıyla Yapılandırın

• “Service provider details” ekranında, Hugging Face SSO ayarlarınızdan Assertion Consumer Service URL ve SP Entity ID değerlerine ihtiyacınız olacaktır. Bunları Google’daki ilgili ACS URL ve Entity ID alanlarına kopyalayın.
• Aşağıdaki ayarların yapıldığından emin olun:
  • İmzalı yanıt kutusunu işaretleyin.
  • Ad ID biçimi: EMAIL
  • Ad ID: Basic Information > Primary email

• Continue'e tıklayın.

Adım 4: Öznitelik Eşleme

• “Attribute mapping” ekranında Add mapping düğmesine tıklayın ve göndermek istediğiniz öznitelikleri yapılandırın. Bu adım isteğe bağlıdır ve Hugging Face üzerinde Role Mapping mi yoksa Resource Group Mapping mi kullanmak istediğinize bağlıdır.

• Finish'e tıklayın.

Adım 5: SSO'yu Test Edin ve Etkinleştirin

Testten önce, Google Workspace yönetim konsolunda uygulamanın “Kullanıcı erişimi” ayarları altında ilgili kullanıcılara uygulama erişimi verdiğinizden emin olun. Testi gerçekleştiren yöneticinin erişim yetkisine sahip olması gerekir. Google Workspace üzerinde kullanıcı erişimi değişikliklerinin uygulanması birkaç dakika sürebilir.

• Şimdi, Hugging Face SSO ayarlarınızda “SAML yapılandırmasını güncelle ve test et” seçeneğine tıklayın.
• Google oturum açma ekranına yönlendirilmelisiniz. Giriş yaptıktan sonra, organizasyonunuzun ayarlar sayfasına yönlendirileceksiniz.
• SAML seçicisinin yakınındaki yeşil onay işareti, testin başarılı olduğunu doğrular.
• Test başarılı olduğunda, “Enable” düğmesine tıklayarak organizasyonunuz için SSO'yu etkinleştirebilirsiniz.
• Etkinleştirildikten sonra, organizasyonunuzdaki üyeler Nasıl çalışır bölümünde açıklanan SSO kimlik doğrulama akışını tamamlamalıdır.

Update on GitHub