App Builder 
      
    
      
      
        App_Builder 
      
    
   
Configuração de inicialização no Jitterbit App Builder 
Introdução 
Esta página descreve os parâmetros e métodos de configuração de inicialização do App Builder. Cada seção é o esquema de nível superior para o método de configuração do formulário JSON (appsettings.json).
Quando o App Builder é iniciado, ele obtém seus valores de configuração de qualquer uma das seguintes fontes, em ordem de precedência:
Variáveis de ambiente do sistema. 
Um arquivo JSON appsettings.json do ASP.NET Core . 
Um arquivo XML connection.xml com um elemento <ConnectionInfo>. 
 
As variáveis de ambiente do sistema são os esquemas JSON, sub-esquemas (se houver) e chaves separados por dois caracteres de sublinhado. Não há um arquivo appsettings.json padrão. Você pode criar um no diretório de instalação usando os exemplos em C:\inetpub\wwwroot\App Builder\ (Windows) ou no subdiretório samples (Linux), muitos dos quais estão reproduzidos nesta página.
Como exemplo, os seguintes métodos de configuração fornecem valores equivalentes:
Variáveis de ambiente ConnectionInfo__DatabaseType = SQLServer 
ConnectionInfo__HostName = localhost 
ConnectionInfo__DatabaseName = App Builder 
ConnectionInfo__UserName = vinyl 
ConnectionInfo__Password = P@5$w0rD 
arquivo appsettings.json { 
   "ConnectionInfo" :   { 
     "DatabaseType" :   "SQLServer" , 
     "HostName" :   "localhost" , 
     "DatabaseName" :   "App Builder" , 
     "UserName" :   "vinyl" , 
     "Password" :   "P@5$w0rD" 
   } 
} 
arquivo connection.xml <ConnectionInfo   DatabaseType= "MySQL"   HostName= "localhost"   DatabaseName= "App Builder"   UserName= "vinyl"   Password= "P@5$w0rD" /> 
AiServices
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
AiServicesOpenAiEsquema 
Opções do OpenAI. 
 
 
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
OpenAiApiKeyString 
Chave da conta API do OpenAI. 
 
TimeoutInteiro 
Tempo limite HTTP (segundos). 
 
 
Exemplos 
JSON { 
   "AiServices" :   { 
     "OpenAi" :   { 
       "ApiKey" :   "[OpenAiKey]" , 
       "Timeout" :   300 
     } 
   } 
} 
BackgroundService
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
BackgroundServiceDisableSchedulerBoolean 
Defina como true para desativar o [agendador de serviços em segundo plano]. 
 
 
Exemplos 
JSON { 
   "BackgroundService" :   { 
     "DisableScheduler" :   true 
   } 
} 
Variável de ambiente BackgroundService__DisableScheduler = true 
ConnectionInfo
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
ConnectionInfoDatabaseTypeString 
Tipo de banco de dados: SQLServer, MySQL, PostgreSql 
 
HostNameString 
Nome do host ou endereço IP do servidor de banco de dados. 
 
PortInteiro 
Número da porta do servidor de banco de dados. 
 
InstanceNameString 
Nome da instância do servidor de banco de dados. 
 
TenantNameString 
Para uso interno.  
DatabaseNameString 
Nome do banco de dados do App Builder. 
 
UserNameString 
Nome de usuário do banco de dados do App Builder. 
 
PasswordString 
Senha do banco de dados do App Builder. 
 
ConnectionTimeoutInteiro 
Tempo limite de conexão com o banco de dados (segundos). 
 
CommandTimeoutInteiro 
Tempo limite de comando do banco de dados (segundos). 
 
MaxPoolSizeInteiro 
Número máximo de conexões de banco de dados no pool. 
 
AdvancedArray de objetos 
Pares chave/valor adicionais da string de conexão. 
 
 
Exemplos 
{ 
   "ConnectionInfo" :   { 
     "DatabaseType" :   "SQLServer" , 
     "HostName" :   "localhost" , 
     "DatabaseName" :   "App Builder" , 
     "UserName" :   "App Builder" , 
     "Password" :   "password" , 
     "Advanced" :   "MultiSubnetFailover=true;TrustServerCertificate=true;" 
   } 
} 
DataEncryptionA seção DataEncryption configura o armazenamento e a criptografia da Chave de Criptografia de Dados (DEK).
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
DataEncryptionCertificateString 
Certificado X.509 codificado em Base64, PKCS#12 (PFX). 
 
