Páginas filhas
  • Parâmetros dos Arquivos de Configuração (*.config)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • Descrição: Tem como objetivo definir um único Alias.dat a ser utilizado por todos os hosts do ambiente, para isso devemos adicioná-la nos arquivos RM.AliasManager.exe.config e RM.Host.exe.config ou RM.host.Service.exe.config.
  • Tipo: String
  • Default: Vazio
  • Exemplo:

    Bloco de código
    languagexml
    <add key=“Aliaspath” value=“\\rm004066\publico” />

...

AllowAssemblySignCheck

  • Descrição: Restringe a importação de Objetos Gerenciais onde somente objetos do Book de Objetos Gerenciais da TOTVS poderão ser importados através do TOTVS Compartilhamento. 
  • Tipo: bool
  • Default: false
  • Permite que os assemblies carregados pelo host tenham sua assinatura validada. Caso exista algum assembly que esteja com sua assinatura inválida, o host automaticamente o bloqueará e bloqueará todas as outras chamadas consequentes.
  • Tipo: Booleano
  • Default:FalseVersão: 12.1.34
  • Exemplo:

    Bloco de código
    languagexml
    <add key="AllowOnlyBookedManagementObjectsALLOWASSEMBLYSIGNCHECK" value="falsetrue" />

...


AllowOnlyBookedManagementObjects

  • Descrição: Nome do lugar onde a Store do certificado de segurança do WCF está localizado. Habilitada somente no host. Restringe a importação de Objetos Gerenciais onde somente objetos do Book de Objetos Gerenciais da TOTVS poderão ser importados através do TOTVS Compartilhamento. 
  • Tipo: Valores pré-determinados
  • Possíveis Valores: 
    • CurrentUser
    • LocalMachine
  • bool
  • Default: false
  • Versão: 12.1.34Default: LocalMachine
  • Exemplo: 

    Bloco de código
    languagexml
    <add key<add key="CertificateStoreLocationAllowOnlyBookedManagementObjects" value value="LocalMachinefalse"  />

...

ApiPort

  • Descrição:

...

  • Porta utilizada para expor serviços de API do RM. 
  • Tipo: Numeric
  • Default: vazia (Se não preenchida utiliza o valor preenchido na tag HttpPort)

...

  • Tipo: Valores pré-determinados
  • Possíveis valores:
    • AddressBook
    • AuthRoot
    • CertificateAuthority
    • Disallowed
    • My
    • Root
    • TrustedPeople
    • TrustedPublisher
  • Default: My
  • Exemplo:

    Bloco de código
    languagexml
    <add key<add key="CertificateStoreNameApiPort" value value="My8051"  />

...

CertificateStoreLocation

  • Descrição: Campo pelo qual o  Nome do lugar onde a Store do certificado de segurança será procurado no Certificate Store. Este valor ajuda a encontrar o certificado correto com que a comunicação do sistema será protegidado WCF está localizado. Habilitada somente no host.
  • Tipo: Valores pré-determinados
  • Possíveis valoresValores: 
    • FindByThumbprintCurrentUser
    • FindBySubjectName
    • FindBySubjectDistinguishedName
    • FindByIssuerName
    • FindByIssuerDistinguishedName
    • FindBySerialNumber
    • FindByTimeValid
    • FindByTimeNotYetValid
    • FindByTimeExpired
    • FindByTemplateName
    • FindByApplicationPolicy
    • FindByCertificatePolicy
    • FindByExtension
    • FindByKeyUsage
    • FindBySubjectKeyIdentifier
    • LocalMachine
  • Default: LocalMachineDefault: FindBySubjectName
  • Exemplo: 

    Bloco de código
    languagexml
    <add key="CertificateFindTypeCertificateStoreLocation" value="FindBySubjectNameLocalMachine" />

...

CertificateStoreName

Descrição:

...

 Nome do Store onde o certificado de segurança

...

do WCF está armazenado. Habilitada somente no host.

  • Tipo: Valores pré-determinados
  • Possíveis valores:
    • AddressBook
    • AuthRoot
    • CertificateAuthority
    • Disallowed
    • My
    • Root
    • TrustedPeople
    • TrustedPublisher
  • Default: My
  • Exemplo:

    Bloco de código
    languagexml
    <add key="CertificateStoreName" value="My" />

