Platform Dev. Guide - Configuration

Owned by Ian Christopher (Deactivated)
Jun 10, 2019
2 min read

Like most web applications, the Ed-Fi ODS / API has several configuration settings. Some configuration values, such as database connection strings, must be supplied for every instance. Others are optional and change the behavior of the system.

This section provides an overview of the primary files that contain configuration settings.

Main Configuration Locations

The EdFi.Ods.WebApi project (found in the Ed-Fi-ODS-Implementation\Application\EdFi.Ods.WebApi directory of the ODS / API solution) contains the primary configurations for an instance of the Ed-Fi ODS / API. By customizing the Web.config and _Installers files and folders, you should be able to modify the API to suit your needs. A brief description of the configurations made in each file follows:

  • Web.config. Changes here include database connection strings, logging configurations (see Logging Configuration section for details) and the names of the Castle Windsor installer classes that should be loaded. 
  • _Installers Directory. This directory contains application-specific installers for Castle Windsor. If you have multiple deployment configurations required by your API, follow the pattern of adding deployment-specific installers to this directory.

For more detail on the configuration files and the specific values, see the Configuration Details section of this documentation.

Security Configuration

In addition to the configuration settings above, the Ed-Fi ODS / API allows implementers to configure several aspects of the application security:

  • Claim Sets. Changes to claim sets provide fine-grained access control over data accessible by clients. 
  • API Profiles. Profiles allow implementers to create data profiles that specify exactly what access is allowed for particular kinds of client systems. For example, student information systems in an enterprise might require broad access to data, including students, grades, attendance, discipline incidents, assessment results, and so forth, while a gradebook application might only need access to student and gradebook data.

For more detail on the security aspects of the Ed-Fi ODS / API, see the Security section of this documentation.