configuration-azure-sdk-for-net-overview.md

• SDKs expose IAzureClientBuilder<EventHubProducerClient, EventHubProducerClientOptions> AddEventHubProducerClient<TBuilder, TConfiguration>(this TBuilder builder, TConfiguration configuration) where TBuilder : IAzureClientFactoryBuilderWithConfiguration<TConfiguration>

  • Configuration format and binding to options are not defined in Azure SDKs

• Implementation lives in Microsoft.Extensions.Azure

  • binding to options is done by microsoft.extensions.configuration through IConfiguration.Bind() and relies on *Options following microsoft.extensions.configuration conventions (i.e. properties)
  • options sources are whatever microsoft.extensions.configuration supports:
    • appsettings.json
    • env var config (flat) is supported through ASP.NET Core conventions

• Configuration options names and structure exactly match Azure SDK (Core, client libs) *Options properties or reflective constructor parameters and are presumably not strictly consistent

  • per-client options are hierartical and have base ClientOptions
  • credentials are exception and mapping is defined here
    • configuration["credential"]
    • configuration["clientId"]
    • configuration["tenantId"]
    • configuration["clientSecret"]
    • configuration["clientCertificate"]
    • configuration["clientCertificateStoreName"]
    • configuration["clientCertificateStoreLocation"]

• There are two layers:

  • global (defaults)
  • per-client
  • it's possible to define options per-client or global

• Example