Add API key auth

https://feedback.yaak.app/p/header-as-auth-option
This commit is contained in:
Gregory Schier
2025-07-20 09:15:03 -07:00
parent 947926ca34
commit 144faad31f
12 changed files with 153 additions and 52 deletions
+1
View File
@@ -10,6 +10,7 @@
"packages/plugin-runtime", "packages/plugin-runtime",
"packages/plugin-runtime-types", "packages/plugin-runtime-types",
"packages/common-lib", "packages/common-lib",
"plugins/auth-apikey",
"plugins/auth-basic", "plugins/auth-basic",
"plugins/auth-bearer", "plugins/auth-bearer",
"plugins/auth-jwt", "plugins/auth-jwt",
@@ -21,7 +21,12 @@ export type CallHttpAuthenticationResponse = {
* HTTP headers to add to the request. Existing headers will be replaced, while * HTTP headers to add to the request. Existing headers will be replaced, while
* new headers will be added. * new headers will be added.
*/ */
setHeaders: Array<HttpHeader>, }; setHeaders?: Array<HttpHeader>,
/**
* Query parameters to add to the request. Existing params will be replaced, while
* new params will be added.
*/
setQueryParameters?: Array<HttpHeader>, };
export type CallHttpRequestActionArgs = { httpRequest: HttpRequest, }; export type CallHttpRequestActionArgs = { httpRequest: HttpRequest, };
@@ -253,12 +253,11 @@ export class PluginInstance {
const auth = this.#mod.authentication; const auth = this.#mod.authentication;
if (typeof auth?.onApply === 'function') { if (typeof auth?.onApply === 'function') {
applyFormInputDefaults(auth.args, payload.values); applyFormInputDefaults(auth.args, payload.values);
const result = await auth.onApply(ctx, payload);
this.#sendPayload( this.#sendPayload(
windowContext, windowContext,
{ {
type: 'call_http_authentication_response', type: 'call_http_authentication_response',
setHeaders: result.setHeaders, ...(await auth.onApply(ctx, payload)),
}, },
replyId, replyId,
); );
@@ -579,7 +578,7 @@ export class PluginInstance {
event.windowContext, event.windowContext,
payload, payload,
); );
return result.data; return result.data as any;
}, },
}, },
store: { store: {
+17
View File
@@ -0,0 +1,17 @@
{
"name": "@yaak/auth-apikey",
"displayName": "API Key Authentication",
"description": "Authenticate requests using an API key",
"repository": {
"type": "git",
"url": "https://github.com/mountain-loop/yaak.git",
"directory": "plugins/auth-apikey"
},
"private": true,
"version": "0.1.0",
"scripts": {
"build": "yaakcli build",
"dev": "yaakcli dev",
"lint": "eslint . --ext .ts,.tsx"
}
}
+53
View File
@@ -0,0 +1,53 @@
import type { PluginDefinition } from '@yaakapp/api';
export const plugin: PluginDefinition = {
authentication: {
name: 'apikey',
label: 'API Key',
shortLabel: 'API Key',
args: [
{
type: 'select',
name: 'location',
label: 'Behavior',
defaultValue: 'header',
options: [
{ label: 'Insert Header', value: 'header' },
{ label: 'Append Query Parameter', value: 'query' },
],
},
{
type: 'text',
name: 'key',
label: 'Key',
dynamic: (_ctx, { values }) => {
return values.location === 'query' ? {
label: 'Parameter Name',
description: 'The name of the query parameter to add to the request',
} : {
label: 'Header Name',
description: 'The name of the header to add to the request',
};
},
},
{
type: 'text',
name: 'value',
label: 'API Key',
optional: true,
password: true,
},
],
async onApply(_ctx, { values }) {
const key = String(values.key ?? '');
const value = String(values.value ?? '');
const location = String(values.location);
if (location === 'query') {
return { setQueryParameters: [{ name: key, value }] };
} else {
return { setHeaders: [{ name: key, value }] };
}
},
},
};
+3
View File
@@ -0,0 +1,3 @@
{
"extends": "../../tsconfig.json"
}
+2 -2
View File
@@ -69,7 +69,7 @@ pub(crate) async fn build_metadata<R: Runtime>(
let auth = request.authentication.clone(); let auth = request.authentication.clone();
let plugin_req = CallHttpAuthenticationRequest { let plugin_req = CallHttpAuthenticationRequest {
context_id: format!("{:x}", md5::compute(authentication_context_id)), context_id: format!("{:x}", md5::compute(authentication_context_id)),
values: serde_json::from_value(serde_json::to_value(&auth).unwrap()).unwrap(), values: serde_json::from_value(serde_json::to_value(&auth)?)?,
method: "POST".to_string(), method: "POST".to_string(),
url: request.url.clone(), url: request.url.clone(),
headers: metadata headers: metadata
@@ -83,7 +83,7 @@ pub(crate) async fn build_metadata<R: Runtime>(
let plugin_result = plugin_manager let plugin_result = plugin_manager
.call_http_authentication(&window, &authentication_type, plugin_req) .call_http_authentication(&window, &authentication_type, plugin_req)
.await?; .await?;
for header in plugin_result.set_headers { for header in plugin_result.set_headers.unwrap_or_default() {
metadata.insert(header.name, header.value); metadata.insert(header.name, header.value);
} }
} }
+14 -9
View File
@@ -452,10 +452,7 @@ pub async fn send_http_request<R: Runtime>(
Some(authentication_type) => { Some(authentication_type) => {
let req = CallHttpAuthenticationRequest { let req = CallHttpAuthenticationRequest {
context_id: format!("{:x}", md5::compute(auth_context_id)), context_id: format!("{:x}", md5::compute(auth_context_id)),
values: serde_json::from_value( values: serde_json::from_value(serde_json::to_value(&request.authentication)?)?,
serde_json::to_value(&request.authentication).unwrap(),
)
.unwrap(),
url: sendable_req.url().to_string(), url: sendable_req.url().to_string(),
method: sendable_req.method().to_string(), method: sendable_req.method().to_string(),
headers: sendable_req headers: sendable_req
@@ -482,11 +479,19 @@ pub async fn send_http_request<R: Runtime>(
}; };
let headers = sendable_req.headers_mut(); let headers = sendable_req.headers_mut();
for header in plugin_result.set_headers { for header in plugin_result.set_headers.unwrap_or_default() {
headers.insert( match (HeaderName::from_str(&header.name), HeaderValue::from_str(&header.value)) {
HeaderName::from_str(&header.name).unwrap(), (Ok(name), Ok(value)) => {
HeaderValue::from_str(&header.value).unwrap(), headers.insert(name, value);
); }
_ => continue,
};
}
let mut query_pairs = sendable_req.url_mut().query_pairs_mut();
for p in plugin_result.set_query_parameters.unwrap_or_default() {
println!("Adding query parameter: {:?}", p);
query_pairs.append_pair(&p.name, &p.value);
} }
} }
} }
@@ -21,7 +21,12 @@ export type CallHttpAuthenticationResponse = {
* HTTP headers to add to the request. Existing headers will be replaced, while * HTTP headers to add to the request. Existing headers will be replaced, while
* new headers will be added. * new headers will be added.
*/ */
setHeaders: Array<HttpHeader>, }; setHeaders?: Array<HttpHeader>,
/**
* Query parameters to add to the request. Existing params will be replaced, while
* new params will be added.
*/
setQueryParameters?: Array<HttpHeader>, };
export type CallHttpRequestActionArgs = { httpRequest: HttpRequest, }; export type CallHttpRequestActionArgs = { httpRequest: HttpRequest, };
+7 -1
View File
@@ -649,7 +649,13 @@ pub enum JsonPrimitive {
pub struct CallHttpAuthenticationResponse { pub struct CallHttpAuthenticationResponse {
/// HTTP headers to add to the request. Existing headers will be replaced, while /// HTTP headers to add to the request. Existing headers will be replaced, while
/// new headers will be added. /// new headers will be added.
pub set_headers: Vec<HttpHeader>, #[ts(optional)]
pub set_headers: Option<Vec<HttpHeader>>,
/// Query parameters to add to the request. Existing params will be replaced, while
/// new params will be added.
#[ts(optional)]
pub set_query_parameters: Option<Vec<HttpHeader>>,
} }
#[derive(Debug, Clone, Default, Serialize, Deserialize, TS)] #[derive(Debug, Clone, Default, Serialize, Deserialize, TS)]
+2 -1
View File
@@ -643,7 +643,8 @@ impl PluginManager {
if disabled { if disabled {
info!("Not applying disabled auth {:?}", auth_name); info!("Not applying disabled auth {:?}", auth_name);
return Ok(CallHttpAuthenticationResponse { return Ok(CallHttpAuthenticationResponse {
set_headers: Vec::new(), set_headers: None,
set_query_parameters: None
}); });
} }
+40 -34
View File
@@ -212,6 +212,35 @@ pub(crate) async fn connect<R: Runtime>(
) )
.await?; .await?;
let connection = app_handle.db().upsert_websocket_connection(
&WebsocketConnection {
workspace_id: request.workspace_id.clone(),
request_id: request_id.to_string(),
..Default::default()
},
&UpdateSource::from_window(&window),
)?;
let (mut url, url_parameters) = apply_path_placeholders(&request.url, request.url_parameters);
if !url.starts_with("ws://") && !url.starts_with("wss://") {
url.insert_str(0, "ws://");
}
// Add URL parameters to URL
let mut url = match Url::parse(&url) {
Ok(url) => url,
Err(e) => {
return Ok(app_handle.db().upsert_websocket_connection(
&WebsocketConnection {
error: Some(format!("Failed to parse URL {}", e.to_string())),
state: WebsocketConnectionState::Closed,
..connection
},
&UpdateSource::from_window(&window),
)?);
}
};
let mut headers = HeaderMap::new(); let mut headers = HeaderMap::new();
for h in request.headers.clone() { for h in request.headers.clone() {
@@ -256,11 +285,17 @@ pub(crate) async fn connect<R: Runtime>(
let plugin_result = plugin_manager let plugin_result = plugin_manager
.call_http_authentication(&window, &authentication_type, plugin_req) .call_http_authentication(&window, &authentication_type, plugin_req)
.await?; .await?;
for header in plugin_result.set_headers { for header in plugin_result.set_headers.unwrap_or_default() {
headers.insert( match (HeaderName::from_str(&header.name), HeaderValue::from_str(&header.value)) {
HeaderName::from_str(&header.name).unwrap(), (Ok(name), Ok(value)) => {
HeaderValue::from_str(&header.value).unwrap(), headers.insert(name, value);
); }
_ => continue,
};
}
let mut query_pairs = url.query_pairs_mut();
for p in plugin_result.set_query_parameters.unwrap_or_default() {
query_pairs.append_pair(&p.name, &p.value);
} }
} }
} }
@@ -271,38 +306,9 @@ pub(crate) async fn connect<R: Runtime>(
None => None, None => None,
}; };
let connection = app_handle.db().upsert_websocket_connection(
&WebsocketConnection {
workspace_id: request.workspace_id.clone(),
request_id: request_id.to_string(),
..Default::default()
},
&UpdateSource::from_window(&window),
)?;
let (receive_tx, mut receive_rx) = mpsc::channel::<Message>(128); let (receive_tx, mut receive_rx) = mpsc::channel::<Message>(128);
let mut ws_manager = ws_manager.lock().await; let mut ws_manager = ws_manager.lock().await;
let (mut url, url_parameters) = apply_path_placeholders(&request.url, request.url_parameters);
if !url.starts_with("ws://") && !url.starts_with("wss://") {
url.insert_str(0, "ws://");
}
// Add URL parameters to URL
let mut url = match Url::parse(&url) {
Ok(url) => url,
Err(e) => {
return Ok(app_handle.db().upsert_websocket_connection(
&WebsocketConnection {
error: Some(format!("Failed to parse URL {}", e.to_string())),
state: WebsocketConnectionState::Closed,
..connection
},
&UpdateSource::from_window(&window),
)?);
}
};
{ {
let valid_query_pairs = url_parameters let valid_query_pairs = url_parameters
.into_iter() .into_iter()