This version of the Ed-Fi ODS / API is no longer supported. See the Ed-Fi Technology Version Index for a link to the latest version.
Configuration Details
Application | Location | Setting Name | Value | Description |
---|---|---|---|---|
EdFi.Ods.Admin.Web | Web.config | OAuthUrl | Example: http://site-address:port/oauth | Points to the root of the authorization API in the Ed-Fi ODS / API. |
EdFi.Ods.SecurityConfiguration .Administration.Web | Web.config | KeyRetrievalSite | Example: http://site-address:port/ | Points to the Key Retrieval tool application. The link in the email body uses this address as the root address of the Key Retrieval Tool site. |
EdFi.Ods.WebApi | Web.config | owin:appStartup | Sandbox, SharedInstance, etc. | The component settings for the API. See the Developers' Guide for more information on this setting. |
EdFi.Ods.SwaggerUI | Web.config | swagger.webApiMetadataUrl | Example: http://site-address:port/metadata/ | The location of the Swagger metadata in the Ed-Fi ODS / API. |
EdFi.Ods.SwaggerUI | Web.config | swagger.webApiVersionUrl | Example: http://site-address:port/ | Points to the version endpoint in the Ed-Fi ODS / API. |
A deployment to a staging or production instance is usually more involved, and requires additional configuration. Required configurations for a production instance can be found in the Deployment section of this documentation.
Optional Configuration Settings
Although this list of settings is not exhaustive, other important and useful optional configuration values include:
Application | Location | Setting Name | Value | Description |
---|---|---|---|---|
Key Retrieval Web App | Web.config | MaxChallengeRetries | Default Value: 3 | This is the number of tries a vendor is allowed to enter the correct activation code to retrieve the key and secret. |
EdFi.Ods.SwaggerUI | Web.config | swagger.prepopulatedKey | Example: | Optionally provides the value to prefill in the "key" field of auth. |
EdFi.Ods.SwaggerUI | Web.config | swagger.prepopulatedSecret | Example: | Optionally provides the value to prefill in the "secret" field of auth. |
EdFi.Ods.Admin.Web | Web.config | <initialization> | Example: Contents on Web.Config <initialization configSource="AdminCredential.config" /> Sample contents of AdminCredential.config <initialization enabled="true"> <users> <add name="Test Admin" email="test@ed-fi.org" password="SVpcL4yBICNw3uhQO179G" admin="true"> <sandboxes> <sandbox name="Populated Demonstration Sandbox" key="yKqfNFm310whrkvGBC5AQ" secret="EfYy6v5Tx3VuMCkQgS9c0" type="Sample" refresh="true" /> <sandbox name="Minimal Demonstration Sandbox" key="iHyObkIehprzmjuZwnUqg" secret="cYPh0Htdl1xqTKUaSZMAI" type="Minimal" refresh="true" /> </sandboxes> </add> </users> </initialization> | Custom configuration section (sourced by an external config file AdminCredential.config) for defining automatically created user accounts and sandboxes. Also configures automatic refreshes of sandboxes to a clean state. Each user entry will be created with the given email/password, and the sandboxes defined underneath it will also be created for the type and key/secret values. |
EdFi.Ods.WebApi | Web.config | QueueAutoCreate | Example: 1 | Whether or not a message queue should be created if it is not found. For Azure or Active Directory queues, this should be 0. |
EdFi.Ods.WebApi | Web.config | CommitUploadCommandMessageEndPoint | Example: localhost | The server hosting the message queues. |
EdFi.Ods.WebApi | Web.config | BearerTokenTimeoutMinutes | Example: 30 | The amount of time that an OAuth token remains valid. |