CertificatePasswordString 
Senha do certificado X.509. 
 
CertificateThumbprintString 
Impressão digital do certificado X.509. 
 
DirectoryString 
Caminho do diretório do sistema de arquivos. 
 
ImportString 
Políticas de armazenamento e criptografia para importação de DEKs. 
 
KeyEncryptionString 
Estratégia de criptografia de dados: Certificate: política de criptografia de certificado X.509.Kms: política de criptografia de chave AWS KMS.None: Nenhuma política de criptografia de chave. As chaves são armazenadas em texto simples.Null: Política de criptografia de chave de passagem. As chaves são armazenadas em texto simples.  
 
KeyStorageString 
Localização de armazenamento da chave de criptografia de dados:Database: banco de dados do App Builder.FileSystem: sistema de arquivos.ParameterStore: AWS System Manager Parameter Store.S3: bucket S3. 
 
KmsKeyIdString 
ARN da chave AWS KMS. 
 
ParameterNamePrefixString 
Prefixo do nome do parâmetro do AWS System Manager Parameter Store. 
 
S3BucketEndpointString 
Endpoint do bucket S3. 
 
S3KeyPrefixString 
Prefixo da chave S3. 
 
 
Exemplos 
{ 
   "DataEncryption" :   { 
     "KeyEncryption" :   "Certificate" , 
     "CertificateThumbprint" :   "a909502dd82ae41433e6f83886b00d4277a32a7b" , 
     "Certificate" :   "{base64-pfx-data}" , 
     "CertificatePassword" :   "your-certificate-password" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyEncryption" :   "Kms" , 
     "KmsKeyId" :   "{kms-key-arn}" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyEncryption" :   "None" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyEncryption" :   "Null" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyStorage" :   "Database" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyStorage" :   "FileSystem" , 
     "Directory" :   "C:\\Path\\To\\Keys" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyStorage" :   "ParameterStore" , 
     "ParameterNamePrefix" :   "/production" 
   } 
} 
{ 
   "DataEncryption" :   { 
     "KeyStorage" :   "S3" , 
     "S3BucketEndpoint" :   "https://{bucket}.s3{-aws-region}.amazonaws.com" , 
     "S3KeyPrefix" :   "production" 
   } 
} 
KestrelA seção Kestrel configura o servidor web Kestrel.
Schema 
Key 
Value Type 
Description 
 
 
KestrelLimitsMaxRequestBodySizeVeja a Kestrel documentation  para uma lista de opções suportadas. 
 
 
LicenseA seção License especifica a chave de licença do App Builder.
Schema 
Key 
Value Type 
Description 
 
 
LicenseLicenseKeyString 
Uma versão codificada em base64 do seu arquivo vinyl.lic. 
 
 
Examples 
{ 
   "License" :   { 
     "LicenseKey" :   "TWF1cmlzIGFjIGZlbGlzIHZlbCB2ZWxpdCB0cmlzdGlxdWUgaW1wZXJkaWV0LiAgTnVsbGFtIGV1IGFudGUgdmVsIGVzdCBjb252YWxsaXMgZGlnbmlzc2ltLiAgRnVzY2Ugc3VzY2lwaXQsIHdpc2kgbmVjIGZhY2lsaXNpcyBmYWNpbGlzaXMsIGVzdCBkdWkgZmVybWVudHVtIGxlbywgcXVpcyB0ZW1wb3IgbGlndWxhIGVyYXQgcXVpcyBvZGlvLiAgTnVuYyBwb3J0YSB2dWxwdXRhdGUgdGVsbHVzLiAgTnVuYyBydXRydW0gdHVycGlzIHNlZCBwZWRlLiAgU2VkIGJpYmVuZHVtLiAgQWxpcXVhbSBwb3N1ZXJlLiAgTnVuYyBhbGlxdWV0LCBhdWd1ZSBuZWMgYWRpcGlzY2luZyBpbnRlcmR1bSwgbGFjdXMgdGVsbHVzIG1hbGVzdWFkYSBtYXNzYSwgcXVpcyB2YXJpdXMgbWkgcHVydXMgbm9uIG9kaW8uICBQZWxsZW50ZXNxdWUgY29uZGltZW50dW0sIG1hZ25hIHV0IHN1c2NpcGl0IGhlbmRyZXJpdCwgaXBzdW0gYXVndWUgb3JuYXJlIG51bGxhLCBub24gbHVjdHVzIGRpYW0gbmVxdWUgc2l0IGFtZXQgdXJuYS4gIEN1cmFiaXR1ciB2dWxwdXRhdGUgdmVzdGlidWx1bSBsb3JlbS4gIEZ1c2NlIHNhZ2l0dGlzLCBsaWJlcm8gbm9uIG1vbGVzdGllIG1vbGxpcywgbWFnbmEgb3JjaSB1bHRyaWNlcyBkb2xvciwgYXQgdnVscHV0YXRlIG5lcXVlIG51bGxhIGxhY2luaWEgZXJvcy4gIFNlZCBpZCBsaWd1bGEgcXVpcyBlc3QgY29udmFsbGlzIHRlbXBvci4gIEN1cmFiaXR1ciBsYWNpbmlhIHB1bHZpbmFyIG5pYmguICBOYW0gYSBzYXBpZW4uCg==" 
   } 
} 
PackagingEsta seção permite que administradores configurem o local de armazenamento do pacote. Existem três opções: um banco de dados (o padrão), o sistema de arquivos ou um bucket AWS S3.
Schema 
Key 
Value Type 
Description 
 
 
PackagingPackageStoreString 
O tipo de armazenamento, um de Database, FileSystem ou S3. 
 
