Add device-code authorization for gateway OAuth (#59822)

## Why

Gateway sign-in needs an alternative for terminals that cannot open a browser.

## What changed

- Add optional `gateway_oauth.device_authorization_url` configuration and a `login_with_device_code` API that presents a verification URL and user code, polls for approval, and persists the resulting credentials.
- Use the configured proxy and network policy, validate verification URLs, and bound OAuth responses. Support cancellation and report denied or expired codes without exposing issuer error details.

## Testing

Add tests for successful authorization and credential persistence, unsafe verification URLs, network-policy denials, denied and expired codes, and cancellation during approval or credential storage.

GitOrigin-RevId: 96398578fb866d34929e85c04eadf468d8cd3255
This commit is contained in:
smurching-oai
2026-11-06 04:24:04 +00:00
committed by copyberry
parent aece559654
commit df38cb3b2a
22 changed files with 568 additions and 8 deletions
+4
View File
@@ -2127,6 +2127,10 @@
},
"description": "Omit to send the gateway token via the Authorization header"
},
"device_authorization_url": {
"description": "Optional device endpoint used when the terminal cannot open a browser for gateway sign-in.",
"type": "string"
},
"redirect_port": {
"format": "uint16",
"minimum": 0.0,
+1
View File
@@ -30,6 +30,7 @@ pub mod code_mode_host;
pub mod context_snapshot;
pub mod exec_server;
pub mod hooks;
pub mod oauth;
pub mod process;
pub mod responses;
pub mod runtime_auth;
+36
View File
@@ -0,0 +1,36 @@
//! Mock OAuth endpoints for device sign-in tests.
use serde_json::json;
use wiremock::Mock;
use wiremock::MockGuard;
use wiremock::MockServer;
use wiremock::ResponseTemplate;
use wiremock::matchers::body_string_contains;
use wiremock::matchers::method;
use wiremock::matchers::path;
/// Issues a challenge and answers one token poll. The guard lets a test wait for that poll.
pub async fn mount_device_code_grant(
server: &MockServer,
token_response: ResponseTemplate,
) -> MockGuard {
Mock::given(method("POST"))
.and(path("/devicecode"))
.respond_with(ResponseTemplate::new(200).set_body_json(json!({
"device_code": "secret-device-code", "user_code": "ABCD-EFGH",
"verification_uri": "https://login.example/device", "expires_in": 60, "interval": 1,
})))
.expect(1)
.mount(server)
.await;
Mock::given(method("POST"))
.and(path("/token"))
.and(body_string_contains(
"grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Adevice_code",
))
.and(body_string_contains("device_code=secret-device-code"))
.respond_with(token_response)
.expect(1)
.mount_as_scoped(server)
.await
}
@@ -101,6 +101,7 @@ async fn runtime_harness(
fn gateway_config(server: &MockServer, delivery: GatewayOAuthDelivery) -> GatewayOAuthConfig {
GatewayOAuthConfig::OAuth(GatewayOAuthSettings {
authorization_url: format!("{}/authorize", server.uri()),
device_authorization_url: None,
token_url: format!("{}/token", server.uri()),
client_id: "client".into(),
resource: None,