SSO szolgáltatóvá válás
A Crowdin által biztosított hitelesítési módokon kívül, az Egyszeri bejelentkezési (SSO) szolgáltatás használatával azonnal hitelesítheti felhasználóit a meglévő felhasználónevekkel.
Ez az opció csak üzleti díjcsomagokban érhető el.
A Crowdin hibrid SSO valójában egy gyorsabb módja a fordítói fiók létrehozásának, mint az olyan klasszikus SSO, mint az OAuth vagy a SAML.
Az egész egyszerűsített folyamat a következőképpen működik:
- Engedélyezze az Egyszeri bejelentkezést (SSO) a fiókjában, és másolja a fiók API-kulcsát.
- Hozzon létre egy speciális URL-t a saját rendszerében, amely átirányítja a fordítót a Crowdinba. Ez az URL tartalmazza a fordító hitelesítési adatait, a korábban kapott API kulcsot éppúgy, mint az AES segítségével titkosított URL paramétereket.
- A Crowdin ezeket a paramétereket használva létrehoz egy fiókot a fordítónak, és átirányítja a kívánt oldalra. Például a fordítók azonnal átirányíthatók a fordításszerkesztőbe a munka elkezdéséhez.
- A fordító egy e-mailt fog kapni a fiók aktiválásával kapcsolatos információkkal, valamint el kell fogadnia a Crowdin Általános szerződési feltételeit és Adatvédelmi szabályzatát.
Megjegyzés: Mielőtt egy felhasználót a Crowdinba irányít, kérjük, jelenítsen meg egy figyelmeztetést arról, hogy a fordító titkosított személyes adatait egy külső félnek fogja megküldeni.
Ha az SSO URL-nek egy Crowdinban már használt bejelentkezési nevet, vagy e-mail címet ad át, az adott felhasználót felkérjük, hogy javítsa a regisztrációs adatait.
Egyszeri bejelentkezés (SSO) engedélyezése
Az SSO projektjeihez való engedélyezéséhez lépjen a Fiókbeállítások oldalra, kattintson az API és SSO fülre, aktiválja az Egyszeri bejelentkezés (SSO) engedélyezése lehetőséget, és adja meg az érvényes szolgáltatói nevet.
SSO URL paraméterek
Az alábbiakban azon paraméterek listája látható, amelyeket átadhat a Crowdin felé az automatikus regisztrációhoz. Ebben a lépésben, az adatokat JSON tömbként kell csomagolni a titkosítás előtt (Lásd a lap alján a minta integrációkat a népszerű programozási nyelvekhez).
| Paraméter | Szükséges | Típus | Alapértelmezett | Példa | Megjegyzések |
|---|---|---|---|---|---|
| user_id | igen | string | 12345678901 | Egy egyedi azonosító a felhasználóhoz (pl. user_id az Ön rendszerében). | |
| login | igen | string | johndoe | Crowdin bejelentkezési név. Meg kell egyeznie az [a-z,0-9] mintával | |
| user_email | igen | string | john.doe@mail.com | Érvényes e-mail cím | |
| expiration | igen | int | 1406124776 | Érvényes unix időbélyeg. Megjegyzés! Ne állítson be 30 percnél többet az aktuális UTC időhöz képest. | |
| display_name | string | John Doe | Látszat vagy igazi név | ||
| locale | string | en_US | de_DE | Területi kód | |
| projects | string | docx-project,csv-project | A Crowdin projektazonosítóknak vesszővel elválasztott listája, amelyekhez a fordítónak kezdetben hozzá kell férnie | ||
| gender | int | 0 | 1 | 2 | 1: férfi, 2: nő | |
| role | int | 0 | 0 | 1 | 2 | Felhasználó szerepköre a csatlakozott projektekben. 0: fordító, 1: lektor, 2: menedzser | |
| languages | string | ro,uk,fr | A Crowdin nyelvkódok vesszővel elválasztott listája, melyhez a felhasználó hozzáférhet. Moderált nyelvi hozzáférési irányelvekkel rendelkező projektekhez | ||
| redirect_to | string | https://crowdin.com/profile | https://crowdin.com/project/your-project-url | A Crowdin URL, ahová a fordító kerüljön a regisztráció után | |
| return_crowdin_login | int | 0 | 1 | A crowdin_login visszatérési GET paramétere (a redirect_to paraméterrel kombinálva működik) |
A kimeneti JSON tömbnek így kell kinéznie:
{
"user_id":"12345678901",
"login":"johndoe",
"user_email":"john.doe@mail.com",
"display_name":"John Doe",
"locale":"de-DE",
"gender":1,
"projects":"docx-project,csv-project",
"expiration":1406124776,
"role":0,
"redirect_to":"https:\/\/crowdin.com\/project\/docx-project"
}Az információ titkosítása
Az előző lépésben létrehozott JSON-t az AES 128-CBC használatával kell titkosítani: a Crowdin fiók API kulcsának első 16 karaktere a titkosító kulcsként és az utolsó 16 karakter az inicializálási vektorként. A titkosított szöveget át kell alakítani Base64 szöveggé.
SSO link generálása
Az SSO URL a következő mintát kell használja:
https://crowdin.com/join?h={ENCRYPTED_STRING}&uid={CROWDIN_USER_LOGIN}
Ahol:
{ENCRYPTED_STRING} az előző lépésben létrehozott Base64 szöveg.
{CROWDIN_USER_LOGIN} a Crowdin fiókjához tartozó bejelentkezési neve. Megjegyzés: ugyanazt a fiókot kell használnia, amellyel létrehozta azokat a projekteket, amelyekhez a fordítók hozzáférését biztosítani szeretné.
Minta integrációk
Kódrészleteket készítettünk a leginkább használatos programozási nyelvekhez. Ne felejtse el a CROWDIN_USER_LOGIN, CROWDIN_USER_API_KEY mintaszövegeit kicserélni a saját hitelesítési adataival.