Access Control#

KBWS currently uses deployment-scoped access control. It does not implement in-application user authentication, JWT validation, OAuth, or FDSN queryauth semantics. For general compatibility with clients such as ObsPy, the /fdsnws/dataselect/1/queryauth route is an alias of the existing query implementation. It is not separately backed and does not provide a second authorization system. The Swagger UI uses the application’s configured docs_url; deployment-specific URL normalization belongs to the deployment rather than to this project documentation.

Deploy each KBWS instance only where its intended users can reach it: for example, behind an institutional network boundary, VPN, firewall rule, or reverse proxy. User identity and authentication, when required, are the responsibility of that deployment infrastructure.

Oracle service identity#

Each KBWS deployment should use one least-privileged, read-only Oracle service account. Oracle DBAs should grant only SELECT access to the configured KB Core tables or, preferably, dedicated read-only views. Do not grant DML, DDL, DBA-like roles, or access beyond the data the deployment is intended to serve.

Oracle Wallet/external-secret authentication is supported as a deployment choice, but is not required. Local or self-managed deployments can use a normal database_url for their own tables. KBWS relies on the configured SQLAlchemy connection and does not parse Wallet files or manage database credentials itself.

Waveform files#

Dataselect reads waveform files from paths in wfdisc. Oracle table permissions therefore do not by themselves restrict waveform access. Mount only the waveform directories a deployment may serve, and make those mounts read-only where possible.

Operational correlation#

KBWS assigns each response an X-Request-ID header. Formatted error responses also include the request ID in their body, so users can provide it to an operator when reporting a problem. Request IDs provide operational correlation only; they are not user authentication or audit identities.