CertificateFindType

  • Descrição: Campo pelo qual o certificado de segurança será procurado no Certificate Store. Este valor ajuda a encontrar o certificado correto com que a comunicação do sistema será protegida. Habilitada somente no host.
  • Tipo: Valores pré-determinados
  • Possíveis valores:
    • FindByThumbprint
    • FindBySubjectName
    • FindBySubjectDistinguishedName
    • FindByIssuerName
    • FindByIssuerDistinguishedName
    • FindBySerialNumber
    • FindByTimeValid
    • FindByTimeNotYetValid
    • FindByTimeExpired
    • FindByTemplateName
    • FindByApplicationPolicy
    • FindByCertificatePolicy
    • FindByExtension
    • FindByKeyUsage
    • FindBySubjectKeyIdentifier
  • Default: FindBySubjectName
  • Exemplo:

    Bloco de código
    languagexml
    <add key="CertificateFindType" value="FindBySubjectName" />

CertificateFindValue

  • Descrição: Valor pelo qual o certificado de segurança será procurado no Certificate Store. Habilitada no host e deve conter o nome do certificado no client. Este valor ajuda a encontrar o certificado correto com que a comunicação do sistema será protegida. Trabalha em conjunto com a chave CertificateFindType. Para que seja levada em conta, a comunicação deve estar ocorrendo em WCF e a chave SecurityEnabled habilitada.
  • Tipo: String
  • Default: TOTVS
  • Exemplo:

    Bloco de código
    languagexml
    <add key="CertificateFindValue" value="TOTVS" />

ConfigAutoGenerate

  • Descrição: Habilita a criação automática de arquivos de configuração quando utilizada a funcionalidade de Gerenciamento de Config. 
  • Tipo: Boolean
  • Default: True
  • Exemplo: 

    Bloco de código
    languagexml
    <add key="ConfigAutoGenerate " value="true" /> 

ConfigPath 

  • Descrição: Tem como objetivo definir um único arquivo de configuração a ser utilizado por todos os aplicativos do ambiente.  no host e deve conter o nome do certificado no client. Este valor ajuda a encontrar o certificado correto com que a comunicação do sistema será protegida. Trabalha em conjunto com a chave CertificateFindType. Para que seja levada em conta, a comunicação deve estar ocorrendo em WCF e a chave SecurityEnabled habilitada.
  • Tipo: String
  • Default: Vazio
  • Observações: Para mais informações acesse o link: TOTVSGerenciador de Config.
  • Exemplo:

    Bloco de código
    languagexml
    <add key<add key="CertificateFindValueConfigPath" value value="TOTVS\\PastaCompartilhadaNaRede"  />

...

DbSchemaCacheMaxSize

  • Descrição: Habilita a criação automática de arquivos de configuração quando utilizada a funcionalidade de Gerenciamento de Config.  Define a quantidade de Schemas que serão guardados em cache.
  • Tipo:  BooleanNumeric
  • Default: True100
  • Exemplo: 

    Bloco de código
    languagexml
    <add key="ConfigAutoGenerate DBSchemaCacheMaxSize" value="true123" />

...


DBSCommandTimeout

  • Descrição: Tem como objetivo definir um único arquivo de configuração a ser utilizado por todos os aplicativos do ambiente. 
  • Tipo: String
  • Default: Vazio
  • Define o tempo máximo que uma Consulta SQL pode levar antes de retornar erro de timeout, em segundos.
  • Tipo: Numeric
  • Default:120Observações: Para mais informações acesse o link: Gerenciador de Config.
  • Exemplo:

    Bloco de código
    languagexml
    <add key="ConfigPathDBSCommandTimeout" value="\\PastaCompartilhadaNaRede600" />

...

DBSConnStrExtensions

  • Descrição: Define a quantidade de Schemas que serão guardados em cache Acrescenta extensões à string de conexão atualmente em uso.
  • Tipo:NumericDefault: 100 String
  • Default: Vazio
  • Observações: Para alterar o timeout de comandos nativos do SQL, tal qual Rollback, esta tag deve ser utilizada, ao invés da tag DBSCommandTimeout
  • Exemplo:

    Bloco de código
    languagexml
    <add key="DBSchemaCacheMaxSizeDBSConnStrExtensions" value="123;Min Pool Size=5;Max Pool Size=30;" />

...


DefaultDB

  • Descrição: Define o tempo máximo que uma Consulta SQL pode levar antes de retornar erro de timeout, em segundos.
  • Tipo: Numeric
  •  Banco de dados default para qualquer operação que possa vir a ser realizada antes do momento do login, quando o banco de dados definitivo é definido. Essencial para o uso de APIs
  • Tipo: String
  • Default: CorporeRMDefault:120
  • Exemplo:

    Bloco de código
    languagexml
    <add key="DBSCommandTimeoutDefaultDB" value="600CorporeRM12133" />

