Simplify configuration, keep detailed config on handler class

Author: alukach

README.md

@@ -145,14 +145,10 @@ The application is configurable via environment variables.
     - **Type:** JSON object
     - **Required:** No, defaults to `null` (disabled)
     - **Example:** `{"type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Paste your raw JWT here. This API uses Bearer token authorization.\n"}`
-  - **`SWAGGER_UI_URL`**, path of Swagger UI, used for augmenting spec response with auth configuration
+  - **`SWAGGER_UI_ENDPOINT`**, path of Swagger UI, used for augmenting spec response with auth configuration
     - **Type:** string or null
     - **Required:** No, defaults to `/api.html`
     - **Example:** `/api`
-  - **`SWAGGER_UI_TITLE`**, title of the Swagger UI
-    - **Type:** string
-    - **Required:** No, defaults to `STAC API`
-    - **Example:** `Foo API`
   - **`SWAGGER_UI_INIT_OAUTH`**, initialization options for the [Swagger UI OAuth2 configuration](https://swagger.io/docs/open-source-tools/swagger-ui/usage/oauth2/)
     - **Type:** JSON object
     - **Required:** No, defaults to `null` (disabled)

src/stac_auth_proxy/app.py

@@ -78,12 +78,12 @@ async def lifespan(app: FastAPI):
     # Handlers (place catch-all proxy handler last)
     #
 
-    if settings.swagger_ui_url:
+    if settings.swagger_ui_endpoint:
         assert (
             settings.openapi_spec_endpoint
         ), "openapi_spec_endpoint must be set when using swagger_ui_url"
         app.add_route(
-            settings.swagger_ui_url,
+            settings.swagger_ui_endpoint,
             SwaggerUI(
                 openapi_url=settings.openapi_spec_endpoint,
                 title=settings.swagger_ui_title,

src/stac_auth_proxy/config.py

@@ -51,8 +51,7 @@ class Settings(BaseSettings):
     )
     openapi_auth_scheme_name: str = "oidcAuth"
     openapi_auth_scheme_override: Optional[dict] = None
-    swagger_ui_url: Optional[str] = "/api.html"
-    swagger_ui_title: Optional[str] = "STAC API"
+    swagger_ui_endpoint: Optional[str] = "/api.html"
     swagger_ui_init_oauth: dict = Field(default_factory=dict)
 
     # Auth

src/stac_auth_proxy/handlers/swagger_ui.py

@@ -22,6 +22,7 @@ class SwaggerUI:
     openapi_url: str
     title: Optional[str] = "STAC API"
     init_oauth: dict = field(default_factory=dict)
+    parameters: dict = field(default_factory=dict)
     oauth2_redirect_url: str = "/docs/oauth2-redirect"
 
     async def route(self, req: Request) -> HTMLResponse:
@@ -36,5 +37,5 @@ async def route(self, req: Request) -> HTMLResponse:
             title=f"{self.title} - Swagger UI",
             oauth2_redirect_url=oauth2_redirect_url,
             init_oauth=self.init_oauth,
-            swagger_ui_parameters=None,
+            swagger_ui_parameters=self.parameters,
         )