Instalação do aplicativo Crowdin

Instalação do aplicativo Crowdin

Crowdin App could be installed in the Organization Settings > Apps page.

  1. You can find Organization Settings under the user icon in the top menu bar.
  2. Switch to the Apps page on the left menu bar and click Install Application.
  3. In the appeared dialog, paste in the Crowdin app Manifest URL and click Install.
  4. In the appeared window, you can select the categories of users that will be able to use the app: only organization admins or all users in the organization projects/resources. Additionally, you can select the projects where users will be able to use the app: all projects or selected projects.

Fluxo de comunicação de eventos instalados

Nota: O evento instalado é usado apenas para authorization.type: "authorization_code".

When a Crowdin App is installed in the Organization Settings, the authorization flow takes place during which Crowdin Enterprise and Crowdin App exchange the authorization data (the authorization code is being exchanged for an access token). Na ilustração a seguir, você pode ver os eventos que ocorrem durante esse processo.

Communication between Crowdin Enterprise and Crowdin App

Vamos examinar em detalhes cada etapa que acontece na ilustração:

  1. Installation of the Manifest URL - the user pastes in the Manifest URL in the Organization Settings > Apps and clicks Install.
  2. Buscando conteúdo do URL do Manifesto - a solicitação é enviada para o aplicativo para Crowdin.
  3. Resposta: JSON manifesto - O aplicativo no Crowdin retorna o Manifest JSON que contém os dados sobre o aplicativo.
  4. Validação de dados de manifesto - o conteúdo recebido é validado de acordo com a estrutura e os dados do JSON do manifesto.
  5. Solicitar instalação - as informações sobre o aplicativo para Crowdin, a lista de permissões e o botão Instalar são exibidas para o usuário.
  6. Confirmação da instalação - o usuário confirma a instalação do aplicativo para Crowdin.
  7. The Installed event - Crowdin Enterprise sends the Installed event with the authorization code to the Crowdin App for API token generation.
  8. Solicitação de token - O aplicativo para Crowdin envia a solicitação de aquisição de token da API:

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

    Parâmetros

    grant_type: authorization_code

    Tipo: string

    Requerido: sim

    Descrição: O parâmetro é usado para a especificação de fluxo de um aplicativo OAuth.

    client_id

    Tipo: string

    Requerido: sim

    Descrição: O ID do cliente para o aplicativo é recebido quando o aplicativo é registrado.

    client_secret

    Tipo: string

    Requerido: sim

    Descrição: O segredo do cliente para o aplicativo é recebido quando o aplicativo é registrado.

    code

    Tipo: string

    Requerido: sim

    Descrição: O código recebido do evento de instalação.

  9. Token de acesso - o serviço de autorização retorna o token de acesso da API e o token de atualização.
  10. Resposta do código de sucesso - O aplicativo para Crowdin retorna o código de status de sucesso (2xx), que confirma que a instalação do aplicativo foi concluída com êxito. In case the status code is different, the application will be removed from the Crowdin Enterprise organization.

Este artigo foi útil?