Portais CDN: mudanças entre as edições

De CIGAM WIKI
 
(8 revisões intermediárias por 2 usuários não estão sendo mostradas)
Linha 10: Linha 10:


[[Image: CDN_2.png|center|750px|semmoldura|CDN_CIGAM]]
[[Image: CDN_2.png|center|750px|semmoldura|CDN_CIGAM]]


== Parametrização ==
== Parametrização ==
Linha 21: Linha 20:
** É sugerido que se crie uma pasta chamada <b>CONTENT</b> no c:\cigam\cdn dentro do servidor aonde consta o IIS, compartilhado ela como exemplo abaixo.<br>
** É sugerido que se crie uma pasta chamada <b>CONTENT</b> no c:\cigam\cdn dentro do servidor aonde consta o IIS, compartilhado ela como exemplo abaixo.<br>


[[Image: CDN_3.png|center|750px|semmoldura|CDN_CONTENT]]<br>
[[Image: CDN_3.png|center|750px|semmoldura|CDN_CONTENT]]


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Para as permissões do compartilhamento, precisam ser configurados:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Para as permissões do compartilhamento, precisam ser configurados:<br>


[[Image: CDN_4.png|center|750px|semmoldura|CDN_FILE]]<br>
[[Image: CDN_4.png|center|750px|semmoldura|CDN_FILE]]


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A permissão para o <b>“Domain Users”</b> é 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.<br>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A permissão para o <b>“Domain Users”</b> é 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.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A permissão do <b>IIS_IUSRS</b> 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.<br><br>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A permissão do <b>IIS_IUSRS</b> 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.<br><br>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;É necessário que para salvar/visualizar documentos que constem na CDN, através do CIGAM desktop se tenha o nome lógico: CDN = \\servidor\content no magic.ini e em adendos de transferências como broker ou gigaspace.


* 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:<br>
* 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:<br>
Linha 35: Linha 35:
** Deve ser criado um site ou aplicação que direcione a pasta CDN descompactada;<br>
** Deve ser criado um site ou aplicação que direcione a pasta CDN descompactada;<br>


[[Image: CDN_5.png|center|750px|semmoldura|CDN_Site]]<br>
[[Image: CDN_5.png|center|750px|semmoldura|CDN_Site]]


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Deve se acessar o web.config e no parâmetro CONTENT_SHARE direcionar para o SHARE criado (<i>\\servidor\content</i>);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Deve se acessar o web.config e no parâmetro CONTENT_SHARE direcionar para o SHARE criado (<i>\\servidor\content</i>);<br>


[[Image: CDN_6.png|center|750px|semmoldura|CDN_config]]<br>
[[Image: CDN_6.png|center|750px|semmoldura|CDN_config]]