S3BucketEndpointString 
Para armazenamento S3, a [URL do endpoint do bucket]. 
 
S3KeyPrefixString 
Para armazenamento S3, o [prefixo da chave do bucket]. 
 
DirectoryString 
Para FileSystem, o caminho completo para o armazenamento. Se não fornecido, o diretório de dados padrão é utilizado. 
 
 
Exemplos 
Armazenamento de banco de dados { 
   "Packaging" :   { 
     "PackageStore" :   "Database" 
   } 
} 
Armazenamento em sistema de arquivos { 
   "Packaging" :   { 
     "PackageStore" :   "FileSystem" , 
     "Directory" :   "C:\\Packages" 
   } 
} 
Armazenamento S3 { 
   "Packaging" :   { 
     "PackageStore" :   "S3" , 
     "S3BucketEndpoint" :   "https://my-aws-domain.s3.us-east-1.amazonaws.com" , 
     "S3KeyPrefix" :   "vinyl/" 
   } 
} 
PostgreSQL
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
PostgreSQLLogging 
OpenTelemetry 
 
ReverseProxyA seção ReverseProxy configura um proxy reverso.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
ReverseProxyForwardedClientIpHeaderString 
Cabeçalho HTTP que encaminha o endereço IP original do cliente. 
 
ForwardedSchemeHeaderString 
Cabeçalho HTTP que encaminha o esquema original. 
 
ForwardedHostHeaderString 
Cabeçalho HTTP que encaminha o host original e a porta opcional. 
 
ForwardedPortHeaderString 
Cabeçalho HTTP que encaminha a porta original. 
 
 
Exemplos 
{ 
   "ReverseProxy" :   { 
     "ForwardedClientIpHeader" :   "X-Forwarded-For" , 
     "ForwardedSchemeHeader" :   "X-Forwarded-Proto" , 
     "ForwardedHostHeader" :   "X-Forwarded-Host" 
   } 
} 
{ 
   "ReverseProxy" :   { 
     "ForwardedClientIpHeader" :   "X-Forwarded-For" , 
     "ForwardedSchemeHeader" :   "X-Forwarded-Proto" , 
     "ForwardedPortHeader" :   "X-Forwarded-Port" 
   } 
} 
SegurançaA seção Segurança configura contas de usuário do App Builder e provedores de segurança.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
SegurançaAdministratorEsquema 
Opções da conta de administrador. 
 
InvitationUrlString 
Para uso interno.  
LocalAuthenticationEsquema 
Opções do provedor de segurança de usuário local. 
 
ProviderString 
Configuração do provedor de segurança  codificada em Base64. 
 
ProvidersArray de strings 
configuração do provedor de segurança codificada em Base64. 
 
AuthenticationExpiryInteiro 
Expiração do token de autenticação, em minutos. 
 
 
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
AdministratorAllowLocalAuthenticationBoolean 
Habilita a autenticação de usuário local. 
 
