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:
- Hesabınızda TOA’yı etkinleştirin ve hesap API anahtarınızı kopyalayın.
- 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.
- 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.
- Ç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:
- Hesap Ayarları > TOA’ya gidin.
- Tek oturum açmayı etkinleştir’i seçin.
- Geçerli bir sağlayıcının adını belirtin.
- 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.