TOA Sağlayıcısı Olma
Crowdin tarafından sağlanan kimlik doğrulama yöntemlerine ek olarak, kullanıcılarınızı 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, aslında ç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 çevirmeni Crowdin’e yönlendiren özel bir URL oluşturun. Bu URL, daha önce aldığınız API anahtarının yanı sıra çevirmenin kimlik doğrulama bilgilerini, AES ile şifrelenmiş URL parametreleri olarak 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ın nasıl etkinleştirileceği ile ilgili talimatları 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 zaten Crowdin’de alınmış olan TOA URL’sine bir oturum açma adı veya e-posta iletirseniz, kullanıcıdan kayıt verilerini düzeltmesi istenecektir.
Tek Oturum Açma (TOA) Etkinleştirme
Projelerinizde TOA’yı etkinleştirmek için Hesap Ayarları sayfasına gidin, TOA sekmesine tıklayın, Tek Oturum Açmayı etkinleştir seçeneğini etkinleştirin ve geçerli bir sağlayıcı adı belirtin.
TOA URL Parametreleri
Otomatik kayıt için Crowdin’e iletebileceğiniz parametrelerin listesi aşağıdadır. Bu adımda, şifrelemeden önce verileri 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, CROWDIN_USER_API_KEY yerlerini kişisel doğrulama bilgileriniz ile değiştirmeyi unutmayın.