Strapi

Requisitos

• ONLYOFFICE Document Server v7.1 (servidor ou versão cloud) ou posterior

  Você precisa de uma instância do ONLYOFFICE Docs que seja resolvível e conectável tanto do Strapi quanto de qualquer cliente final. Deve ser capaz de fazer POST diretamente para o Strapi.

  Consulte a página de documentação oficial para saber mais sobre a instalação do ONLYOFFICE Docs.
• Strapi v4.2.0 ou posterior
• Conector ONLYOFFICE v1.1.0 para Strapi

Instalando o plugin de integração ONLYOFFICE para Strapi

1. Para permitir a inserção de um frame com o editor e carregamento do api.js, substitua a linha strapi::security no arquivo strapi/config/middlewares.js pela seguinte configuração:

   
   {
     name: "strapi::security",
     config: {
       contentSecurityPolicy: {
         useDefaults: true,
         directives: {
           "script-src": ["'self'", "https:", "http:"],
           "frame-src": ["'self'", "https:", "http:"],
         },
       },
     }
   },  
                       

   Se tal configuração já existir, você só precisa adicionar directives.

2. Instale o plugin no seu projeto Strapi:

   npm install onlyoffice-strapi --save

3. Reconstrua e reinicie o Strapi para incluir o plugin ONLYOFFICE na interface administrativa. Execute:

   
   # usando yarn
   yarn build
   yarn develop      
   # usando npm
   npm run build
   npm run develop
   

   Agora o plugin de integração ONLYOFFICE para Strapi está instalado e pronto para ser configurado. O plugin pode ser acessado através do painel esquerdo na seção Plugins sob o nome ONLYOFFICE.

   

Configurando o plugin de integração ONLYOFFICE para Strapi

Para configurar o plugin de integração ONLYOFFICE no Strapi:

1. Abra a seção Configurações no painel esquerdo.
2. Na seção Configurações globais, clique no item de menu ONLYOFFICE.
3. Na página de configurações ONLYOFFICE, digite o Endereço do servidor de documentos, ou seja, a URL do ONLYOFFICE Docs instalado.
   O endereço do ONLYOFFICE Docs deve estar acessível do Strapi, assim como o endereço do Strapi deve estar acessível do ONLYOFFICE Docs.

Como funciona

A interação usuário-documento é feita tanto no lado do cliente quanto no lado do servidor.

Os principais conceitos usados ao longo da documentação atual são explicados abaixo.

O lado do cliente inclui:

• Gerenciador de documentos - a lista dos documentos exibida no navegador do usuário onde o usuário pode selecionar o documento necessário e executar algumas ações com ele (dependendo dos direitos fornecidos, o usuário pode abrir o documento para visualizá-lo ou editá-lo, compartilhar o documento com outros usuários).
• Editor de documentos - a interface de visualização e edição de documentos com todos os recursos de edição de documentos mais conhecidos disponíveis, usada como meio entre o usuário e o serviço de edição de documentos.

O lado do servidor inclui:

• Serviço de armazenamento de documentos - o serviço do servidor que armazena todos os documentos disponíveis aos usuários com os direitos de acesso apropriados. Ele fornece os IDs dos documentos e links para esses documentos ao gerenciador de documentos que o usuário vê no navegador.
• Serviço de edição de documentos - o serviço do servidor que permite executar a visualização e edição de documentos (caso o usuário tenha os direitos apropriados para fazer isso). A interface do editor de documentos é usada para acessar todos os recursos do serviço de edição de documentos.
• Serviço de comando de documentos - o serviço do servidor que permite executar comandos adicionais com o serviço de edição de documentos.
• Serviço de conversão de documentos - o serviço do servidor que permite converter o arquivo de documento para o formato Office Open XML apropriado (docx para documentos de texto, xlsx para planilhas e pptx para apresentações) para sua edição ou download.
• Serviço de construção de documentos - o serviço do servidor que permite construir um documento facilmente sem a necessidade de executar realmente um editor de processamento de documentos.

Observe que o ONLYOFFICE Document Server inclui o editor de documentos, serviço de edição de documentos , serviço de comando de documentos, serviço de conversão de documentos e serviço de construção de documentos . O gerenciador de documentos e o serviço de armazenamento de documentos estão incluídos no Community Server ou devem ser implementados pelos integradores de software que usam o ONLYOFFICE Document Server em seu próprio servidor.

Habilitando JWT para a integração ONLYOFFICE e Strapi

JWT ou JSON Web Token é uma string enviada do cliente para o servidor dentro da requisição HTTP para validar a autenticidade do cliente. O JWT é salvo apenas no lado do cliente, então a transmissão entre as partes é protegida e assinada digitalmente.

O token é gerado usando o padrão JWT (JSON Web Tokens). Os tokens são assinados pela chave do servidor, então o cliente é capaz de verificar que o token é legítimo.

O ONLYOFFICE Docs valida o token. Os dados do payload são considerados válidos e são usados ao invés dos dados correspondentes dos parâmetros principais. Se o token for inválido, o comando não é executado. Para saber mais, leia o guia de Segurança da API.

Para proteger seus documentos com JWT,

1. Abra a seção Configurações no painel esquerdo.
2. Na seção Configurações globais, clique no item de menu ONLYOFFICE.
3. Na página de configurações ONLYOFFICE, digite a chave secreta no campo Chave secreta JWT do servidor de documentos . Mais informações podem ser encontradas aqui.
   

   Agora que o plugin de integração ONLYOFFICE está configurado, você pode começar a usá-lo.