Portais CDN

De CIGAM WIKI
Revisão de 15h00min de 25 de agosto de 2021 por Elizama.Dias (discussão | contribs) (Composição da URL)

Voltar

CDN, termo técnico, traduzido literalmente para o português como Rede de fornecimento, entrega e distribuição de conteúdo, é um termo criado em fins da década de 1990 para descrever um sistema de computadores e redes interligados através da Internet, que cooperam de modo transparente para fornecer conteúdo a usuários finais.

CDN

A CDN do CIGAM contém os conteúdos que precisam ser acessados de qualquer lugar, por qualquer tipo de aplicação, de qualquer plataforma, trazendo um facilitador para busca de arquivos centralizando em um local de fácil acesso para todos, sendo via web ou via aplicações direcionadas.

CDN_CIGAM


Parametrização

Para que seja possível a utilização da CDN nas aplicações CIGAM é necessário se configurar a CDN para utilização seguindo os tópicos abaixo:

  • Criar uma pasta na rede para conter os arquivos;
    • É sugerido que se crie uma pasta chamada CONTENT no c:\cigam\cdn dentro do servidor aonde consta o IIS, compartilhado ela como exemplo abaixo.
CDN_CONTENT


          Para as permissões do compartilhamento, precisam ser configurados:

CDN_FILE


          A permissão para o “Domain Users” é para que usuários do domínio possam automaticamente colocar conteúdo. Ela pode ser substituída por permissões nas subpastas especificas ou usuário por usuário.
          A permissão do IIS_IUSRS ou do usuário do pool caso diferente do usuário padrão do IIS, precisa de permissão de alteração pois existe uma possibilidade de excluir o arquivo da CDN após o download.

  • Deve ser configurado um site ou app no IIS para acessar a CDN via URL, isso é possível via CGImplanta.exe ou via instalação manual conforme passos a seguir:
    • Deve ser acessado o %CIGAM_INSTAL%web zip CDN;
    • Deve ser descompactado no servidor IIS;
    • Deve ser criado um site ou aplicação que direcione a pasta CDN descompactada;
CDN_Site


          Deve se acessar o web.config da pasta e direcionar para o SHARE criado (\\servidor\content);

CDN_config


Entendendo conteúdo web.config

  • CONTENT_SHARE = É o compartilhando da pasta base da CDN criado anteriormente
  • CONTENT_EXTERNAL = Permite ou não acessar conteúdos de fora da pasta de conteúdos da CDN.
  • PUBLIC_TOKEN = Token para que terceiros possam acessar conteúdo sem se logar no CIGAM ou ter qualquer tipo de credencial ou identificação.
  • KEY_TOKEN = É a chave de cálculo do token de acesso. Utilize um valor em cada instalação/cliente, geralmente com 3 dígitos.
  • PUBLIC_UPLOAD = Permite ou não que acessos feitos como PUBLIC possam fazer upload
  • PUBLIC_DELETE = Permite ou não que acessos feitos como PUBLIC possam deletar arquivos
  • httpRuntime maxRequestLength="50000" = Para upload e download, o tamanho máximo de cada arquivo pode ser informado em bytes (no exemplo abaixo, 50MB)

Utilização

  • A CDN após ser instalada pode ser utilizadas nos portais, para isso é necessário informar a URL da aplicação ou site instalado conforme indicado em Portais.
  • Também pode ser acessada através da URL direta no browse seguindo a seguinte estrutura:
Protocolo + Servidor + Handler + Token + Operação + Tipo + Caminho

Composição da URL

Composição Observação Exemplo
Protocolo É o protocolo habilitado no
servidor que foi instalado a CDN.
http
https
http://
https://
à Requer certificado configurado
Servidor É o servidor http://servidor
http://servidor
Handler É o serviço http://servidor/files.ashx
Token É o token de autorização de acesso à CDN, que pode ser:
público, auth, token
Com PUBLIC_TOKEN (token do Web.config)
 http://servidor/files.ashx/a98x48djuh58vj38dhfg3
Com AUTH (deve ser enviado o Header de Authentication)
http://servidor/files.ashx/auth
Com TOKEN (gerado a cada requisição pelas app’s CIGAM/Front). Esse token é calculado e verificado com a KEY_TOKEN configurada, e expira sempre as 23:59:59 do mesmo dia.
http://servidor/files.ashx/7a0x9f889f0x0xy0y0f988f9y0a7
Operacão Operação na CDN:
download
upload
delete
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/upload
 http://servidor/files.ashx/a98x48djuh58vj38dhfg3/download
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/delete
Tipo Tipo da operação:
download
o inline
o attachment
delete
o none
upload
o write
o new
Download com arquivo:
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/download/attachment/teste.pdf
Download para visualização numa nova aba do navegador:
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/download/inline/teste.pdf
Deletando:
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/delete/none/teste.pdf
Upload como criação se não existir:
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/upload/new/teste.pdf
Upload sobrescrevendo caso exista
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/upload/write/teste.pdf
Caminho É o caminho do arquivo dentro da
estrutura de conteúdos da CDN

Exemplo do arquivo Boletos.pdf dentro da pasta da CDN, na sub pasta “areas/finanças/gf”:
 http://servidor/files.ashx/a98x48djuh58vj38dhfg3/download/inline/areas/financas/gf/Boleto.pdf
Exemplo de um arquivo na unidade P:\cigam\imagens\sapato.png, que para isso, precisa estar com o CONTENT_EXTERNAL no Web.config setado bem como o DRIVE_P:
http://servidor/files.ashx/a98x48djuh58vj38dhfg3/download/inline/p/cigam/imagens/sapato.png