...

DisableCompression

  • Descrição: Acrescenta extensões à string de conexão atualmente em uso. Desabilita compressão de dados em WCF
  • Tipo: String Boolean
  • Default: Vazio falseObservações: Para alterar o timeout de comandos nativos do SQL, tal qual Rollback, esta tag deve ser utilizada, ao invés da tag DBSCommandTimeout
  • Camada: 

    VersãoCamada
    Até 12.1.33Client e Server
    12.1.34 e SuperioresServer
  • Exemplo:

    Bloco de código
    languagexml
    <add key="DBSConnStrExtensionsDISABLECOMPRESSION" value=";Min Pool Size=5;Max Pool Size=30;true" />

DefaultDB

  • Descrição: Banco de dados default para qualquer operação que possa vir a ser realizada antes do momento do login, quando o banco de dados definitivo é definido. Essencial para o uso de APIs
  • Tipo: String
  • Default: CorporeRM
  • Exemplo:

    Bloco de código
    languagexml
    <add key="DefaultDB" value="CorporeRM12133" />

DisableCompression

EnableSecurity

  • Descrição: Determina se a comunicação WCF utilizará a segurança da camada de transporte garantida por certificados e se permitirá que credenciais sejam enviadas aos serviços. Ao determinar esta tag como true, suas respectivas tags de parametrização também precisam ser configuradas, são elas: CertificateFindValue, CertificateFindType, CertificateStoreName, CertificateStoreLocation, que basicamente definem onde e como encontrar o certificado adequado.
  • Tipo: Boolean
  • Default: False
  • Observações: para mais informações, acessar: HabilitarHabilitar SSL/TLS no HostSSL/TLS no Host
  • Descrição: Desabilita compressão de dados em WCF
  • Tipo: Boolean
  • Default: false
  • Camada: 

    VersãoCamada
    Até 12.1.33Client e Server
    12.1.34 e SuperioresServer
  • Exemplo: 

    Bloco de código
    languagexml
    <add key="DISABLECOMPRESSIONEnableSecurity" value="true" />

EnableSecurity

  •  />

Host

  • Descrição: Nome da máquina em que o host está sendo executado (não recomendável pois acrescenta o overhead de ir ao DNS). O ideal é informar o IP diretamente.
  • Tipo: String
  • Default: localhost
  • Exemplos:

  • Descrição: Determina se a comunicação WCF utilizará a segurança da camada de transporte garantida por certificados e se permitirá que credenciais sejam enviadas aos serviços. Ao determinar esta tag como true, suas respectivas tags de parametrização também precisam ser configuradas, são elas: CertificateFindValue, CertificateFindType, CertificateStoreName, CertificateStoreLocation, que basicamente definem onde e como encontrar o certificado adequado.
  • Tipo: Boolean
  • Default: False
  • Observações: para mais informações, acessar: HabilitarHabilitar SSL/TLS no HostSSL/TLS no Host
  • Camada: 

    VersãoCamadaAté 12.1.33Client e Server12.1.34 e SuperioresServer

    Exemplo: 

    Bloco de código
    languagexml
    titleUtilizando nome da máquina
    <add key="EnableSecurityHost" value="truelocalhost" />
    Bloco de código
    languagexml
    titleUtilizando IP
    <add key="Host

...

  • " value="10.31.8.91" />

HttpPort

  • Descrição: Porta utilizada pela comunicação WCF quando o protocolo de comunicação for HTTP. Tanto o Server quanto o Client devem estar configurados sempre na mesma porta, para que possam se comunicar corretamente.
  • Tipo: Numeric
  • Default: 8051
  • Exemplo

  • Descrição: Nome da máquina em que o host está sendo executado (não recomendável pois acrescenta o overhead de ir ao DNS). O ideal é informar o IP diretamente.
  • Tipo: String
  • Default: localhost
  • Exemplos:

    Bloco de código
    languagexmltitleUtilizando nome da máquina
    <add key="HostHttpPort" value="localhost8051" />


JobServer3Camadas

  • Descrição: Informa se a aplicação está trabalhando em três camadas. Deve ter o mesmo valor tanto nos config's dos Clients quanto do Host.
  • Tipo: Boolean
  • Default: true
  • Exemplo:

    Bloco de código
    languagexmltitleUtilizando IP
    <add key="HostJobServer3Camadas" value="10.31.8.91"true" />

...

