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:

  1. Engedélyezze az Egyszeri bejelentkezést (SSO) a fiókjában, és másolja a fiók API-kulcsát.
  2. 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.
  3. 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.
  4. 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 Típus Szükséges Alapértelmezett Példa Megjegyzések
user_id string igen 12345678901 Egy egyedi azonosító a felhasználóhoz (pl. user_id az Ön rendszerében).
login string igen johndoe Crowdin bejelentkezési név. Meg kell egyeznie az [a-z,0-9] mintával
user_email string igen john.doe@mail.com Érvényes e-mail cím
expiration int igen +20 perc a jelenlegi UTC időtől 1406124776 Érvényes Unix időbélyeg
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 Felhasználói szerepkör a csatlakozott projektekben.0 => fordító, 1 => lektor
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é.

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.