com.EBS.Common.Domain.Shared 1.6.7.14

EBS.Common

I.Configuration

1.application.json

{
    "App": {
        "SelfUrl": "https://xxx.xx",
        "CorsOrigins":"AllowAll,https://xxx.xx",
        "AppUrlOptions":{
            "RedirectAllowedUrls":"https://xxx.xx,https://yyy.yy",
            "Applications": {
                "MVC": {
                    "RootUrl": "http://xx:8080",
                    "Urls": {
                        "Abp.Account.PasswordReset": "account/reset-password"
                    }
                },
                "Angular": {
                    "RootUrl": "http://xx:8080",
                    "Urls": {
                        "Abp.Account.PasswordReset": "account/reset-password"
                    }
                }
            },
        },
        "OpenIddictServerSetting": {
          "IsEnableAutherServer": true,
          "AccessTokenLifetime": 60,
          "RefreshTokenLifetime": 20_160,
          "SigningCertificate": {
            "Path": "xxx\\SigningCertificate.pfx",
            "Password": "anypass",
            "DistinguishedName":"CN=EBS Signing Certificate",
            "KeyStorageFlags": "MachineKeySet, PersistKeySet, Exportable",//X509KeyStorageFlags
            "ExpireDay": 3_650,
            "KeySizeInBits": 4_096
          },
          "EncryptionCertificate": {
            "Path": "xxx\\EncryptionCertificate.pfx",
            "Password": "anypass",
            "DistinguishedName":"CN=EBS Encryption Certificate",
            "KeyStorageFlags": "MachineKeySet, PersistKeySet, Exportable",//X509KeyStorageFlags
            "ExpireDay": 3_650,
            "KeySizeInBits": 4_096
          }
        }
    },
    "ConnectionStrings": {
        "Encrypted.Default": "xxx",
        "Encrypted.HangfireConnection": "xxx",
        "Encrypted.connect-name": "xxx"
    },
    "Settings":{
        "IsEnableHangfireServer": true,
        "BackgroundJob":{
            "IsEnable": true,
            "JobPollPeriod": 30000,
            "MaxJobFetchCount": 200
        },
        "MappedConnections": {
            "connect-name":["map-name-1","map-name-2"]
        },
        "DistributedLock":{
            "KeyPrefix":"EbsApplication"
        },
        "DistributedCache":{
            "KeyPrefix":"EbsApplication"
        },
        "DataProtection":{
            "ApplicationName":"ebsApplication",
            "PersistKeys":"ebs-service-Protection-Keys",
            "PathFolder": string?
        },
        "ForwardedHeadersOptions": {
          "ForwardedHeaders": null, // Docker/k8s prefer= "XForwardedFor, XForwardedProto, XForwardedHost" => .well-known/openid-configuration.jwks_uri = https ; use "app.UseForwardedHeaders();"
          "ClearKnownNetworksProxies":null// true => .well-known/openid-configuration.jwks_uri = https ; use "app.UseForwardedHeaders();"
        },
        "TokenX509MfaOption": {
            "MaxTimeoutSecond": 90
        }
    },
    "Redis":{
        "IsEnabled": false,
        "Encrypted.Configuration":"xxxxx", // or "Configuration"
        "ApplicationName":"ebsApplication",
        "IsSentinel": false,
        "ServiceName": string?
    },
    "WebPages":{
        "ButtonResourceName":"IShopEBS"
    },
    "Swagger": {
        "IsActive": true,
        "IsWithOAuth": true,
        "LastIsAll": true,
        "XmlFileName": "abc.xml",
        "Scopes": {
            "IShopEBS": "EBS API"
        },
        "Docs":{
            "DocName1":{ // is Microsoft.OpenApi.Models.OpenApiInfo
                "Title": "All Api"
            }
        }
    },
    "AuthServer":{
        "SwaggerClientId":"SwaggerDev",
        "Authority":"https://xxxx.com"
    },
    "Minio":{
        "Endpoint":"xxx",
        "AccessKey": "[Optional]",
        "SecretKey": "[Optional]",
        "HealthChecks": true,
        "Secure": true,
        "Encrypted.AccessKey": "[Optional]",
        "Encrypted.SecretKey": "[Optional]"
    },
    "ApplicationFileOptions": {
        "key": "value"
    },
    "Templates":{
        "Items" :{
            "key1":{
                "StoreName": "abc"
            }
        }
    },
    "Integrations":{
        "VMG":{
            "BrandNameDefault":"EBS",
            "ApiSendSMS":"https://api.brandsms.vn/api/SMSBrandname/SendSMS",
            "Token":xxx,
            "MaxLengthMessage": 612
        }
    }
}

II.Modules and Handlers

Use AttachTokens

Sử dụng để attach sso-id vào header request , không cần add access_token khi gọi api từ web/host đến authserver và service

1. AuthServer DependsOn AttachTokenAuthServerModule
2. Web/Host DependsOn AttachTokenServiceModule

CommonApplicationModule

Config redis, distributed cache, distributed lock, data protection, forwarded headers, token x509 mfa option...

CommonWebModule

Config swagger, authserver, cors...

DefaultHtml2PdfRenderModule

Generate Html → pdf, email body... Use IHtml2PdfRender, ISignHandler

1. Set CertContainer
2. Default Folder BankEncrypt
3. Copy file in font to Environment.CurrentDirectory/Exports/Fonts
4. Text-Template in ContentRootPath/Exports/host/text-template/<template-name>/<language>.html ; Default en.html

EBSMinioBlobModule

Store Blob on Minio

1. Imp IFileStore
2. Config IOptions<ContainerTypeDefaultOption>

GenerateEmailingHandler

Generate email body and attach file (pdf, excel, word...) to email

1. Impl + Add Service: IEmailingStoreRepository
2. Impl + Add service: IGenerateEmailingGetFileDataHandler
3. context.Services.AddTransient<IGenerateEmailingHandler, GenerateEmailingHandler>();

EbsMailGunApiModule

Send mail via MailGun API replace IEmailSender= MailGunApiEmailSender

EInvoiceVnptModule

Use e-Invoice by VNPT provider

IEInvoiceVnptHandler

GenerateCodeModule

Generate code (no-duplicate) for entity. Use

1. IGenerateCodeManager, 
2. ICacheShowroomNameHandler

VMGSmsModule

Send sms via VMG provider

IVMGConnectHandler

ExportExcelWorker

Export data to excel file Use:

1. IExportExcelWorker

III.Services

TextTemplateDefinition

Use

1. IRepository<TextTemplateDefinition, Guid> repository,
2. IRepository<TextTemplateDefinitionHistory, Guid> repositoryHis,