From f5f3f22104445d5397a57caa72547086e3049d6e Mon Sep 17 00:00:00 2001 From: jiahao6635 Date: Thu, 24 Sep 2026 15:10:14 +0800 Subject: [PATCH] feat(openai): support HTTP/SSE for OAuth accounts Reuse account connection settings and the existing Responses HTTP path. Preserve OAuth credentials and health when changing transport, and retain WebSocket-only request constraints without introducing replay. Refs #246 Co-authored-by: Codex --- .github/pr-evidence/246/oauth-http.png | Bin 0 -> 52902 bytes .github/pr-evidence/246/oauth-mobile.png | Bin 0 -> 45418 bytes .../src/model/provider_credentials.rs | 9 ++ .../gateway-admin/tests/use_case/accounts.rs | 2 + .../src/admin/accounts/credentials.rs | 17 +-- .../tests/admin/accounts/handlers.rs | 15 ++- .../runtime/src/adapter/provider/rotation.rs | 1 + .../runtime/src/callback/accounts.rs | 1 + .../provider_accounts/admin_adapter.rs | 1 + .../postgres/provider_accounts/repository.rs | 9 +- .../src/postgres/provider_accounts/rows.rs | 1 + .../provider_accounts/authorization.rs | 1 + .../tests/postgres/provider_accounts/mod.rs | 58 ++++++++++ backend/crates/providers/openai/src/admin.rs | 38 +++++-- .../providers/openai/src/credential/admin.rs | 54 ++++++++- .../openai/src/credential/api_key.rs | 12 +- .../providers/openai/src/credential/mod.rs | 4 +- .../openai/src/credential/security.rs | 8 ++ .../openai/src/credential/selector.rs | 14 ++- .../providers/openai/src/credential/types.rs | 24 ++++ .../providers/openai/src/provider/mod.rs | 7 +- .../crates/providers/openai/tests/admin.rs | 98 ++++++++++++++++- .../openai/tests/credential/admin.rs | 2 +- .../openai/tests/credential/catalog.rs | 40 +++---- .../openai/tests/credential/contract.rs | 23 ++++ .../openai/tests/credential/refresh.rs | 8 ++ .../openai/tests/credential/types.rs | 1 + .../openai/tests/provider/contract.rs | 104 ++++++++++++++++-- .../crates/providers/openai/tests/support.rs | 17 ++- backend/crates/providers/xai/src/admin.rs | 1 + docs/api.md | 13 ++- docs/architecture.md | 3 +- frontend/src/api/modules/accounts.ts | 2 +- .../accounts/components/AccountEditModal.vue | 21 +++- .../accounts/composables/useAccountEditor.ts | 29 ++++- frontend/src/views/accounts/index.vue | 2 + .../views/accounts/utils/upstreamApiKey.ts | 4 + 37 files changed, 544 insertions(+), 100 deletions(-) create mode 100644 .github/pr-evidence/246/oauth-http.png create mode 100644 .github/pr-evidence/246/oauth-mobile.png diff --git a/.github/pr-evidence/246/oauth-http.png b/.github/pr-evidence/246/oauth-http.png new file mode 100644 index 0000000000000000000000000000000000000000..a21640b9604fc4efd33909d335a6030bb76d5785 GIT binary patch literal 52902 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, /// Token 刷新保留提交时的资料,不以准备阶段的副本覆盖新套餐。 pub preserve_profile: bool, + /// 连接配置变更保留当前凭据健康状态与错误事实。 + pub preserve_credential_state: bool, pub provider_material: ProviderDocument, pub has_refresh_token: bool, pub access_token_expires_at: Option>, @@ -754,6 +756,13 @@ impl PreparedCredentialRotation { Self { facts, guard } } + /// 仅修改连接配置时,不把配置更新视为凭据恢复成功。 + #[must_use] + pub fn preserving_credential_state(mut self) -> Self { + self.facts.preserve_credential_state = true; + self + } + #[must_use] pub const fn facts(&self) -> &PreparedCredentialRotationFacts { &self.facts diff --git a/backend/crates/gateway-admin/tests/use_case/accounts.rs b/backend/crates/gateway-admin/tests/use_case/accounts.rs index 5207e33f4..853bc5cd0 100644 --- a/backend/crates/gateway-admin/tests/use_case/accounts.rs +++ b/backend/crates/gateway-admin/tests/use_case/accounts.rs @@ -271,6 +271,7 @@ impl FakeProviderAdmin { email: account.email.clone(), plan_type: account.plan_type.clone(), preserve_profile: false, + preserve_credential_state: false, provider_material: document(), has_refresh_token: account.has_refresh_token, access_token_expires_at: account @@ -3257,6 +3258,7 @@ fn plugin_rotation_facts(account: &AccountRecord) -> PreparedCredentialRotationF email: account.email.clone(), plan_type: account.plan_type.clone(), preserve_profile: true, + preserve_credential_state: false, provider_material: document(), has_refresh_token: account.has_refresh_token, access_token_expires_at: account.access_token_expires_at, diff --git a/backend/crates/gateway-api/src/admin/accounts/credentials.rs b/backend/crates/gateway-api/src/admin/accounts/credentials.rs index cd700163f..e8506af50 100644 --- a/backend/crates/gateway-api/src/admin/accounts/credentials.rs +++ b/backend/crates/gateway-api/src/admin/accounts/credentials.rs @@ -335,18 +335,20 @@ impl UpdateAccountRequest { } } -/// 编辑 OpenAI API Key 账号的连接设置;省略密钥时保留已保存的值。 +/// 编辑 OpenAI 账号的连接设置;OAuth 仅接受传输方式。 #[derive(Clone, Deserialize)] #[serde(rename_all = "camelCase", deny_unknown_fields)] pub struct AccountConnectionUpdateRequest { - pub base_url: String, + pub base_url: Option, pub transport: String, pub api_key: Option, } impl AccountConnectionUpdateRequest { fn validate(&self) -> Result<(), WireValidationError> { - require_text(&self.base_url, 2048, "connection.baseUrl")?; + if let Some(base_url) = &self.base_url { + require_text(base_url, 2048, "connection.baseUrl")?; + } if !matches!(self.transport.as_str(), "http" | "prefer_websocket") { return Err(WireValidationError::new("connection.transport")); } @@ -361,10 +363,11 @@ impl AccountConnectionUpdateRequest { } fn into_document(self) -> ProviderDocument { - let mut material = Map::from_iter([ - ("base_url".to_owned(), Value::String(self.base_url)), - ("transport".to_owned(), Value::String(self.transport)), - ]); + let mut material = + Map::from_iter([("transport".to_owned(), Value::String(self.transport))]); + if let Some(base_url) = self.base_url { + material.insert("base_url".to_owned(), Value::String(base_url)); + } if let Some(key) = self.api_key { material.insert("api_key".to_owned(), Value::String(key)); } diff --git a/backend/crates/gateway-api/tests/admin/accounts/handlers.rs b/backend/crates/gateway-api/tests/admin/accounts/handlers.rs index 24cb15625..739b38aff 100644 --- a/backend/crates/gateway-api/tests/admin/accounts/handlers.rs +++ b/backend/crates/gateway-api/tests/admin/accounts/handlers.rs @@ -39,14 +39,21 @@ async fn connection_update_requires_admin_and_validates_before_calling_the_servi "groupIds":[], "connection":{"baseUrl":"https://api.example.invalid/v1", "transport":"http"} }); - for (authenticated, transport, expected) in [ - (false, "http", StatusCode::UNAUTHORIZED), - (true, "invalid", StatusCode::BAD_REQUEST), + for (authenticated, transport, oauth, expected) in [ + (false, "http", false, StatusCode::UNAUTHORIZED), + (true, "invalid", false, StatusCode::BAD_REQUEST), // 夹具没有凭据 Store,合法输入必须进入服务,不能按普通设置静默保存。 - (true, "http", StatusCode::SERVICE_UNAVAILABLE), + (true, "http", false, StatusCode::SERVICE_UNAVAILABLE), + (true, "http", true, StatusCode::SERVICE_UNAVAILABLE), ] { let mut input = input.clone(); input["connection"]["transport"] = serde_json::json!(transport); + if oauth { + input["connection"] + .as_object_mut() + .unwrap() + .remove("baseUrl"); + } let mut request = Request::builder() .method("POST") .uri("/api/admin/accounts/update") diff --git a/backend/crates/gateway-plugin/runtime/src/adapter/provider/rotation.rs b/backend/crates/gateway-plugin/runtime/src/adapter/provider/rotation.rs index fbf1e2344..d2ac48071 100644 --- a/backend/crates/gateway-plugin/runtime/src/adapter/provider/rotation.rs +++ b/backend/crates/gateway-plugin/runtime/src/adapter/provider/rotation.rs @@ -217,6 +217,7 @@ impl PluginProvider { email: facts.email, plan_type: facts.plan_type, preserve_profile: !matches!(change, CredentialChange::Rotate), + preserve_credential_state: false, provider_material: ProviderDocument::new(OpaqueProviderData::new(facts.material)), has_refresh_token: facts.has_refresh_token, access_token_expires_at, diff --git a/backend/crates/gateway-plugin/runtime/src/callback/accounts.rs b/backend/crates/gateway-plugin/runtime/src/callback/accounts.rs index 68fdb664d..44fb32b44 100644 --- a/backend/crates/gateway-plugin/runtime/src/callback/accounts.rs +++ b/backend/crates/gateway-plugin/runtime/src/callback/accounts.rs @@ -302,6 +302,7 @@ fn prepare_replace( email: facts.email, plan_type: facts.plan_type, preserve_profile: false, + preserve_credential_state: false, provider_material: ProviderDocument::new(OpaqueProviderData::new(facts.material)), has_refresh_token: facts.has_refresh_token, access_token_expires_at: provider::credential_timestamp(facts.access_token_expires_at_ms) diff --git a/backend/crates/gateway-store/src/postgres/provider_accounts/admin_adapter.rs b/backend/crates/gateway-store/src/postgres/provider_accounts/admin_adapter.rs index 327bf7ece..46f9fee80 100644 --- a/backend/crates/gateway-store/src/postgres/provider_accounts/admin_adapter.rs +++ b/backend/crates/gateway-store/src/postgres/provider_accounts/admin_adapter.rs @@ -1060,6 +1060,7 @@ pub(super) fn prepare_rotation( access_token_expires_at: prepared.access_token_expires_at, next_refresh_at: prepared.next_refresh_at, preserve_profile: prepared.preserve_profile, + preserve_credential_state: prepared.preserve_credential_state, }, audit: mutation_audit( context, diff --git a/backend/crates/gateway-store/src/postgres/provider_accounts/repository.rs b/backend/crates/gateway-store/src/postgres/provider_accounts/repository.rs index f2eecb0de..44c80c25a 100644 --- a/backend/crates/gateway-store/src/postgres/provider_accounts/repository.rs +++ b/backend/crates/gateway-store/src/postgres/provider_accounts/repository.rs @@ -834,16 +834,16 @@ pub(crate) async fn rotate_provider_account_in_transaction( upstream_user_id = case when $11::boolean then $12::text else upstream_user_id end, upstream_account_id = case when $11::boolean then $13::text else upstream_account_id end, credential_state = case - when not enabled then credential_state + when $15::boolean or not enabled then credential_state when $11::boolean or credential_state <> 'unknown' then 'ready' else 'unknown' end, credential_observed_at = case - when not enabled then credential_observed_at + when $15::boolean or not enabled then credential_observed_at else now() end, - last_error_reason = case when enabled then null else last_error_reason end, - last_error_message = case when enabled then null else last_error_message end, + last_error_reason = case when enabled and not $15::boolean then null else last_error_reason end, + last_error_message = case when enabled and not $15::boolean then null else last_error_message end, updated_at = greatest(now(), updated_at) where id = $1 and provider_kind = $2 and credential_revision = $3 @@ -863,6 +863,7 @@ pub(crate) async fn rotate_provider_account_in_transaction( .bind(upstream_user_id) .bind(upstream_account_id) .bind(update.preserve_profile) + .bind(update.preserve_credential_state) .fetch_optional(&mut **transaction) .await .map_err(|error| { diff --git a/backend/crates/gateway-store/src/postgres/provider_accounts/rows.rs b/backend/crates/gateway-store/src/postgres/provider_accounts/rows.rs index babadcf85..1795eecb7 100644 --- a/backend/crates/gateway-store/src/postgres/provider_accounts/rows.rs +++ b/backend/crates/gateway-store/src/postgres/provider_accounts/rows.rs @@ -361,6 +361,7 @@ pub struct ProviderCredentialUpdate { pub access_token_expires_at: Option>, pub next_refresh_at: Option>, pub preserve_profile: bool, + pub preserve_credential_state: bool, } impl fmt::Debug for ProviderCredentialUpdate { diff --git a/backend/crates/gateway-store/tests/postgres/provider_accounts/authorization.rs b/backend/crates/gateway-store/tests/postgres/provider_accounts/authorization.rs index 5451427fa..90fecf10f 100644 --- a/backend/crates/gateway-store/tests/postgres/provider_accounts/authorization.rs +++ b/backend/crates/gateway-store/tests/postgres/provider_accounts/authorization.rs @@ -160,6 +160,7 @@ async fn reauthorization_replay_keeps_the_committed_revision_and_later_profile_e email: None, plan_type: None, preserve_profile: true, + preserve_credential_state: false, provider_material: ProviderDocument::new(OpaqueProviderData::new( json!({"access_token":"rotated-test-only"}) .as_object() diff --git a/backend/crates/gateway-store/tests/postgres/provider_accounts/mod.rs b/backend/crates/gateway-store/tests/postgres/provider_accounts/mod.rs index bbb41f332..d5227b779 100644 --- a/backend/crates/gateway-store/tests/postgres/provider_accounts/mod.rs +++ b/backend/crates/gateway-store/tests/postgres/provider_accounts/mod.rs @@ -3034,6 +3034,7 @@ pub(super) fn account(id: &str, upstream_user_id: &str) -> NewProviderAccount { fn credential_update(account_id: &str, revision: u64, marker: &str) -> ProviderCredentialUpdate { ProviderCredentialUpdate { preserve_profile: false, + preserve_credential_state: false, account_id: account_id.to_owned(), expected_revision: Revision::new(revision).expect("credential revision"), provider_credentials_json: credential_json(marker), @@ -3549,3 +3550,60 @@ async fn adaptive_concurrency_handles_unlimited_and_latest_locked_settings_witho ); database.close().await; } + +#[tokio::test] +async fn connection_configuration_update_preserves_credential_health() { + let Some(database) = TestDatabase::create("connection_configuration_health").await else { + return; + }; + let repository = PgProviderAccountRepository::new(database.pool.clone()); + const ID: &str = "acct_transport_health"; + repository + .insert_provider_account(account(ID, "transport-health-user")) + .await + .unwrap(); + sqlx::query("update provider_accounts set credential_state = 'expired', last_error_reason = 'credential_expired', last_error_message = 'test expiration' where id = $1") + .bind(ID).execute(&database.pool).await.unwrap(); + let before: serde_json::Value = + sqlx::query_scalar("select to_jsonb(a) from provider_accounts a where id = $1") + .bind(ID) + .fetch_one(&database.pool) + .await + .unwrap(); + let mut credential = credential_update(ID, 1, "same-secret"); + credential.preserve_credential_state = true; + credential.preserve_profile = true; + repository + .rotate_provider_account(RotateProviderAccount { + scope: ProviderAccountAdminScope { + provider_kind: "openai".to_owned(), + }, + profile: profile(ID, "must not replace name"), + replacement_identity: None, + credential, + settings: None, + audit: audit("audit_transport_health", "rotate", ID), + }) + .await + .unwrap(); + let after: serde_json::Value = + sqlx::query_scalar("select to_jsonb(a) from provider_accounts a where id = $1") + .bind(ID) + .fetch_one(&database.pool) + .await + .unwrap(); + for field in [ + "name", + "credential_state", + "credential_observed_at", + "last_error_reason", + "last_error_message", + ] { + assert_eq!( + after[field], before[field], + "configuration update changed {field}" + ); + } + assert_eq!(after["credential_revision"], 2); + database.close().await; +} diff --git a/backend/crates/providers/openai/src/admin.rs b/backend/crates/providers/openai/src/admin.rs index 3c3cc764f..9d1d68b91 100644 --- a/backend/crates/providers/openai/src/admin.rs +++ b/backend/crates/providers/openai/src/admin.rs @@ -578,6 +578,21 @@ impl ProviderAdmin for OpenAiAdminProvider { .map_err(map_credential_admin_error)?; return prepared_rotation(prepared, command.account.provider_kind); } + if command + .provider_material + .expose_to_provider() + .expose_to_provider() + .contains_key("transport") + { + let prepared = CodexCredentialAdmin + .prepare_transport_update( + current, + Value::Object(command.provider_material.into_provider_data().into_inner()), + ) + .map_err(map_credential_admin_error)?; + return prepared_rotation(prepared, command.account.provider_kind) + .map(PreparedCredentialRotation::preserving_credential_state); + } let mut secret = rotation_secret(command.provider_material)?; if secret.id_token.is_none() { let runtime = CodexCredentialCodec::decode(¤t.credential) @@ -627,23 +642,23 @@ impl ProviderAdmin for OpenAiAdminProvider { &self, account_id: &ProviderAccountId, ) -> Result, ProviderAdminError> { - let account = self.account(account_id).await?; - if account.authentication_kind() != crate::credential::CODEX_AUTHENTICATION_KIND_API_KEY { - return Ok(None); - } + self.account(account_id).await?; let current = self .accounts .load_current_credential(account_id) .await .map_err(map_store_error)?; - let crate::credential::CodexCredentialData::ApiKey(data) = - CodexCredentialCodec::decode_complete(¤t.credential) - .map_err(|_| provider_admin_error(ProviderAdminErrorKind::Invalid))? - else { - return Err(provider_admin_error(ProviderAdminErrorKind::Invalid)); + let data = CodexCredentialCodec::decode_complete(¤t.credential) + .map_err(|_| provider_admin_error(ProviderAdminErrorKind::Invalid))?; + let value = match data { + crate::credential::CodexCredentialData::ApiKey(data) => { + serde_json::to_value(data.configuration()) + .map_err(|_| provider_admin_error(ProviderAdminErrorKind::Internal))? + } + crate::credential::CodexCredentialData::OAuth(data) => { + serde_json::json!({"transport": data.transport}) + } }; - let value = serde_json::to_value(data.configuration()) - .map_err(|_| provider_admin_error(ProviderAdminErrorKind::Internal))?; let object = value .as_object() .cloned() @@ -991,6 +1006,7 @@ fn prepared_rotation( email: profile.email, plan_type: profile.plan_type, preserve_profile, + preserve_credential_state: false, provider_material: ProviderDocument::new(OpaqueProviderData::new( credential.into_inner(), )), diff --git a/backend/crates/providers/openai/src/credential/admin.rs b/backend/crates/providers/openai/src/credential/admin.rs index 667188fc7..2cb0287ad 100644 --- a/backend/crates/providers/openai/src/credential/admin.rs +++ b/backend/crates/providers/openai/src/credential/admin.rs @@ -24,7 +24,7 @@ use serde::Serialize; use serde_json::Value; use thiserror::Error; -use super::api_key::{ApiKeyCredentialData, ApiKeyTransport, CODEX_AUTHENTICATION_KIND_API_KEY}; +use super::api_key::{ApiKeyCredentialData, CODEX_AUTHENTICATION_KIND_API_KEY}; use super::recovery_log::{CodexOAuthRecoveryOperation, record_oauth_recovery}; use super::security::CodexCredentialCodec; use super::token_client::{ @@ -32,8 +32,8 @@ use super::token_client::{ }; use super::types::{ CODEX_AUTHENTICATION_KIND_OAUTH, CodexAccountProfile, CodexCredentialData, - CodexCredentialPrincipal, CodexOAuthMetadata, CodexOAuthSecret, parse_access_token_expiration, - parse_chatgpt_jwt_claims, + CodexCredentialPrincipal, CodexOAuthMetadata, CodexOAuthSecret, ResponsesTransport, + parse_access_token_expiration, parse_chatgpt_jwt_claims, }; const PROVIDER_NAME: &str = "openai"; @@ -257,7 +257,7 @@ struct CodexCprApiKeyExportAccount { authentication_kind: &'static str, base_url: String, api_key: String, - transport: ApiKeyTransport, + transport: ResponsesTransport, } #[derive(Serialize)] @@ -453,7 +453,7 @@ impl CodexCredentialAdmin { #[serde(deny_unknown_fields)] struct Rotation { base_url: String, - transport: ApiKeyTransport, + transport: ResponsesTransport, api_key: Option, } let rotation: Rotation = serde_json::from_value(material) @@ -496,6 +496,50 @@ impl CodexCredentialAdmin { }) } + pub(crate) fn prepare_transport_update( + &self, + current: LoadedCredential, + material: Value, + ) -> Result { + #[derive(serde::Deserialize)] + #[serde(deny_unknown_fields)] + struct Connection { + transport: ResponsesTransport, + } + let connection: Connection = serde_json::from_value(material) + .map_err(|_| CodexCredentialAdminError::InvalidInput)?; + let mut data = CodexCredentialCodec::decode_complete(¤t.credential) + .map_err(|_| CodexCredentialAdminError::InvalidCredential)?; + data.oauth_mut() + .ok_or(CodexCredentialAdminError::InvalidCredential)? + .transport = connection.transport; + let credential = CodexCredentialCodec::encode_complete(data) + .map_err(|_| CodexCredentialAdminError::InvalidCredential)?; + let profile = ProviderAccountUpdate { + account_id: current.account.id().clone(), + name: current.account.name().to_owned(), + email: current.account.email().map(str::to_owned), + plan_type: current.account.plan_type().map(str::to_owned), + }; + let credential = CredentialCasUpdate::new( + current.account.id().clone(), + current.account.revision(), + profile.clone(), + credential, + current.account.has_refresh_token(), + current.account.access_token_expires_at(), + current.account.next_refresh_at(), + ) + .map_err(|_| CodexCredentialAdminError::InvalidCredential)? + .preserving_profile(); + Ok(PreparedCodexCredentialRotation { + profile, + credential, + replacement_identity: None, + refresh_guards: None, + }) + } + pub fn prepare_import( &self, input: ImportCodexOAuthCredential, diff --git a/backend/crates/providers/openai/src/credential/api_key.rs b/backend/crates/providers/openai/src/credential/api_key.rs index 091d3d5e2..1921a8829 100644 --- a/backend/crates/providers/openai/src/credential/api_key.rs +++ b/backend/crates/providers/openai/src/credential/api_key.rs @@ -7,13 +7,7 @@ use serde::{Deserialize, Serialize}; pub const CODEX_AUTHENTICATION_KIND_API_KEY: &str = "api_key"; -#[derive(Debug, Default, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)] -#[serde(rename_all = "snake_case")] -pub enum ApiKeyTransport { - #[default] - Http, - PreferWebsocket, -} +use super::types::ResponsesTransport; /// 可在管理端展示的上游设置,不包含密钥。 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)] @@ -21,7 +15,7 @@ pub enum ApiKeyTransport { pub struct ApiKeyConfiguration { pub base_url: String, #[serde(default)] - pub transport: ApiKeyTransport, + pub transport: ResponsesTransport, } impl ApiKeyConfiguration { @@ -40,7 +34,7 @@ pub struct ApiKeyCredentialData { pub api_key: String, pub base_url: String, #[serde(default)] - pub transport: ApiKeyTransport, + pub transport: ResponsesTransport, } impl ApiKeyCredentialData { diff --git a/backend/crates/providers/openai/src/credential/mod.rs b/backend/crates/providers/openai/src/credential/mod.rs index 7e9ce07e4..b8cc9db69 100644 --- a/backend/crates/providers/openai/src/credential/mod.rs +++ b/backend/crates/providers/openai/src/credential/mod.rs @@ -25,7 +25,7 @@ pub(crate) use oauth::oauth_owner_ref; pub(crate) use types::parse_access_token_expiration; pub use api_key::{ - ApiKeyAuthentication, ApiKeyConfiguration, ApiKeyCredentialData, ApiKeyTransport, + ApiKeyAuthentication, ApiKeyConfiguration, ApiKeyCredentialData, CODEX_AUTHENTICATION_KIND_API_KEY, }; @@ -71,5 +71,5 @@ pub(crate) use selector::{CodexCyberPolicyScope, SelectCodexProviderEndpointCred pub use types::{ CODEX_AUTHENTICATION_KIND_OAUTH, CodexAccountProfile, CodexCookie, CodexCookieCaptureOutcome, CodexCredentialData, CodexCredentialPrincipal, CodexOAuthCredentialData, CodexOAuthSecret, - RuntimeCodexCookie, UpsertCodexCookie, + ResponsesTransport, RuntimeCodexCookie, UpsertCodexCookie, }; diff --git a/backend/crates/providers/openai/src/credential/security.rs b/backend/crates/providers/openai/src/credential/security.rs index db44410a1..156444dda 100644 --- a/backend/crates/providers/openai/src/credential/security.rs +++ b/backend/crates/providers/openai/src/credential/security.rs @@ -17,6 +17,7 @@ const MAX_COOKIES: usize = 128; /// 已解析且只在 Provider 内可见的认证材料。 pub struct CodexRuntimeCredential { + pub transport: super::ResponsesTransport, pub authentication: CodexRuntimeAuthentication, pub principal: Option, pub installation_id: String, @@ -122,6 +123,7 @@ impl CodexCredentialCodec { ) -> Result { Self::encode_complete(CodexCredentialData::OAuth(CodexOAuthCredentialData { schema_version: CODEX_CREDENTIAL_SCHEMA_VERSION, + transport: super::ResponsesTransport::oauth_default(), principal, installation_id, access_token: secret.access_token.expose_secret().to_owned(), @@ -172,6 +174,10 @@ impl CodexCredentialCodec { let data = serde_json::from_value::(value) .map_err(|_| CodexCredentialDataError::Invalid)?; validate(&data)?; + let transport = match &data { + CodexCredentialData::OAuth(data) => data.transport, + CodexCredentialData::ApiKey(data) => data.transport, + }; let (authentication, principal, installation_id, cookies, oauth_client_id, oauth_scope) = match data { CodexCredentialData::ApiKey(data) => ( @@ -199,6 +205,7 @@ impl CodexCredentialCodec { ), }; Ok(CodexRuntimeCredential { + transport, authentication, principal, installation_id, @@ -238,6 +245,7 @@ impl CodexCredentialCodec { match (&mut incoming, existing) { (CodexCredentialData::OAuth(incoming), CodexCredentialData::OAuth(existing)) => { incoming.installation_id = existing.installation_id; + incoming.transport = existing.transport; } (CodexCredentialData::ApiKey(incoming), CodexCredentialData::ApiKey(existing)) => { incoming.installation_id = existing.installation_id; diff --git a/backend/crates/providers/openai/src/credential/selector.rs b/backend/crates/providers/openai/src/credential/selector.rs index 7c2f7b01a..66abe8d94 100644 --- a/backend/crates/providers/openai/src/credential/selector.rs +++ b/backend/crates/providers/openai/src/credential/selector.rs @@ -436,9 +436,7 @@ impl CodexCredentialSelector { .collect::>(); let mut eligible = Vec::with_capacity(accounts.len()); for account in accounts { - if request.requires_websocket - && account.authentication_kind() == super::CODEX_AUTHENTICATION_KIND_API_KEY - { + if request.requires_websocket { let runtime = match self.repository.load_runtime_credential(&account).await { Ok(runtime) => runtime, Err(CredentialRepositoryError::RevisionConflict) => { @@ -451,9 +449,7 @@ impl CodexCredentialSelector { } Err(error) => return Err(error.into()), }; - if !matches!(runtime.authentication, CodexRuntimeAuthentication::ApiKey(ref auth) - if auth.configuration.transport == super::ApiKeyTransport::PreferWebsocket) - { + if runtime.transport == super::ResponsesTransport::Http { continue; } } @@ -800,6 +796,7 @@ impl CodexCredentialSelector { } return Ok(CodexCredentialLease { installation_id: runtime.installation_id, + transport: runtime.transport, account, authentication: runtime.authentication, cookies, @@ -1444,6 +1441,7 @@ impl fmt::Debug for CodexCredentialSelector { } pub struct CodexCredentialLease { + transport: super::ResponsesTransport, account: ProviderAccount, authentication: CodexRuntimeAuthentication, cookies: Vec, @@ -1457,6 +1455,10 @@ pub struct CodexCredentialLease { } impl CodexCredentialLease { + pub(crate) const fn transport(&self) -> super::ResponsesTransport { + self.transport + } + #[must_use] pub const fn account(&self) -> &ProviderAccount { &self.account diff --git a/backend/crates/providers/openai/src/credential/types.rs b/backend/crates/providers/openai/src/credential/types.rs index 38703b580..2edce2d94 100644 --- a/backend/crates/providers/openai/src/credential/types.rs +++ b/backend/crates/providers/openai/src/credential/types.rs @@ -279,12 +279,36 @@ impl fmt::Debug for CodexCookie { } } +#[derive(Debug, Default, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)] +#[serde(rename_all = "snake_case")] +pub enum ResponsesTransport { + #[default] + Http, + PreferWebsocket, +} + +impl ResponsesTransport { + pub(crate) const fn oauth_default() -> Self { + Self::PreferWebsocket + } + + fn is_oauth_default(&self) -> bool { + *self == Self::oauth_default() + } +} + pub const CODEX_AUTHENTICATION_KIND_OAUTH: &str = "oauth"; /// Codex OAuth 对 `provider_credentials_json` 的完整明文 schema。 #[derive(Clone, Serialize, Deserialize)] #[serde(deny_unknown_fields)] pub struct CodexOAuthCredentialData { + // 默认值不扩展旧凭据 JSON,恢复 WS 优先后仍可由旧版本读取。 + #[serde( + default = "ResponsesTransport::oauth_default", + skip_serializing_if = "ResponsesTransport::is_oauth_default" + )] + pub transport: ResponsesTransport, pub schema_version: u32, #[serde(default, skip_serializing_if = "Option::is_none")] pub principal: Option, diff --git a/backend/crates/providers/openai/src/provider/mod.rs b/backend/crates/providers/openai/src/provider/mod.rs index 59efd3d2f..194f43d81 100644 --- a/backend/crates/providers/openai/src/provider/mod.rs +++ b/backend/crates/providers/openai/src/provider/mod.rs @@ -704,15 +704,14 @@ impl CodexProvider { ); } let requirement = transport_requirement(&upstream_request); - let api_http = matches!(lease.authentication(), crate::credential::CodexRuntimeAuthentication::ApiKey(auth) - if auth.configuration.transport == crate::credential::ApiKeyTransport::Http); - if api_http && requirement.requires_websocket() { + let http_only = lease.transport() == crate::credential::ResponsesTransport::Http; + if http_only && requirement.requires_websocket() { return Err(provider_error( ProviderErrorKind::Unsupported, UpstreamSendState::NotSent, )); } - let requested_transport = if api_http { + let requested_transport = if http_only { CodexProviderTransport::HttpOnly } else { selected_transport(&upstream_request) diff --git a/backend/crates/providers/openai/tests/admin.rs b/backend/crates/providers/openai/tests/admin.rs index 9ac4a6422..78ab53bce 100644 --- a/backend/crates/providers/openai/tests/admin.rs +++ b/backend/crates/providers/openai/tests/admin.rs @@ -2294,7 +2294,7 @@ async fn api_key_admin_exposes_only_configuration_and_preserves_key_when_rotatin .seed_api_key( "acct_api_admin", "https://first.example/v1".to_owned(), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; let account = store.account("acct_api_admin").unwrap(); @@ -2406,3 +2406,99 @@ async fn browser_authorization_declares_callback_and_rejects_extra_login_inputs( assert_eq!(error.kind(), ProviderAdminErrorKind::Invalid); assert!(!format!("{error:?}").contains("unexpected-fixture-secret")); } + +#[tokio::test] +async fn oauth_transport_settings_preserve_tokens_refresh_schedule_and_health() { + let store = Arc::new(MemoryAccountStore::default()); + store + .seed_oauth_credential(ImportCodexOAuthCredential { + account_id: "acct_oauth_transport".to_owned(), + name: "OAuth transport".to_owned(), + secret: secret("test-oauth-transport"), + verified_account: profile("chatgpt-oauth-transport"), + next_refresh_at: Some(Utc::now() + chrono::Duration::minutes(30)), + enabled: true, + }) + .await; + let account = store.account("acct_oauth_transport").unwrap(); + let current = store.load_current_credential(account.id()).await.unwrap(); + let config = valid_config(); + let bundle = provider_openai::initialize( + config.config.clone(), + provider_ports_with(Arc::clone(&store), Arc::new(TestOAuthPending::default())), + ) + .await + .unwrap(); + let admin = bundle.admin_provider(); + let configuration = admin + .account_configuration(account.id()) + .await + .unwrap() + .unwrap(); + assert_eq!( + configuration.expose_to_provider().expose_to_provider(), + json!({"transport":"prefer_websocket"}).as_object().unwrap() + ); + for transport in ["http", "prefer_websocket"] { + let prepared = admin + .prepare_rotation(PrepareCredentialRotation { + account: account_record(&account), + provider_material: ProviderDocument::new(OpaqueProviderData::new( + json!({"transport":transport}).as_object().unwrap().clone(), + )), + }) + .await + .unwrap(); + let facts = prepared.facts(); + let mut expected = current.credential.expose_to_provider().clone(); + if transport == "http" { + expected.insert("transport".to_owned(), json!(transport)); + } + assert_eq!( + facts + .provider_material + .expose_to_provider() + .expose_to_provider(), + &expected + ); + assert_eq!( + facts.next_refresh_at, + account.next_refresh_at().map(DateTime::::from) + ); + assert_eq!( + facts.access_token_expires_at, + account.access_token_expires_at().map(DateTime::::from) + ); + assert_eq!(facts.has_refresh_token, account.has_refresh_token()); + assert!(facts.preserve_profile && facts.preserve_credential_state); + } + for invalid in [ + json!({"transport":"invalid"}), + json!({"transport":"http", "base_url":"https://other.example"}), + json!({"transport":"http", "api_key":"test-key"}), + ] { + let error = admin + .prepare_rotation(PrepareCredentialRotation { + account: account_record(&account), + provider_material: ProviderDocument::new(OpaqueProviderData::new( + invalid.as_object().unwrap().clone(), + )), + }) + .await + .unwrap_err(); + assert_eq!(error.kind(), ProviderAdminErrorKind::Invalid); + } + store.set_oauth_transport( + "acct_oauth_transport", + provider_openai::credential::ResponsesTransport::Http, + ); + let configuration = admin + .account_configuration(account.id()) + .await + .unwrap() + .unwrap(); + assert_eq!( + configuration.expose_to_provider().expose_to_provider(), + json!({"transport":"http"}).as_object().unwrap() + ); +} diff --git a/backend/crates/providers/openai/tests/credential/admin.rs b/backend/crates/providers/openai/tests/credential/admin.rs index 04aff4871..e1cc07f36 100644 --- a/backend/crates/providers/openai/tests/credential/admin.rs +++ b/backend/crates/providers/openai/tests/credential/admin.rs @@ -891,7 +891,7 @@ async fn api_key_import_export_preserves_target_without_oauth_exchange() { assert_eq!(data.api_key, "sk-test-only"); assert_eq!( data.transport, - provider_openai::credential::ApiKeyTransport::Http + provider_openai::credential::ResponsesTransport::Http ); } diff --git a/backend/crates/providers/openai/tests/credential/catalog.rs b/backend/crates/providers/openai/tests/credential/catalog.rs index 177dfcf88..df3d5d903 100644 --- a/backend/crates/providers/openai/tests/credential/catalog.rs +++ b/backend/crates/providers/openai/tests/credential/catalog.rs @@ -783,17 +783,17 @@ fn invalid_response_etag_is_rejected_without_touching_the_catalog() { #[tokio::test] async fn api_key_catalogs_are_isolated_and_join_oauth_without_claiming_native_metadata() { - use provider_openai::credential::{ApiKeyTransport, CodexCatalogScope}; + use provider_openai::credential::{CodexCatalogScope, ResponsesTransport}; let oauth = MockServer::start().await; let first = MockServer::start().await; let second = MockServer::start().await; let store = Arc::new(MemoryAccountStore::default()); let oauth_account = seed_account(&store, "acct_oauth").await; store - .seed_api_key("acct_first", first.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_first", first.uri(), ResponsesTransport::Http) .await; store - .seed_api_key("acct_second", second.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_second", second.uri(), ResponsesTransport::Http) .await; let a = store.account("acct_first").unwrap(); let b = store.account("acct_second").unwrap(); @@ -872,13 +872,13 @@ async fn api_key_catalogs_are_isolated_and_join_oauth_without_claiming_native_me #[tokio::test] async fn api_key_client_catalog_negotiates_and_preserves_versioned_native_objects() { use gateway_core::routing::ProviderModelContent; - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; use serde_json::json; let upstream = MockServer::start().await; let store = Arc::new(MemoryAccountStore::default()); store - .seed_api_key("acct_api", upstream.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_api", upstream.uri(), ResponsesTransport::Http) .await; let account = store.account("acct_api").expect("API account"); // 先填满普通 ID 目录,确保客户端不会把已有套餐缓存误当成原生元数据。 @@ -960,14 +960,14 @@ async fn api_key_client_catalog_negotiates_and_preserves_versioned_native_object #[tokio::test] async fn api_key_native_catalog_preserves_unknown_reasoning_and_background_entitlements() { use gateway_core::routing::ProviderModelContent; - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; use provider_openai::transport::CodexCatalogCapabilityEvidence; use serde_json::json; let upstream = MockServer::start().await; let store = Arc::new(MemoryAccountStore::default()); store - .seed_api_key("acct_api", upstream.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_api", upstream.uri(), ResponsesTransport::Http) .await; let original = json!({"slug":"z-unknown-reasoning", "display_name":"Unknown reasoning"}); let second = json!({"slug":"vendor/model", "display_name":"Second upstream model"}); @@ -1017,7 +1017,7 @@ async fn api_key_native_catalog_preserves_unknown_reasoning_and_background_entit #[tokio::test] async fn api_key_client_catalog_keeps_native_sources_stable_and_account_scoped() { use gateway_core::routing::ProviderModelContent; - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; use serde_json::json; let upstream = MockServer::start().await; @@ -1040,7 +1040,7 @@ async fn api_key_client_catalog_keeps_native_sources_stable_and_account_scoped() .seed_api_key( id, format!("{}/{id}", upstream.uri()), - ApiKeyTransport::Http, + ResponsesTransport::Http, ) .await; accounts.push(store.account(id).unwrap()); @@ -1078,12 +1078,12 @@ async fn api_key_client_catalog_keeps_native_sources_stable_and_account_scoped() #[tokio::test] async fn api_key_client_catalog_cache_is_invalidated_by_credential_revision() { use gateway_core::account::{CredentialCasOutcome, CredentialCasUpdate, ProviderAccountUpdate}; - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; let upstream = MockServer::start().await; let store = Arc::new(MemoryAccountStore::default()); store - .seed_api_key("acct_api", upstream.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_api", upstream.uri(), ResponsesTransport::Http) .await; let account = store.account("acct_api").unwrap(); let scope = client_scope(std::slice::from_ref(&account)); @@ -1134,13 +1134,13 @@ async fn api_key_client_catalog_cache_is_invalidated_by_credential_revision() { #[tokio::test] async fn api_key_catalog_accepts_namespaced_model_ids_without_inventing_capabilities() { - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; use provider_openai::transport::CodexCatalogCapabilityEvidence; let upstream = MockServer::start().await; let store = Arc::new(MemoryAccountStore::default()); store - .seed_api_key("acct_api", upstream.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_api", upstream.uri(), ResponsesTransport::Http) .await; let ids = [ "gpt-5.4", @@ -1195,12 +1195,12 @@ async fn api_key_catalog_accepts_namespaced_model_ids_without_inventing_capabili #[tokio::test] async fn api_key_catalog_rejects_invalid_ids_and_duplicates() { - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; let upstream = MockServer::start().await; let store = Arc::new(MemoryAccountStore::default()); store - .seed_api_key("acct_api", upstream.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_api", upstream.uri(), ResponsesTransport::Http) .await; let service = service_with_catalog_cache(&store, upstream.uri(), catalog_cache()); for invalid in [ @@ -1230,7 +1230,7 @@ async fn api_key_catalog_rejects_invalid_ids_and_duplicates() { #[tokio::test] async fn api_key_catalog_does_not_replace_native_metadata_for_shared_models() { use gateway_core::routing::ProviderModelContent; - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; let oauth = MockServer::start().await; let upstream = MockServer::start().await; @@ -1245,7 +1245,7 @@ async fn api_key_catalog_does_not_replace_native_metadata_for_shared_models() { let service = service_with_catalog_cache(&store, oauth.uri(), catalog_cache()); let before = service.synchronize().await.expect("OAuth directory"); store - .seed_api_key("acct_api", upstream.uri(), ApiKeyTransport::Http) + .seed_api_key("acct_api", upstream.uri(), ResponsesTransport::Http) .await; Mock::given(method("GET")) .and(path("/models")) @@ -1298,7 +1298,7 @@ async fn api_key_catalog_does_not_replace_native_metadata_for_shared_models() { #[tokio::test] async fn slow_api_key_catalogs_share_a_deadline_and_preserve_healthy_catalogs() { - use provider_openai::credential::ApiKeyTransport; + use provider_openai::credential::ResponsesTransport; use std::time::Duration; let upstream = MockServer::start().await; @@ -1332,7 +1332,7 @@ async fn slow_api_key_catalogs_share_a_deadline_and_preserve_healthy_catalogs() .seed_api_key( "acct_fast", format!("{}/fast", upstream.uri()), - ApiKeyTransport::Http, + ResponsesTransport::Http, ) .await; accounts.push(store.account("acct_fast").expect("fast API account")); @@ -1342,7 +1342,7 @@ async fn slow_api_key_catalogs_share_a_deadline_and_preserve_healthy_catalogs() .seed_api_key( &id, format!("{}/slow", upstream.uri()), - ApiKeyTransport::Http, + ResponsesTransport::Http, ) .await; accounts.push(store.account(&id).expect("slow API account")); diff --git a/backend/crates/providers/openai/tests/credential/contract.rs b/backend/crates/providers/openai/tests/credential/contract.rs index 694784985..17c85894d 100644 --- a/backend/crates/providers/openai/tests/credential/contract.rs +++ b/backend/crates/providers/openai/tests/credential/contract.rs @@ -2020,3 +2020,26 @@ fn model_access_queue_waits_for_allowed_account_without_using_free_forbidden_acc .all(|lease| lease.account_id() == &allowed) ); } + +#[test] +fn legacy_oauth_defaults_to_websocket_and_reimport_preserves_http() { + use gateway_core::account::PlaintextCredential; + use provider_openai::credential::ResponsesTransport; + let incoming = CodexCredentialCodec::encode_new( + &secret("new-token"), + &profile("chatgpt-transport"), + Vec::new(), + ) + .unwrap(); + let mut legacy = incoming.expose_to_provider().clone(); + legacy.remove("transport"); + let runtime = CodexCredentialCodec::decode(&PlaintextCredential::new(legacy.clone())).unwrap(); + assert_eq!(runtime.transport, ResponsesTransport::PreferWebsocket); + legacy.insert("transport".to_owned(), json!("http")); + let existing = PlaintextCredential::new(legacy); + let preserved = CodexCredentialCodec::preserve_installation_id(&incoming, &existing).unwrap(); + assert_eq!( + CodexCredentialCodec::decode(&preserved).unwrap().transport, + ResponsesTransport::Http + ); +} diff --git a/backend/crates/providers/openai/tests/credential/refresh.rs b/backend/crates/providers/openai/tests/credential/refresh.rs index 46a07804a..fcb0f2e35 100644 --- a/backend/crates/providers/openai/tests/credential/refresh.rs +++ b/backend/crates/providers/openai/tests/credential/refresh.rs @@ -644,6 +644,10 @@ async fn scheduled_refresh_preserves_the_stored_token_set_when_rotation_fields_a .expect("test expiry"); seed_refreshable_account(&store, account_id, expires_at, None).await; + store.set_oauth_transport( + account_id, + provider_openai::credential::ResponsesTransport::Http, + ); service.refresh_due().await.expect("refresh cycle"); let account = store.account(account_id).expect("refreshed account"); @@ -653,6 +657,10 @@ async fn scheduled_refresh_preserves_the_stored_token_set_when_rotation_fields_a .await .expect("refreshed credential"); let runtime = CodexCredentialCodec::decode(&loaded.credential).expect("runtime credential"); + assert_eq!( + runtime.transport, + provider_openai::credential::ResponsesTransport::Http + ); let oauth = runtime.authentication.oauth().expect("OAuth credential"); assert_eq!( oauth.access_token.expose_secret(), diff --git a/backend/crates/providers/openai/tests/credential/types.rs b/backend/crates/providers/openai/tests/credential/types.rs index ab2051da2..05a7fd2e3 100644 --- a/backend/crates/providers/openai/tests/credential/types.rs +++ b/backend/crates/providers/openai/tests/credential/types.rs @@ -39,6 +39,7 @@ fn account_profile_debug_redacts_identity_fields() { #[test] fn plaintext_provider_schema_round_trips_dynamic_cookie_data() { let data = CodexCredentialData::OAuth(CodexOAuthCredentialData { + transport: provider_openai::credential::ResponsesTransport::PreferWebsocket, schema_version: 1, principal: Some(CodexCredentialPrincipal { oauth_subject: "subject-private".to_owned(), diff --git a/backend/crates/providers/openai/tests/provider/contract.rs b/backend/crates/providers/openai/tests/provider/contract.rs index e9d997ce2..b3f81fc8d 100644 --- a/backend/crates/providers/openai/tests/provider/contract.rs +++ b/backend/crates/providers/openai/tests/provider/contract.rs @@ -209,7 +209,7 @@ async fn native_openai_revalidates_translated_transport_without_reselecting() { .seed_api_key( "acct_provider_contract", upstream.uri(), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; let source = Operation::Generate(GenerateRequest::from_protocol_payload( @@ -850,9 +850,9 @@ async fn capture_replay_compatibility_request( "acct_provider_contract", base_url.clone(), if websocket { - provider_openai::credential::ApiKeyTransport::PreferWebsocket + provider_openai::credential::ResponsesTransport::PreferWebsocket } else { - provider_openai::credential::ApiKeyTransport::Http + provider_openai::credential::ResponsesTransport::Http }, ) .await; @@ -2310,7 +2310,7 @@ async fn api_websocket_precheck_and_selection_share_the_snapshot_retry_budget() .seed_api_key( "acct_provider_contract", upstream.uri(), - provider_openai::credential::ApiKeyTransport::PreferWebsocket, + provider_openai::credential::ResponsesTransport::PreferWebsocket, ) .await; store.on_credential_load(Arc::new(|store, id, count| { @@ -9612,7 +9612,7 @@ async fn api_key_native_endpoints_preserve_bodies_headers_and_own_base_url() { .seed_api_key( "acct_provider_contract", format!("{}{prefix}", upstream.uri()), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; let provider = provider_with_base_url(&store, oauth.uri()); @@ -9705,7 +9705,7 @@ async fn api_key_responses_forward_lite_memgen_and_native_compaction_without_cat .seed_api_key( "acct_provider_contract", upstream.uri(), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; Mock::given(method("GET")) @@ -9819,7 +9819,7 @@ async fn api_key_default_http_uses_own_prefix_plain_json_and_only_own_authentica .seed_api_key( "acct_provider_contract", format!("{}{prefix}", upstream.uri()), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; // 后台发现不协商客户端版本;客户端目录独立请求并按实际版本缓存。 @@ -9946,7 +9946,7 @@ async fn disabled_api_key_diagnostic_preserves_authentication_and_transport_cons .seed_api_key( account_id, upstream.uri(), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; let account = store.account(account_id).expect("API account"); @@ -10044,7 +10044,7 @@ async fn api_key_http_account_is_rejected_before_websocket_warmup_or_old_revisio .seed_api_key( "acct_provider_contract", upstream.uri(), - provider_openai::credential::ApiKeyTransport::Http, + provider_openai::credential::ResponsesTransport::Http, ) .await; let provider = provider(&store); @@ -10092,7 +10092,7 @@ async fn api_key_websocket_uses_api_path_and_bearer_without_oauth_identity() { .seed_api_key( "acct_provider_contract", base, - provider_openai::credential::ApiKeyTransport::PreferWebsocket, + provider_openai::credential::ResponsesTransport::PreferWebsocket, ) .await; let server = tokio::spawn(async move { @@ -10757,3 +10757,87 @@ async fn fast_policy_changes_preserve_the_websocket_continuation_and_meter_each_ } server.await.unwrap(); } + +#[tokio::test] +async fn oauth_http_transport_overrides_websocket_preference_and_delivers_terminal_event() { + let store = Arc::new(MemoryAccountStore::default()); + create_account(&store, "acct_provider_contract").await; + store.set_oauth_transport( + "acct_provider_contract", + provider_openai::credential::ResponsesTransport::Http, + ); + let upstream = MockServer::start().await; + Mock::given(method("POST")) + .and(path("/codex/responses")) + .and(header("authorization", "Bearer at-acct_provider_contract")) + .respond_with( + ResponseTemplate::new(200).set_body_raw(CAPTURE_COMPLETED_SSE, "text/event-stream"), + ) + .expect(1) + .mount(&upstream) + .await; + let operation = Operation::Generate(GenerateRequest::from_protocol_payload( + ProtocolPayload::json_object( + "openai", + json!({"model":"gpt-5.4", "input":"hello", "stream":true}) + .as_object() + .unwrap() + .clone(), + ) + .unwrap() + .with_context(Map::from_iter([("use_websocket".to_owned(), json!(true))])), + )); + let mut stream = provider_with_base_url(&store, upstream.uri()) + .execute( + planned_request("openai", operation), + context("req_oauth_http", CancellationToken::new()), + ) + .await + .unwrap(); + assert_eq!(stream.metadata().transport().as_str(), "http_sse"); + let mut completed = false; + while let Some(event) = stream.next().await { + completed |= event + .unwrap() + .canonical_facts() + .iter() + .any(|event| matches!(event, GatewayEvent::Completed(_))); + } + assert!(completed, "HTTP/SSE must deliver a terminal response"); + assert_eq!( + upstream.received_requests().await.unwrap().len(), + 1, + "no WebSocket attempt or replay" + ); +} + +#[tokio::test] +async fn oauth_http_transport_rejects_websocket_only_warmup_without_sending() { + let store = Arc::new(MemoryAccountStore::default()); + create_account(&store, "acct_provider_contract").await; + store.set_oauth_transport( + "acct_provider_contract", + provider_openai::credential::ResponsesTransport::Http, + ); + let upstream = MockServer::start().await; + let warmup = Operation::Generate(GenerateRequest::from_protocol_payload( + ProtocolPayload::json_object( + "openai", + json!({"model":"gpt-5.4", "input":[], "store":false, "generate":false}) + .as_object() + .unwrap() + .clone(), + ) + .unwrap(), + )); + assert!( + provider_with_base_url(&store, upstream.uri()) + .execute( + planned_request("openai", warmup), + diagnostic_context("req_oauth_warmup", "acct_provider_contract") + ) + .await + .is_err() + ); + assert!(upstream.received_requests().await.unwrap().is_empty()); +} diff --git a/backend/crates/providers/openai/tests/support.rs b/backend/crates/providers/openai/tests/support.rs index 07ec6454f..e0e1244d9 100644 --- a/backend/crates/providers/openai/tests/support.rs +++ b/backend/crates/providers/openai/tests/support.rs @@ -72,11 +72,26 @@ impl MemoryAccountStore { .expect("seed test OAuth credential"); } + pub(crate) fn set_oauth_transport( + &self, + id: &str, + transport: provider_openai::credential::ResponsesTransport, + ) { + use provider_openai::credential::CodexCredentialCodec; + let mut accounts = self.accounts.lock().unwrap(); + let stored = accounts + .get_mut(&ProviderAccountId::new(id).unwrap()) + .unwrap(); + let mut data = CodexCredentialCodec::decode_complete(&stored.credential).unwrap(); + data.oauth_mut().unwrap().transport = transport; + stored.credential = CodexCredentialCodec::encode_complete(data).unwrap(); + } + pub(crate) async fn seed_api_key( &self, id: &str, base_url: String, - transport: provider_openai::credential::ApiKeyTransport, + transport: provider_openai::credential::ResponsesTransport, ) { let credential = provider_openai::credential::CodexCredentialCodec::encode_complete( provider_openai::credential::CodexCredentialData::ApiKey( diff --git a/backend/crates/providers/xai/src/admin.rs b/backend/crates/providers/xai/src/admin.rs index 268a29b4d..02e0440fe 100644 --- a/backend/crates/providers/xai/src/admin.rs +++ b/backend/crates/providers/xai/src/admin.rs @@ -1075,6 +1075,7 @@ fn prepared_rotation( email: profile.email, plan_type: profile.plan_type, preserve_profile, + preserve_credential_state: false, provider_material: ProviderDocument::new(OpaqueProviderData::new( credential.into_inner(), )), diff --git a/docs/api.md b/docs/api.md index 0f025901c..b4b3ae811 100644 --- a/docs/api.md +++ b/docs/api.md @@ -471,7 +471,7 @@ config 返回 `{ name, plaintextKey }`,仅读取服务端会话绑定的当前 | `POST` | `/api/admin/accounts/import-tasks/stop` | `{ taskId }` | 跳过未开始的条目,已开始的条目继续完成 | | `POST` | `/api/admin/accounts/refresh` | `{ accountId }` | 手工刷新 OAuth credential(`idToken` / `accessToken` / `refreshToken`),不刷新额度 | | `POST` | `/api/admin/accounts/recover` | `{ accountId }` | 停用账号只启用调度;已启用账号强制清除本地错误/额度/cooldown 事实,不访问上游 | -| `POST` | `/api/admin/accounts/update` | `{ accountId, enabled, concurrencyLimit, weight, groupIds, notes?, modelAccess?, outboundProxyId?, outboundProxyUrl?, connection? }` | 一次更新账号设置;`connection` 仅用于编辑 OpenAI API Key 账号的连接地址、传输方式和密钥,见下文 | +| `POST` | `/api/admin/accounts/update` | `{ accountId, enabled, concurrencyLimit, weight, groupIds, notes?, modelAccess?, outboundProxyId?, outboundProxyUrl?, connection? }` | 一次更新账号设置;`connection` 用于编辑 OpenAI 账号的传输方式,以及 API Key 账号的连接地址和密钥,见下文 | | `POST` | `/api/admin/accounts/batch-update` | `{ accountIds, enabled?, concurrencyLimit?, weight?, groupIds?, modelAccess?, outboundProxyId?, outboundProxyUrl? }` | 一次事务更新所选账号;仅修改提供的字段,至少提供一项修改 | | `POST` | `/api/admin/accounts/delete` | `{ provider, accountIds }` | 批量删除 1–200 个账号 | | `GET` | `/api/admin/accounts/quota` | `accountId` | 读取当前额度,不强制访问上游;Provider 未提供额度能力时返回空额度投影 | @@ -795,14 +795,21 @@ sub2api 的 `credentials.model_mapping` 不转换为本项目的账号模型限 ``` `connection.transport` 支持 `http`、`prefer_websocket`。省略 `connection` 时只更新账号设置; -省略 `connection.apiKey` 保留当前密钥,空字符串无效。连接设置只适用于现有 OpenAI API Key 账号, +省略 `connection.apiKey` 保留当前密钥,空字符串无效。API Key 账号必须提供 `connection.baseUrl`, 不能修改账号 ID、Provider 或认证类型,也不接受 OAuth token 或通用凭据文档。 凭据与设置在同一事务中保存,任一校验或持久化失败均不落库。 +OpenAI OAuth 账号仅提交 `connection: { "transport": "http" }` 或 +`connection: { "transport": "prefer_websocket" }`,不接受 `baseUrl` 或 `apiKey`。 +OAuth 缺省使用 WS 优先;`http` 强制 Responses 请求走 HTTP/SSE,包括客户端使用 WebSocket 的普通生成请求。 +必须使用 WebSocket 的预热或连接内续写不会改用 HTTP 重放,按既有续写恢复规则处理。 +设置保留令牌、刷新计划及凭据健康状态,刷新令牌和重新授权不重置该选择。 +账号详情对 OAuth 返回 `credentialConfiguration: { transport }`。回退到不支持此设置的旧版本前,先恢复 OAuth 账号的 WS 优先。 + `GET /api/admin/accounts/detail` 对 API Key 账号额外返回 `credentialConfiguration: { base_url, transport }`; 声明连接设置能力的插件 Provider 可返回其 rotate schema 中明确公开的标量字段。字段投影 不超过 64 KiB,不接受引用、组合或条件 schema,不回显密钥、`writeOnly` 字段、 原始插件配置或 secret。不适用的账号省略该字段。 -更新会推进凭据 revision 并失效目录与连接;旧版本会话不可静默续接到新上游。 +更新会推进凭据 revision 并失效目录;API Key 的连接与续写按凭据版本隔离,旧版本会话不可静默续接到新上游。 OAuth start 使用: diff --git a/docs/architecture.md b/docs/architecture.md index c9fabb9f2..400693c46 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -291,7 +291,8 @@ OpenAI 的 OAuth 与 API Key 共用现有账号和事务。API Key 的 Base URL 标准 `data` 模型列表通过通用画像输出,完整 Codex `models` 目录保留原生对象。通用账号层按 Provider 提交的 credential state 调度,不以是否存在上游用户 ID 推断可用性;OAuth 未完成身份投影时由 Provider 保持 `unknown`。 状态恢复和未补齐身份的凭据轮换保留 `unknown`。 -API Key 默认 HTTP/SSE,可选 WS 优先;选号先验证传输资格,WS pool 与 continuation 按凭据版本隔离。 +OAuth 默认 WS 优先,可按账号选择 HTTP/SSE;API Key 默认 HTTP/SSE,可选 WS 优先。选号先验证传输资格, +API Key 的 WS pool 与 continuation 按凭据版本隔离。OAuth 传输设置变更保留凭据健康状态,不视为令牌恢复成功。 OAuth 与 API Key 共用业务请求、响应和能力透传链路,差异限定在上游地址、认证、传输配置及明确的上游请求合同适配。 OpenAI 模型目录用于发现,不因目录缺项拒绝请求;管理员配置的模型权限仍由 Core 与选号链路执行。 diff --git a/frontend/src/api/modules/accounts.ts b/frontend/src/api/modules/accounts.ts index cc79edf3a..f5cb4ebf8 100644 --- a/frontend/src/api/modules/accounts.ts +++ b/frontend/src/api/modules/accounts.ts @@ -406,7 +406,7 @@ interface AccountResetCreditConsumeParam extends AccountIdParam { } interface AccountUpdateParam { - connection?: { baseUrl: string, transport: ApiKeyConfiguration['transport'], apiKey?: string } + connection?: { baseUrl?: string, transport: ApiKeyConfiguration['transport'], apiKey?: string } outboundProxyUrl?: string outboundProxyId?: string accountId: string diff --git a/frontend/src/views/accounts/components/AccountEditModal.vue b/frontend/src/views/accounts/components/AccountEditModal.vue index 1c0c4f854..2a3632c38 100644 --- a/frontend/src/views/accounts/components/AccountEditModal.vue +++ b/frontend/src/views/accounts/components/AccountEditModal.vue @@ -3,9 +3,9 @@ import type { AccountRow } from '../constants' import type { ApiKeyAccountForm } from '../utils/upstreamApiKey' import type { AccountGroup, AccountModelAccess } from '@/api' -import { BaseButton, BaseFormItem, BaseModal, BaseTextarea } from '@codex-proxy/ui' +import { BaseButton, BaseFormItem, BaseModal, BaseSegmented, BaseTextarea } from '@codex-proxy/ui' import ProviderIconGroup from '@/components/ProviderIconGroup.vue' -import { isOpenAiApiKeyAccount } from '../utils/upstreamApiKey' +import { isOpenAiApiKeyAccount, isOpenAiOAuthAccount } from '../utils/upstreamApiKey' import AccountApiKeyFields from './AccountApiKeyFields.vue' import AccountIdentityCell from './AccountIdentityCell.vue' import AccountPlanBadge from './AccountPlanBadge.vue' @@ -26,6 +26,11 @@ const emit = defineEmits<{ const open = defineModel({ required: true }) const apiKey = defineModel('apiKey', { required: true }) +const oauthTransport = defineModel('oauthTransport', { required: true }) +const transportOptions = [ + { label: 'WS 优先', value: 'prefer_websocket' }, + { label: 'HTTP / SSE', value: 'http' }, +] const notes = defineModel('notes', { required: true }) const enabled = defineModel('enabled', { required: true }) const concurrencyLimit = defineModel('concurrencyLimit', { required: true }) @@ -61,7 +66,7 @@ const selectedGroupIds = defineModel('selectedGroupIds', { required: t -
+

