Skip to main content

46 docs tagged with "configuration"

View all tags

Application configuration

This page covers global application configuration: display name, environment, logos, button behavior, field reset, About page, default HTTP format, and global LgGridView options.

appSettings.json files

The installed application is configured in the appsettings.json file of the Server project.

Change History

The Tracked Changes system records additions, deletions, and modifications of EF Core entities in a Lagoon application.

Client-side configuration

Lagoon client application (Blazor WebAssembly) configuration is distributed across four locations depending on the nature of the setting.

Cloud Storage

Inherited content from the old documentation, pending rewrite.

Content Security Policy

Lagoon generates the HTTP Content-Security-Policy header from the application's public URL and the Lagoon:CSP section of the appsettings.json file.

Data import and export

The Batch project's import/export command lets you export data from a database to a file, then import it into another database.

Date & Number Formats

Date and number formats are configured in the application's Main class by overriding OnInitCulture.

JavaScript Interoperability

JavaScript interoperability allows a Lagoon Blazor page or component to call JavaScript code, or to receive a callback from JavaScript.

Lagoon Console Applications

A Lagoon Batch application is a .NET console application that starts with LagoonConsoleApplication.Run<Main>(args).

Lagoon EF Core contexts

Lagoon provides EF Core base classes that integrate ASP.NET Identity, the framework's internal entities, and application conventions.

Loading spinner

Choose and customize the loading spinner of a Lagoon application from the client main.scss, with the gallery of available spinners.

Logout

Lagoon logout removes the access token from client browser storage and prevents its renewal from the refresh token.

Mail Sending

Mail sending is performed from the Server project, for example from a controller or server service.

Menu configuration

Menu configuration is done in a dedicated component of the Client project, typically Shared/MenuConfiguration.razor.

Message Logging

Message logging is configured in the appsettings.json file of the Server project.

MessagePack serialization

Lagoon uses MessagePack to reduce the size of the data exchanged between the Blazor WebAssembly client and the ASP.NET Core server, while keeping the process transparent for the developer.

Offline mode

Offline mode relies on the Blazor/Lagoon Service Worker and caching of resources required by the application.

OpenID Connect

Lagoon exposes an AddOidc extension method to register an OpenID Connect provider on the server side.

Running over HTTP instead of HTTPS

If the application must run over HTTP, modify the Lagoon:PublicUrl URL in the appsettings.json file of the Server project to replace https:// with http://.

SAML2 authentication

This page covers the SAML2 configuration of a Lagoon application and the associated ADFS settings.

Secrets and configuration placeholders

Store secrets outside the repository (dotnet user-secrets in development, environment variables or vault in production), share the UserSecretsId between the server, batch and dotnet ef via Directory.Build.props, and reference them in the configuration with ${Key} placeholders.

Server-side HTML sanitization

The LgHtmlSanitizer service from Lagoon.Server removes scripts, event handlers, dangerous URLs, and forms from HTML content before it is displayed to users.

Stateless Users

With UserStorage = None, an SSO or Windows login neither writes user nor token to the database: the user's identity only lives in the cookie and tokens.

Static file compression

Lagoon publishes static files only in Brotli format, which is negotiated only over HTTPS. If the application must run over HTTP, add LagoonDefaultCompression to the solution's Directory.Build.props file.

Themes and styles

Customize styles of a Lagoon application: client SCSS files, variable overrides, and offering multiple themes for the user to choose from.

Users, roles and policies

Lagoon recommends using policies to express authorizations, based on roles or custom claims (AuthenticationOptions.AccessTokenClaims).

Windows authentication and special cases

Windows authentication is enabled server-side and requires configuring the execution environment, notably in development with IIS Express or when publishing to IIS.