Okta ile SSO kurulumu

Ekibinizin Okta hesaplarıyla giriş yapabilmesi için Okta ve Clevera arasında tek oturum açma (SSO) kurulumunu yapın. SAML 2.0 veya OpenID Connect (OIDC) ile bağlanabilirsiniz; bu kılavuz, hem Okta tarafındaki hem de Clevera'daki eşleşen alanlardaki adımları açıklar.

Okta'nın yönetici konsolu zaman zaman değişebilir. Aşağıdaki bir etiket gördüklerinizle eşleşmiyorsa, aynı anlama gelen ayarı arayın ve değerlerin tam listesi için genel kılavuzları kullanın: SAML, OIDC.

Başlamadan önce#

• Özel plan üzerindeki bir Clevera çalışma alanının Sahibi sensin.
• Uygulama entegrasyonları oluşturabilen ve bunları atayabilen bir Okta yöneticisisin.
• Kişilerinizin Okta'da kullandığı e-posta alan adlarını biliyorsun, örneğin acme.example.

Önce Clevera kurulum iletişim kutusunu aç, böylece değerleri oradan kopyalayabilirsin: kenar çubuğunun üst kısmındaki çalışma alanı menüsünü aç, Ekip ayarları'nı, ardından Güvenlik'i seç ve SSO kurulumu'na tıkla. Kimlik sağlayıcı olarak Okta'yı seç.

SAML 2.0 ile bağlanma#

1. Okta'da uygulamayı oluşturma#

   Okta Yönetici Konsolu'nda Applications → Applications bölümüne git ve Create App Integration'a tıkla. SAML 2.0'ı seç ve İleri'ye tıkla. Uygulamaya Clevera adını ver ve İleri'ye tıkla.

2. Clevera'nın değerlerini girme#

   SAML Settings altında şunları doldur:

   Okta alanı	Clevera'dan gelen değer
   Single sign-on URL	ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. Use this for Recipient URL and Destination URL seçeneğinin işaretli olduğundan emin ol.
   Audience URI (SP Entity ID)	Entity ID / Audience URI (Clevera iletişim kutusundan kopyala; çalışma alanı kimliğinle biter)
   Default RelayState	Boş bırak
   Name ID format	EmailAddress
   Application username	Email

3. İmzalama ayarlarını kontrol etme#

   Show Advanced Settings'e tıkla ve Response ile Assertion Signature'ın her ikisinin de Signed olduğundan, Signature Algorithm'in RSA-SHA256 olduğundan ve Assertion Encryption'ın Unencrypted olduğundan emin ol. Clevera hem yanıtın hem de onaylamanın imzalanmasını gerektirir.

4. İsim özniteliklerini ekleme#

   Attribute Statements altında, user.firstName değerli firstName ve user.lastName değerli lastName özniteliklerini ekle. Clevera bunları yeni hesapları adlandırmak için kullanır. İleri'ye tıkla, Okta'nın geri bildirim sorusunu dahili bir uygulama olarak yanıtla ve Finish'e tıkla.

5. Okta'nın değerlerini Clevera'ya kopyalama#

   Uygulamanın Sign On sekmesinde, SAML kurulum detaylarını aç (View SAML setup instructions veya daha yeni konsollarda More details). Clevera'da Protocol'ü SAML 2.0 olarak ayarla, Devam et'e tıkla ve şunları yapıştır:

   Okta değeri	Clevera alanı
   Identity Provider Issuer (veya Issuer)	IdP Entity ID
   Identity Provider Single Sign-On URL (veya Sign on URL)	SSO sign-in URL
   X.509 Certificate (veya Signing Certificate)	X.509 certificate

   Okta tek oturum kapatma (single logout) kullanmıyorsan Logout URL'yi boş bırak.

   

6. Kişileri atama#

   Uygulamanın Assignments sekmesinde Assign'a tıkla ve Clevera'yı kullanması gereken kişileri veya grupları ekle. Atanmamış kişiler Okta üzerinden giriş yapamaz.

Ardından Clevera'da işlemi tamamla: alan adları ve roller.

OpenID Connect ile bağlanma#

1. Okta'da uygulamayı oluşturma#

   Applications → Applications → Create App Integration yolunu izle. OIDC - OpenID Connect'i, ardından Web Application'ı seç ve İleri'ye tıkla.

2. Yönlendirme URI'sini ayarlama#

   Clevera'nın kurulum iletişim kutusunda Protocol'ü OpenID Connect olarak ayarla ve gri kutudaki Redirect URI (callback URL) değerini kopyala. Ardından Okta'da şunları doldur:

   Okta alanı	Değer
   App integration name	Clevera
   Grant type	Authorization Code
   Sign-in redirect URIs	Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
   Sign-out redirect URIs	Örneği kaldır; boş bırak
   Controlled access	Uygulamayı kimlerin kullanabileceğini seç veya Skip group assignment for now diyerek daha sonra ata

   Kaydet'e tıkla.

3. Kimlik bilgilerini kopyalama#

   Uygulamanın General sekmesinde, Client Credentials altında Client ID ve Client secret değerlerini kopyala. Client authentication ayarını Client secret olarak bırak.

4. Clevera'da doldurma#

   Clevera'da Devam et'e tıkla ve şunları gir:

   Clevera alanı	Değer
   Client ID	Okta'nın Client ID değeri
   Client secret	Okta'nın Client secret değeri
   Discovery URL	https:// Okta alan adın /.well-known/openid-configuration, örneğin https://acme.okta.com/.well-known/openid-configuration

   Özel bir yetkilendirme sunucusu kullanıyorsan, bunun yerine kendi discovery URL'sini kullan, örneğin https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

   

5. Kişileri atama#

   Assignments sekmesinde, Clevera'yı kullanması gereken kişileri veya grupları ata.

Clevera'da bitirme#

1. Domains & roles kısmında, Okta kullanıcılarının sahip olduğu her e-posta alan adını ekle, Create accounts on first sign-in ve Default role for new SSO members seçeneklerini belirle.
2. İncele kısmında, Save configuration'a tıkla.
3. Run test'e tıkla, Enable SSO'yu aç ve Clevera giriş sayfasından başlayarak gizli bir pencerede atanmış bir test kullanıcısı olarak giriş yap.
4. Herkes için çalıştığında, SSO'nun tek giriş yolu olmasını istiyorsan Require SSO'yu aç.

Üyeler daha sonra Clevera giriş sayfasında iş e-postalarını yazar ve Continue with Okta'ya tıklar.

Sorun giderme#

Daha fazla mesaj: SSO giriş sorunlarını düzeltme.

İlgili#