== Entendendo conteúdo web.config ==
== Entendendo conteúdo web.config ==
* <b>CONTENT_SHARE</b> = É o compartilhamento da pasta base da CDN (\\servido\content)<br>
'''Configurações do Web.config'''
* <b>CONTENT_EXTERNAL</b> = Permite ou não acessar conteúdos de fora da pasta de conteúdos da CDN.<br>
:* '''CONTENT_SHARE:''' Define o compartilhamento da pasta base da CDN, informando o caminho de rede utilizado para acessar os conteúdos (ex.: `\\servidor\content`).
* <b>PUBLIC_TOKEN</b> = Token para que terceiros possam acessar conteúdo sem logar no CIGAM ou ter qualquer tipo de credencial ou identificação.<br>
:* '''CONTENT_EXTERNAL:''' Define se é permitido acessar conteúdos localizados fora da pasta de conteúdos da CDN.
* <b>KEY_TOKEN</b> = É a chave de cálculo do token de acesso. Utilize um valor em cada instalação/cliente, geralmente com 3 dígitos.<br>
:* '''PUBLIC_TOKEN:''' Token utilizado para permitir que terceiros acessem conteúdos sem a necessidade de realizar login no CIGAM ou possuir credenciais de identificação.
* <b>PUBLIC_UPLOAD</b> = Permite ou não que acessos feitos como PUBLIC possam fazer upload<br>
:* '''KEY_TOKEN:''' Chave utilizada no cálculo do token de acesso. Recomenda-se definir um valor específico para cada instalação ou cliente, geralmente composto por três dígitos.
* <b>PUBLIC_DELETE</b> = Permite ou não que acessos feitos como PUBLIC possam deletar arquivos<br>
:* '''PUBLIC_UPLOAD:''' Define se usuários com acesso do tipo `PUBLIC` podem realizar o upload de arquivos.
* <b>httpRuntime maxRequestLength="50000"</b> = Para upload e download, o tamanho máximo de cada arquivo pode ser informado em bytes
:* '''PUBLIC_DELETE:''' Define se usuários com acesso do tipo `PUBLIC` podem excluir arquivos.
:* '''httpRuntime maxRequestLength="50000":''' Define o tamanho máximo permitido para requisições que envolvam upload de arquivos, em quilobytes (KB). O valor `50000` corresponde a aproximadamente 48,8 MB. Para downloads, o limite pode depender de outras configurações da aplicação.
:* '''CRYPTOGRAPHY_KEY:''' Define a chave utilizada no processo de criptografia, necessária para o funcionamento do login integrado. Deve manter o mesmo valor nas configurações relacionadas à autenticação. <ref group="Versão 260504" name="multiple">Liberado a partir da OS 985290/1.</ref>
:* '''CRYPTOGRAPHY_TIMEOUT:''' Define o tempo de validade da chave de criptografia, em segundos. Deve manter o mesmo valor nas configurações relacionadas à autenticação, como `Web.config`, `configuracoes ([[GE - GE - 3282 - Chave de criptografia dos Portais|3282]] e [[GE - GE - 3283 - Tempo de validade da criptografia dos Portais|3283]])` e `config.json`. <ref group="Versão 260504" name="multiple">Liberado a partir da OS 985290/1.</ref>
 
'''Veja também:'''<br>
:* [[GE - Como Fazer - Parâmetros do arquivo config.json|Como Fazer - Parâmetros do arquivo config.json]]


== Utilização ==
== Utilização ==
* A CDN após ser instalada é necessário informar a URL da aplicação ou site instalado conforme indicado em [[Portais|Portais]] - CDN_URL.<br>
* A CDN após ser instalada é necessário informar a URL da aplicação ou site instalado conforme indicado em [[Portais|Portais]] - CDN_URL.<br>
* Também pode ser acessada através da URL direta no browse seguindo a seguinte estrutura:<br>
* Também pode ser acessada através da URL direta no browse seguindo a seguinte estrutura:<br>
<center><b>Protocolo + Servidor + Handler + Token + Operação + Tipo + Caminho</b></center><br>
<center><b>Protocolo + Servidor + Handler + Token + Operação + Tipo + Caminho</b></center>


Se estiver dentro de uma estrutura de pasta dentro da CDN (\\servidor\content) a montagem até chegar no arquivo ficaria nesse formato :
:
* http://Servidor:porta/files.ashx/PUBLIC_TOKEN/download/inline/Area/modulo/arquivo.extenção <br>
:Se estiver dentro de uma estrutura de pasta dentro da CDN (\\servidor\content) a montagem até chegar no arquivo ficaria nesse formato:
Se estiver solto na CDN não é necessário informar a estrutura, basta informar o arquivo após o <i>inline</i>:<br>
::* http://Servidor:porta/CDN/files.ashx/PUBLIC_TOKEN/download/inline/Area/modulo/arquivo.extenção <br>
* http://Servidor:porta/files.ashx/PUBLIC_TOKEN/download/inline/arquivo.extenção<br>


:Se estiver solto na CDN não é necessário informar a estrutura, basta informar o arquivo após o <i>inline</i>:<br>
::* http://Servidor:porta/CDN/files.ashx/PUBLIC_TOKEN/download/inline/arquivo.extenção<br>