上游连接

@@ -71,7 +76,13 @@ const selectedGroupIds = defineModel('selectedGroupIds', { required: t - + + + +

+ 默认 WS 优先,选择 HTTP / SSE 后仅使用 HTTP 上游连接 +

+
('selectedGroupIds', { required: t 保存更改 diff --git a/frontend/src/views/accounts/composables/useAccountEditor.ts b/frontend/src/views/accounts/composables/useAccountEditor.ts index 7e208e021..1f28c3c75 100644 --- a/frontend/src/views/accounts/composables/useAccountEditor.ts +++ b/frontend/src/views/accounts/composables/useAccountEditor.ts @@ -8,7 +8,7 @@ import { useAsyncAction } from '@/composables/useAsyncAction' import { useRequestState } from '@/composables/useRequestState' import { accountModelAccessError } from '../utils/modelAccess' import { concurrencyLimitInput, parseAccountSchedulingForm } from '../utils/schedulingForm' -import { apiKeyAccountError, emptyApiKeyAccountForm, isOpenAiApiKeyAccount, parseApiKeyConfiguration } from '../utils/upstreamApiKey' +import { apiKeyAccountError, emptyApiKeyAccountForm, isOpenAiApiKeyAccount, isOpenAiOAuthAccount, parseApiKeyConfiguration } from '../utils/upstreamApiKey' type AccountRow = Awaited>['items'][number] @@ -34,6 +34,8 @@ export function useAccountEditor(options: { const configurationLoading = configurationRequest.loading const configurationReady = shallowRef(false) const savedConfiguration = shallowRef() + const oauthTransport = shallowRef('prefer_websocket') + const savedOAuthTransport = shallowRef('prefer_websocket') async function loadConfiguration(accountId: string) { const requestId = configurationRequest.start() @@ -41,6 +43,15 @@ export function useAccountEditor(options: { const detail = await getAccountDetail({ accountId }, { signal: configurationRequest.signal }) if (!configurationRequest.isCurrent(requestId)) return + if (isOpenAiOAuthAccount(detail.account)) { + const transport = detail.credentialConfiguration?.transport + if (transport !== 'http' && transport !== 'prefer_websocket') + throw new Error('该账号没有 OAuth 上游设置') + oauthTransport.value = transport + savedOAuthTransport.value = transport + configurationReady.value = true + return + } const configuration = parseApiKeyConfiguration(detail.credentialConfiguration) if (!configuration) throw new Error('该账号没有 API Key 上游设置') @@ -75,10 +86,12 @@ export function useAccountEditor(options: { modelAccess.value = { ...account.modelAccess, models: [...account.modelAccess.models] } selectedGroupIds.value = account.groups.map(group => group.id) apiKey.value = emptyApiKeyAccountForm() + oauthTransport.value = 'prefer_websocket' + savedOAuthTransport.value = 'prefer_websocket' savedConfiguration.value = undefined configurationReady.value = false showEditModal.value = true - if (isOpenAiApiKeyAccount(account)) + if (isOpenAiApiKeyAccount(account) || isOpenAiOAuthAccount(account)) void loadConfiguration(account.id) } @@ -87,9 +100,10 @@ export function useAccountEditor(options: { if (!accountId || saving.value) return const isApiKey = isOpenAiApiKeyAccount(editingAccount.value) + const isOAuth = isOpenAiOAuthAccount(editingAccount.value) + if ((isApiKey || isOAuth) && !configurationReady.value) + return if (isApiKey) { - if (!configurationReady.value) - return const error = apiKeyAccountError(apiKey.value, true) if (error) { toast.warning(error) @@ -131,7 +145,9 @@ export function useAccountEditor(options: { ...settings, connection: connectionChanged ? { baseUrl: apiKey.value.base_url.trim(), transport: apiKey.value.transport, apiKey: apiKey.value.apiKey || undefined } - : undefined, + : isOAuth && oauthTransport.value !== savedOAuthTransport.value + ? { transport: oauthTransport.value } + : undefined, }) showEditModal.value = false toast.success('账号已更新') @@ -144,6 +160,8 @@ export function useAccountEditor(options: { return configurationRequest.invalidate() apiKey.value = emptyApiKeyAccountForm() + oauthTransport.value = 'prefer_websocket' + savedOAuthTransport.value = 'prefer_websocket' savedConfiguration.value = undefined configurationReady.value = false editingAccountId.value = null @@ -159,6 +177,7 @@ export function useAccountEditor(options: { return { apiKey, + oauthTransport, configurationLoading, configurationReady, showEditModal, diff --git a/frontend/src/views/accounts/index.vue b/frontend/src/views/accounts/index.vue index 47fa8f8e7..0b32a2ece 100644 --- a/frontend/src/views/accounts/index.vue +++ b/frontend/src/views/accounts/index.vue @@ -172,6 +172,7 @@ const { const { apiKey: editingApiKey, + oauthTransport: editingOAuthTransport, configurationLoading, configurationReady, showEditModal, @@ -424,6 +425,7 @@ const { | null | undefined): boolean { + return account?.provider === 'openai' && account.authenticationKind === 'oauth' +} + export interface ApiKeyAccountForm extends ApiKeyConfiguration { name: string apiKey: string