ChangePasswordOnLoginBoolean 
Força o usuário a mudar a senha no login. 
 
DefaultPasswordString 
Senha padrão. Aplicada uma vez na instalação. 
 
PasswordString 
Senha. Aplicada cada vez que o sistema inicia. 
 
 
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
LocalAuthenticationEnabledBoolean 
Habilita o provedor de segurança. 
 
ShowOnLoginFormBoolean 
Determina se o provedor de autenticação de usuário aparece no formulário de login. 
 
 
Exemplos 
{ 
   "Security" :   { 
     "Administrator" :   { 
       "Password" :   "s3cr3t" , 
       "ChangePasswordOnLogin" :   false 
     }, 
     "LocalAuthentication" :   { 
       "ShowOnLoginForm" :   false 
     }, 
     "Provider" :   "Tm90aGluZyBjYW4gY29tZSBvZiBub3RoaW5nLCBzcGVhayBhZ2Fpbi4=" 
   } 
} 
ScriptingA seção Scripting configura o SDK de script C# do App Builder.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
ScriptingEnabledBoolean 
Habilita scripts em C#. 
 
 
Exemplos 
{ 
   "Scripting" :   { 
     "Enabled" :   false 
   } 
} 
SharedStateA seção SharedState configura o serviço de estado compartilhado que suporta implantações em múltiplos servidores.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
SharedStateProviderString 
Provedor de estado compartilhado: InProcess: O estado é armazenado em processo para implantações em servidor único.Redis: O estado é armazenado no Redis para implantações em múltiplos servidores.  
 
RedisConnectionStringString 
String de conexão do Redis. 
 
RedisPrefixString 
Prefixo da chave do Redis. 
 
 
Exemplo 
{ 
   "SharedState" :   { 
     "Provider" :   "Redis" , 
     "RedisConnectionString" :   "localhost:6379" 
   } 
} 
SignalRA seção SignalR configura as comunicações entre cliente e servidor.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
SignalRLongPollingTimeoutString 
Tempo limite de long polling, especificado usando um formato de TimeSpan00:00:30. 
 
TransportsString 
Lista delimitada por vírgulas de tipos de transporte HTTP : LongPolling: Long-polling.None: Sem transportes. NÃO SUPORTADO.ServerSentEvents: Eventos enviados pelo servidor.WebSockets: WebSockets . 
 
 
Exemplos 
{ 
   "SignalR" :   { 
     "Transports" :   "WebSockets,LongPolling" , 
     "LongPollingTimeout" :   "00:00:30" 
   } 
} 
SiteA seção Site configura o endereço do site do App Builder e os aliases conhecidos.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
SiteUrlString 
URL canônica do site. 
 
DefaultBoolean 
Tratar como o site padrão. 
 
RedirectBoolean 
Redirecionar clientes para a URL do site. 
 
RedirectIfHeaderExistsString 
Cabeçalho HTTP que indica que os clientes devem ser redirecionados. 
 
AllowCrossOriginBoolean 
Permitir solicitações de origem cruzada. 
 
AliasesArray de String 
Aliases do site. 
 
 
Exemplos 
{ 
   "Site" :   { 
     "Url" :   "https://example.com/Vinyl" , 
     "Default" :   true , 
     "Redirect" :   true , 
     "RedirectIfHeaderExists" :   "X-Forwarded-For" , 
     "Aliases" :   [ 
       { 
         "Url" :   "https://vinyl.example.com" 
       } 
     ] 
   } 
} 
Sku
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
SkuSkuString 
 
 
TlsA seção Tls configura o suporte ao protocolo TLS.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
TlsSecurityProtocolString 
Lista delimitada por vírgulas de protocolos de segurança : Tls12: TLS 1.2Tls13: TLS 1.3  
 
 
Exemplos 
{ 
   "Tls" :   { 
     "SecurityProtocol" :   "Tls,Tls11,Tls12" 
   } 
} 
UrlRewriteA seção UrlRewrite configura o suporte à reescrita de URL.
Esquema 
Chave 
Tipo de Valor 
Descrição 
 
 
UrlRewriteOriginalUrlHeaderString 
Cabeçalho HTTP que encaminha a URL original. 
 
 
Exemplos 
{ 
   "UrlRewrite" :   { 
     "OriginalUrlHeader" :   "X-Original-URL" 
   } 
}