* <b>Importante</b>
* <b>Importante</b>
Linha 65: Linha 72:


== Composição da URL ==
== Composição da URL ==
[[Image: CDN_7.png|center|750px|semmoldura|CDN_tabela]]<br>


[[Image: CDN_7.png|center|750px|semmoldura|CDN_tabela]]<br>
==Versões==
===Versão 260504===
<references group="Versão 260504"/>

Edição atual tal como às 14h02min de 13 de outubro de 2026

Portais > CDN

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
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
CDN_CIGAM

Parametrização

Consulte GE - Como Fazer - Ferramenta de implantação de sites e aplicações web para detalhamento do uso da ferramenta e implantação da aplicaçã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
CDN_CONTENT

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

CDN_FILE
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.

         É necessário que para salvar/visualizar documentos que constem na CDN, através do CIGAM desktop se tenha o nome lógico: CDN = \\servidor\content no magic.ini e em adendos de transferências como broker ou gigaspace.
  • 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
CDN_Site

          Deve se acessar o web.config e no parâmetro CONTENT_SHARE direcionar para o SHARE criado (\\servidor\content);

CDN_config
CDN_config

Entendendo conteúdo web.config

Configurações do Web.config

  • CONTENT_SHARE: Define o compartilhamento da pasta base da CDN, informando o caminho de rede utilizado para acessar os conteúdos (ex.: `\\servidor\content`).
  • CONTENT_EXTERNAL: Define se é permitido acessar conteúdos localizados fora da pasta de conteúdos da CDN.
  • PUBLIC_TOKEN: Token utilizado para permitir que terceiros acessem conteúdos sem a necessidade de realizar login no CIGAM ou possuir credenciais de identificação.
  • KEY_TOKEN: Chave utilizada no cálculo do token de acesso. Recomenda-se definir um valor específico para cada instalação ou cliente, geralmente composto por três dígitos.
  • PUBLIC_UPLOAD: Define se usuários com acesso do tipo `PUBLIC` podem realizar o upload de arquivos.
  • PUBLIC_DELETE: Define se usuários com acesso do tipo `PUBLIC` podem excluir arquivos.
  • httpRuntime maxRequestLength="50000": Define o tamanho máximo permitido para requisições que envolvam upload de arquivos, em quilobytes (KB). O valor `50000` corresponde a aproximadamente 48,8 MB. Para downloads, o limite pode depender de outras configurações da aplicação.
  • CRYPTOGRAPHY_KEY: Define a chave utilizada no processo de criptografia, necessária para o funcionamento do login integrado. Deve manter o mesmo valor nas configurações relacionadas à autenticação. [Versão 260504 1]
  • CRYPTOGRAPHY_TIMEOUT: Define o tempo de validade da chave de criptografia, em segundos. Deve manter o mesmo valor nas configurações relacionadas à autenticação, como `Web.config`, `configuracoes (3282 e 3283)` e `config.json`. [Versão 260504 1]

Veja também:

Utilização

  • A CDN após ser instalada é necessário informar a URL da aplicação ou site instalado conforme indicado em Portais - CDN_URL.
  • Também pode ser acessada através da URL direta no browse seguindo a seguinte estrutura:
Protocolo + Servidor + Handler + Token + Operação + Tipo + Caminho
Se estiver dentro de uma estrutura de pasta dentro da CDN (\\servidor\content) a montagem até chegar no arquivo ficaria nesse formato:
Se estiver solto na CDN não é necessário informar a estrutura, basta informar o arquivo após o inline:
  • Importante
    • A URL montada serve como validação para ver se o caminho até a CDN independentemente de quem esta requisitando está público para quem possuir a URL, caso não se consiga visualizar o arquivo deve ser revistas as permissões de rede.

Composição da URL

CDN_tabela
CDN_tabela


Versões

Versão 260504

  1. ↑ 1,0 1,1 Liberado a partir da OS 985290/1.