Installazione dell'App di Crowdin

Installazione dell’App di Crowdin

L’App di Crowdin potrebbe esser installata nella pagina Impostazioni dell’Organizzazione > App.

  1. Puoi trovare le Impostazioni dell’Organizzazione sotto l’icona dell’utente nella barra superiore del menu.
  2. Passa alla pagina App sulla barra del menu a sinistra e clicca Installa Applicazione.
  3. Nella finestra comparsa, incolla l’URL del Manifesto dell’app di Crowdin e clicca Installa.
  4. Nella finestra comparsa, puoi selezionare le categorie di utenti che potranno usare l’app: solo gli admin dell’organizzazione o tutti gli utenti nei progetti/nelle risorse dell’organizzazione. Inoltre, puoi selezionare i progetti in cui gli utenti potranno usare l’app: tutti i progetti o i progetti selezionati.

Installed Event Communication Flow

Note: Installed Event is used only for authorization.type: "authorization_code".

Quando un’App di Crowdin è installata nelle Impostazioni dell’Organizzazione, si verifica il flusso d’autorizzazione durante cui Crowdin Impresa e l’App di Crowdin scambia i dati d’autorizzazione (il codice d’autorizzazione è scambiato per un token d’accesso). In the following illustration, you can see the events that take place during this process.

Comunicazione tra Crowdin Impresa e l'App di Crowdin

Let’s examine in detail each step that happens in the illustration:

  1. Installazione dell’URL del Manifesto, l’utente incolla nell’URL del Manifesto nelle impostazioni dell’Organizzazione > App e clicca installa.
  2. Fetching content from the Manifest URL - the request is sent to Crowdin App.
  3. Response: manifest JSON - Crowdin App returns the Manifest JSON that contains the data about the app.
  4. Manifest Data Validation - the received content is validated according to the structure and data of the Manifest JSON.
  5. Prompt to install - the information about the Crowdin App, as well as the list of permissions and the Install button is displayed to the user.
  6. Confirmation of the installation - the user confirms the installation of the Crowdin App.
  7. L’evento Installato, Crowdin Impresa invia l’evento Installato con il codice d’autorizzazione all’app di Crowdin per la generazione del token dell’API.
  8. Token request - Crowdin App sends the request for API token acquiring:

    POST https://accounts.crowdin.com/oauth/token

    Parametri

    grant_type: authorization_code

    Type: string

    Required: yes

    Description: The parameter is used for the flow specification of an OAuth app.

    client_id

    Type: string

    Required: yes

    Description: Client ID for the app is received when the app is registered.

    client_secret

    Type: string

    Required: yes

    Description: Client Secret for the app is received when the app is registered.

    code

    Type: string

    Required: yes

    Description: The code received from the install event.

  9. Access Token - authorization service returns the API access token and the refresh token.
  10. Success Code Response - Crowdin App returns the success status code (2xx) which confirms that the application installation was successfully finished. Nel caso in cui il codice di stato sia diverso, l’applicazione sarà rimossa dall’organizzazione di Crowdin Impresa.

Questo articolo è stato utile?