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.
Note: Before referring a user to Crowdin, please include a warning that you are sending the translator’s encrypted personal information to the outside party.
If you pass a login name or email to the SSO URL that is already taken at Crowdin, the user will be asked to correct the registration data.
Egyszeri bejelentkezés (SSO) engedélyezése
To enable SSO for your projects, go to the account settings page, click on the SSO tab, activate the Enable Single Sign-On option and specify a valid provider’s name.
SSO URL paraméterek
Below is the list of parameters you can pass to Crowdin for automatic registration. In this step, you will need to pack the data as JSON array before encryption (See the sample integrations in popular programming languages below).
| Paraméter | Szükséges | Típus | Alapértelmezett | Példa | Megjegyzések |
|---|---|---|---|---|---|
| user_id | igen | int | 12345678901 | A unique identifier for the user (e.g., the user_id in your system). | |
| 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 | Comma separated list of Crowdin language codes the user should have access to. 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) |
The output JSON array should look like the following:
{
"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
The JSON created in the previous step must be encrypted using AES 128-CBC, with the first 16 characters of your Crowdin account API key acting as the cipher key, and the last 16 characters as the initialization vector. The encrypted text should be transformed now to Base64 text.
SSO link generálása
The SSO URL should use the following pattern:
https://crowdin.com/join?h={ENCRYPTED_STRING}&uid={CROWDIN_USER_LOGIN}
Where:
{ENCRYPTED_STRING} is the Base64 text you created in the previous step.
{CROWDIN_USER_LOGIN} is the login name of your Crowdin account. Note: this must be the same account you used to create the projects you want the translator to have access to.
Minta integrációk
We’ve created the code snippets for the most major programming languages. Remember to replace CROWDIN_USER_LOGIN, CROWDIN_USER_API_KEY with your personal authentication information.