Diventa un Provider SSO
Oltre ai metodi d’autenticazione forniti da Crowdin, puoi usare la funzionalità Single Sing-On (SSO) per autenticare istantaneamente i tuoi utenti con i loro nomi utenti esistenti.
Questa funzione è disponibile solo nei piani di organizzazione.
L’ibrido SSO di Crowdin è in realtà il modo più veloce per creare il profilo traduttore rispetto ad un SSO classico come OAuth o SAML.
L’intero processo di razionalizzazione funziona come segue:
- Abilita SSO nel tuo profilo e copia la chiave API del tuo profilo.
- Crea un URL speciale nel tuo sistema che dirige il traduttore a Crowdin. Questo URL conterrà le informazioni di autenticazione del traduttore, oltre alla chiave API che hai ottenuto prima, come parametri URL crittografati con AES.
- Crowdin usa questi parametri per creare un profilo per il traduttore e reindirizza alla pagina desiderata. Per esempio, i traduttori possono essere immediatamente reindirizzati all’editor di traduzione per iniziare a funzionare.
- Il traduttore riceve un’email con istruzioni su come attivare il profilo e deve acconsentire ai Termini di Servizio e la Politica della Privacy di Crowdin.
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.
Abilitare l’Accesso Singolo (SSO)
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.
Parametri URL SSO
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).
| Parametro | Richiesto | Tipo | Predefinito | Esempio | Note |
|---|---|---|---|---|---|
| user_id | sì | int | 12345678901 | A unique identifier for the user (e.g., the user_id in your system). | |
| accesso | sì | nella stringa | johndoe | Nome d'accesso di Crowdin. Dovrebbe corrispondere allo schema [a-z,0-9] | |
| user_email | sì | nella stringa | john.doe@mail.com | Indirizzo email valido | |
| scadenza | sì | int | 1406124776 | marca oraria unix valida. Nota! Non impostare oltre 30 minuti dall'orario UTC corrente. | |
| display_name | nella stringa | John Doe | Nome reale o pseudonimo | ||
| locale | nella stringa | en_US | de_DE | Codice locale | |
| progetti | nella stringa | docx-project,csv-project | Un elenco separato da virgole di identificativi del progetto di Crowdin cui il traduttore dovrebbe inizialmente avere accesso | ||
| sesso | int | 0 | 1 | 2 | 1: maschio, 2: femmina | |
| ruolo | int | 0 | 0 | 1 | 2 | Il ruolo dell'utente nei progetti associati. 0: traduttore, 1: revisore, 2: manager | |
| lingue | nella stringa | ro,uk,fr | Comma separated list of Crowdin language codes the user should have access to. Usato per progetti con politiche d'accesso alla lingua moderate | ||
| redirect_to | nella stringa | https://crowdin.com/profile | https://crowdin.com/project/your-project-url | L'URL di Crowdin cui il traduttore dovrebbe arrivare dopo la registrazione | |
| return_crowdin_login | int | 0 | 1 | Restituisce il parametro GET crowdin_login (funziona in combinazione al parametro redirect_to) |
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"
}Crittografare le Informazioni
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.
Generazione del Link SSO
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.
Integrazioni Campione
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.