JWTRefreshTokenExpireMinutes

  • Descrição: Porta utilizada pela comunicação WCF quando o protocolo de comunicação for HTTP. Tanto o Server quanto o Client devem estar configurados sempre na mesma porta, para que possam se comunicar corretamente Define a duração do refresh token, em minutos. Pode ser configurada entre 1 e 129600minutos.
  • Tipo: Numeric Numeric
  • Default: 8051 960
  • Exemplo:

    Bloco de código
    languagexml
    <add key="HttpPortJWTRefreshTokenExpireMinutes" value="123460" />

...

JWTTokenExpireMinutes

  • Descrição: Informa se a aplicação está trabalhando em três camadas. Deve ter o mesmo valor tanto nos config's dos Clients quanto do Host Define a duração do access token, em minutos. Pode ser configurada entre 1 e 43200minutos.
  • Tipo: Boolean Numeric
  • Default: true 5
  • Exemplo:

    Bloco de código
    languagexml
    <add key="JobServer3CamadasJWTTokenExpireMinutes" value="true30" />

LdapProvider

  • Descrição: Possível provider que irá responder por operações relacionadas a autenticação caso exista a integração LDAP.
  • Tipo: String
  • Default: Vazio

...

  • Descrição: Define o endereço base dos serviços HTTP(SOAP) que serão expostos pelo Host.
  • Tipo: String
  • Default: host:portahost:porta
  • Exemplo:

    Bloco de código
    languagexml
    <add key="ServicesBaseUrl" value="https://meuservicoexposto.com.br" />

SubdomainMask

  • Descrição: Tag responsável por realizar a tenantização dos serviços do RM.
  • Tipo: String
  • Default: vazia
  • Exemplo:

    Bloco de código
    languagexml
    <add key="ServicesBaseUrl" value=""SubDomainMask" value="[ALIAS].totvscloud.com.br" />



    Onde [ALIAS] é tratado como uma variável onde será sobrescrito com o nome de um Alias do banco de dados cadastrado ao inicializar os serviços do sistema, para mais informações sobre tenantização acesse o TDN https://tdn.totvs.com/x/XYu9Mg.


    Aviso
    titleAtenção

    É imprescindível que a variável [ALIAS] esteja presente no valor da tag, pois é este valor que será sobrescrito pelo nome do Alias de banco de dados.

    meuservicoexposto.com.br" />

TcpPort

  • Descrição: Porta utilizada pela comunicação WCF quando o protocolo de comunicação for TCP. Tanto o Server quanto o Client devem estar configurados sempre na mesma porta, para que possam se comunicar corretamente.
  • Tipo: Numeric
  • Default: 8050
  • Exemplo:

    Bloco de código
    languagexml
    <add key="TcpPort" value="4321" />

...

  • Descrição: Indica se o sistema guardará em cache os esquemas obtidos pelas consultas.
  • Tipo: Boolean
  • Default: false
  • Observações: Pode ser utilizado na Configuração N camadas, conforme informações em Configuração N Camadas
  • Exemplo: 

    Bloco de código
    languagexml
    <add key="UseDbSchemaCache" value="true" />

UseRMUser

  • Descrição: Descrição: Indica se o sistema guardará em cache as informações de segurança estendida obtidas a cada verificaçãoDetermina o uso de um usuário do RM para fazer login no RM.Atualizador e RM.TotvsAudit, quando adicionado no respectivo arquivo config.
  • Tipo: Boolean
  • Default: false
  • Exemplo:

    Bloco de código
    languagexml
    <add key="UseRMUser" value="true" />

UseSecurityExtCache

  • RM.TotvsAudit, quando adicionado no respectivo arquivo config.
  • Tipo:  Boolean
  • Default: falseObservações: para mais informações: Segurança Estendida false
  • Exemplo:

     

    Bloco de código
    languagexml
    <add key="UseSecurityExtCacheUseRMUser" value="true" />

ALLOWASSEMBLYSIGNCHECK

  • Descrição: Permite que os assemblies carregados pelo host tenham sua assinatura validada. Caso exista algum assembly que esteja com sua assinatura inválida, o host automaticamente o bloqueará e bloqueará todas as outras chamadas consequentes.
  •  />

UseSecurityExtCache

  • Descrição: Indica se o sistema guardará em cache as informações de segurança estendida obtidas a cada verificação.
  • Tipo: Boolean
  • Default: false
  • Observações: para mais informações: Segurança Estendida
  • Tipo: Booleano
  • Default:False
  • Exemplo: 
  • Exemplo:

    Bloco de código
    languagexml
    <add key="ALLOWASSEMBLYSIGNCHECKUseSecurityExtCache" value="true" />

WcfProtocol

...