TOA Sağlayıcısı Olma

Crowdin tarafından sağlanan kimlik doğrulama yöntemlerine ek olarak, kullanıcılarınızın kimliğini varolan kullanıcı adlarıyla anında doğrulamak için Tek Oturum Açma (TOA) özelliğini kullanabilirsiniz.

Bu özellik sadece kuruluş planlarında kullanılabilir.

Crowdin hibrit TOA, çevirmen hesabı oluşturmanın OAuth veya SAML gibi klasik TOA’dan daha hızlı bir yoludur.

Kolaylaştırılmış sürecin tamamı aşağıdaki gibi çalışır:

  1. Hesabınızda TOA’yı etkinleştirin ve hesap API anahtarınızı kopyalayın.
  2. Sisteminizde bir çevirmeni Crowdin’e yönlendiren özel bir URL oluşturun. Bu URL, çevirmenin kimlik doğrulama bilgilerini ve daha önce AES ile şifrelenmiş URL parametreleri olarak aldığınız API anahtarını içerecektir.
  3. Crowdin bu parametreleri çevirmen için bir hesap oluşturmak amacıyla kullanır ve istenen sayfaya yönlendirir. Örneğin, çevirmenler çalışmaya başlamak için hemen çeviri düzenleyicisine yönlendirilebilir.
  4. Çevirmen, hesabı etkinleştirme talimatlarını içeren bir e-posta alır ve Crowdin’in Hizmet Şartları ve Gizlilik İlkesini kabul etmek zorundadır.
Not: Bir kullanıcıyı Crowdin’e yönlendirmeden önce, lütfen çevirmenin şifreli kişisel bilgilerini dış tarafa gönderdiğinize dair bir uyarı ekleyin.

Eğer Crowdin’de zaten alınmış olan TOA URL’sine bir oturum açma adı veya e-posta iletirseniz, kullanıcıdan kayıt ayrıntılarını düzeltmesi istenecektir.

Tek Oturum Açma (TOA) Etkinleştirme

Projeleriniz için TOA’yı etkinleştirmek amacıyla şu adımları izleyin:

  1. Hesap Ayarları > TOA’ya gidin.
  2. Tek oturum açmayı etkinleştir’i seçin.
  3. Geçerli bir sağlayıcının adını belirtin.
  4. Kaydet’e tıklayın.

TOA URL Parametreleri

Otomatik kayıt için Crowdin’e iletebileceğiniz parametrelerin listesi aşağıdadır. Bu adımda, şifrelemeden önce verileri bir JSON dizilimi olarak paketlemeniz gerekecektir (Aşağıdaki yaygın programlama dillerindeki örnek bütünleştirmelere bakın).

Parametre Zorunlu Tür Varsayılan Örnek Notlar
user_id evet tamsayı 12345678901 Kullanıcı için benzersiz bir tanımlayıcı (örn., sisteminizdeki user_id).
login evet dizgi johndoe Crowdin oturum açma adı. [a-z, 0-9] şekliyle eşleşmelidir
user_email evet dizgi john.doe@posta.com Geçerli e-posta adresi
expiration evet tamsayı 1406124776 Geçerli unix zaman damgası.
Not! Şu anki UTC saatinden en fazla 30 dakika ayarlayın.
display_name dizgi John Doe Sözde veya gerçek ad
locale dizgi en_US tr_TR Yerel ayar kodu
projects dizgi docx-projesi,csv-projesi Çevirmenin başlangıçta erişebilmesi gereken virgülle ayrılmış Crowdin proje tanımlayıcıları listesi
gender tamsayı 0 1 | 2 1: erkek, 2: kadın
role tamsayı 0 0 | 1 | 2 Katılınan projelerde kullanıcı rolü. 0: çevirmen, 1: düzeltmen, 2: yönetici
languages dizgi ro,uk,tr Kullanıcının erişmesi gereken Crowdin dil kodlarının virgülle ayrılmış listesi. Orta düzeyde dil erişim ilkesine sahip projeler için kullanılır
redirect_to dizgi https://tr.crowdin.com/profile https://tr.crowdin.com/project/proje-url-niz Çevirmenin kayıttan sonra erişmesi gereken Crowdin URL’si
return_crowdin_login tamsayı 0 | 1 Dönen GET parametresi crowdin_login (redirect_to parametresi ile birlikte çalışır)

Çıktı JSON dizilimi aşağıdaki gibi görünmelidir:

{
  "user_id":"12345678901",
  "login":"johndoe",
  "user_email":"john.doe@posta.com",
  "display_name":"John Doe",
  "locale":"tr_TR",
  "gender":1,
  "projects":"docx-projesi,csv-projesi",
  "expiration":1406124776,
  "role":0,
  "redirect_to":"https:\/\/crowdin.com\/project\/docx-projesi"
}

Bilgileri Şifreleme

Önceki adımda oluşturulan JSON, şifre anahtarı gibi davranan Crowdin hesabı API anahtarınızın ilk 16 karakteri ve başlatma vektörü olarak son 16 karakter ile AES 128-CBC kullanılarak şifrelenmek zorundadır. Şifrelenmiş metin artık Base64 metnine dönüştürülmüş olmalıdır.

TOA Bağlantısı Oluşturma

TOA URL’si aşağıdaki şekli kullanmalıdır:

https://crowdin.com/join?h={ENCRYPTED_STRING}&uid={CROWDIN_USER_LOGIN}

Yani:

{ENCRYPTED_STRING} önceki adımda oluşturduğunuz Base64 metnidir.

{CROWDIN_USER_LOGIN} Crowdin hesabınızın oturum açma adıdır. Not: Bu, çevirmenin erişmesini istediğiniz projeleri oluşturmak için kullandığınız hesapla aynı olmak zorundadır.

Örnek Bütünleştirmeler

En büyük programlama dilleri için kod parçacıklarını oluşturduk. CROWDIN_USER_LOGIN ve CROWDIN_USER_API_KEY yerlerini kişisel doğrulama bilgileriniz ile değiştirmeyi unutmayın.

Bu makale yararlı oldu mu?