Configuration
Configure database access, the backend API, authentication, RecroSec, and the client connection for your RecroGrid Framework application. Use the guides below to find the settings relevant to your task and application model.
If you are creating your first application, start with Getting Started for a complete setup workflow.
What do you need to configure?
| Task | What to configure | Guide |
|---|---|---|
| Connect to a database | Set up the database connection used by your application. | Database Settings |
| Integrate Entity Framework | Configure the data context for RecroGrid Framework data access. | Entity Framework |
| Initialize the backend API | Register RecroGrid Framework services and configure the API startup pipeline. | API Configuration |
| Configure backend API authentication | Configure JWT bearer and OpenID Connect validation in the backend API. | Backend API Authentication |
| Configure client authentication | Connect the client to a host-managed session or configure browser-based sign-in, depending on your application model. | SessionAuth or Blazor WebAssembly Authentication |
| Configure RecroSec | Configure the RecroSec authorization system settings. | RecroSec Configuration |
| Connect the client to the API | Route requests through the host proxy or call the backend API directly from the browser. | Proxy-based API Access or Direct API Access |
| Coordinate server configuration | Review how API setup, database access, and host-side proxy configuration fit together. | Server |
| Configure the client | Find the client setup that matches your application's authentication and API access model. | Client |
Configuration by application model
Both Blazor-based application models require a backend API with API Configuration, Backend API Authentication, and Data Access configured. The client-side authentication and API access settings depend on how the browser connects to that backend:
- Server-side Application: the Blazor host manages sign-in and the authenticated session, and forwards API requests to the backend. Use SessionAuth for the interactive client's session integration and Proxy-based API Access for API connectivity.
- Blazor WebAssembly Application: the standalone browser client handles sign-in and calls the backend API directly. Use Blazor WebAssembly Authentication and Direct API Access.
RecroSec settings are shared at the application configuration level and are documented under RecroSec Configuration.
For an architectural comparison and help choosing a model, see Application Models.
Existing MVC applications
For an existing MVC-based application, use ASP.NET Core MVC Integration. For new applications, follow one of the Blazor-based workflows in Getting Started.