Skip to main content

aws_runtime/user_agent/
interceptor.rs

1/*
2 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3 * SPDX-License-Identifier: Apache-2.0
4 */
5
6use std::borrow::Cow;
7use std::fmt;
8
9use http_1x::header::{HeaderName, HeaderValue, InvalidHeaderValue, USER_AGENT};
10
11use aws_credential_types::credential_feature::AwsCredentialFeature;
12use aws_smithy_runtime::client::sdk_feature::SmithySdkFeature;
13use aws_smithy_runtime_api::box_error::BoxError;
14use aws_smithy_runtime_api::client::http::HttpClient;
15use aws_smithy_runtime_api::client::interceptors::context::{
16    BeforeTransmitInterceptorContextMut, BeforeTransmitInterceptorContextRef,
17};
18use aws_smithy_runtime_api::client::interceptors::{dyn_dispatch_hint, Intercept};
19use aws_smithy_runtime_api::client::runtime_components::RuntimeComponents;
20use aws_smithy_types::config_bag::ConfigBag;
21use aws_types::app_name::AppName;
22use aws_types::os_shim_internal::Env;
23
24use crate::sdk_feature::AwsSdkFeature;
25use crate::user_agent::metrics::ProvideBusinessMetric;
26use crate::user_agent::{AdditionalMetadata, ApiMetadata, AwsUserAgent, InvalidMetadataValue};
27
28macro_rules! add_metrics_unique {
29    ($features:expr, $ua:expr, $added:expr) => {
30        for feature in $features {
31            if let Some(m) = feature.provide_business_metric() {
32                if !$added.contains(&m) {
33                    $added.insert(m.clone());
34                    $ua.add_business_metric(m);
35                }
36            }
37        }
38    };
39}
40
41macro_rules! add_metrics_unique_reverse {
42    ($features:expr, $ua:expr, $added:expr) => {
43        let mut unique_metrics = Vec::new();
44        for feature in $features {
45            if let Some(m) = feature.provide_business_metric() {
46                if !$added.contains(&m) {
47                    $added.insert(m.clone());
48                    unique_metrics.push(m);
49                }
50            }
51        }
52        for m in unique_metrics.into_iter().rev() {
53            $ua.add_business_metric(m);
54        }
55    };
56}
57
58#[allow(clippy::declare_interior_mutable_const)] // we will never mutate this
59const X_AMZ_USER_AGENT: HeaderName = HeaderName::from_static("x-amz-user-agent");
60
61#[derive(Debug)]
62enum UserAgentInterceptorError {
63    MissingApiMetadata,
64    InvalidHeaderValue(InvalidHeaderValue),
65    InvalidMetadataValue(InvalidMetadataValue),
66}
67
68impl std::error::Error for UserAgentInterceptorError {
69    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
70        match self {
71            Self::InvalidHeaderValue(source) => Some(source),
72            Self::InvalidMetadataValue(source) => Some(source),
73            Self::MissingApiMetadata => None,
74        }
75    }
76}
77
78impl fmt::Display for UserAgentInterceptorError {
79    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
80        f.write_str(match self {
81            Self::InvalidHeaderValue(_) => "AwsUserAgent generated an invalid HTTP header value. This is a bug. Please file an issue.",
82            Self::InvalidMetadataValue(_) => "AwsUserAgent generated an invalid metadata value. This is a bug. Please file an issue.",
83            Self::MissingApiMetadata => "The UserAgentInterceptor requires ApiMetadata to be set before the request is made. This is a bug. Please file an issue.",
84        })
85    }
86}
87
88impl From<InvalidHeaderValue> for UserAgentInterceptorError {
89    fn from(err: InvalidHeaderValue) -> Self {
90        UserAgentInterceptorError::InvalidHeaderValue(err)
91    }
92}
93
94impl From<InvalidMetadataValue> for UserAgentInterceptorError {
95    fn from(err: InvalidMetadataValue) -> Self {
96        UserAgentInterceptorError::InvalidMetadataValue(err)
97    }
98}
99
100/// Generates and attaches the AWS SDK's user agent to a HTTP request
101#[non_exhaustive]
102#[derive(Debug, Default)]
103pub struct UserAgentInterceptor;
104
105impl UserAgentInterceptor {
106    /// Creates a new `UserAgentInterceptor`
107    pub fn new() -> Self {
108        UserAgentInterceptor
109    }
110}
111
112fn header_values(
113    ua: &AwsUserAgent,
114) -> Result<(HeaderValue, HeaderValue), UserAgentInterceptorError> {
115    // Pay attention to the extremely subtle difference between ua_header and aws_ua_header below...
116    Ok((
117        HeaderValue::try_from(ua.ua_header())?,
118        HeaderValue::try_from(ua.aws_ua_header())?,
119    ))
120}
121
122#[dyn_dispatch_hint]
123impl Intercept for UserAgentInterceptor {
124    fn name(&self) -> &'static str {
125        "UserAgentInterceptor"
126    }
127
128    fn read_after_serialization(
129        &self,
130        _context: &BeforeTransmitInterceptorContextRef<'_>,
131        _runtime_components: &RuntimeComponents,
132        cfg: &mut ConfigBag,
133    ) -> Result<(), BoxError> {
134        // Allow for overriding the user agent by an earlier interceptor (so, for example,
135        // tests can use `AwsUserAgent::for_tests()`) by attempting to grab one out of the
136        // config bag before creating one.
137        if cfg.load::<AwsUserAgent>().is_some() {
138            return Ok(());
139        }
140
141        let api_metadata = cfg
142            .load::<ApiMetadata>()
143            .ok_or(UserAgentInterceptorError::MissingApiMetadata)?;
144        let mut ua = AwsUserAgent::new_from_environment(Env::real(), api_metadata.clone());
145
146        let maybe_app_name = cfg.load::<AppName>();
147        if let Some(app_name) = maybe_app_name {
148            ua.set_app_name(app_name.clone());
149        }
150
151        // Drain customer-supplied framework metadata appended via `StoreAppend`.
152        //
153        // `ConfigBag::load` over a `StoreAppend` type yields every appended value across ALL config
154        // layers in reverse insertion order (newest-first), e.g. entries copied in from `SdkConfig`
155        // followed by client-level entries come back last-to-first. To present entries to the
156        // customer in deterministic first-seen (insertion) order, we collect and reverse the
157        // iterator. We dedup on the exact (name, version) pair, preserving first-seen order, and
158        // cap the total number of unique entries at 10.
159        const MAX_FRAMEWORK_METADATA: usize = 10;
160        let appended: Vec<&aws_types::sdk_ua_metadata::FrameworkMetadata> = cfg
161            .load::<aws_types::sdk_ua_metadata::FrameworkMetadata>()
162            .collect();
163        let mut seen = std::collections::HashSet::new();
164        let mut kept = 0usize;
165        for md in appended.into_iter().rev() {
166            let key = (md.name().to_owned(), md.version().map(|v| v.to_owned()));
167            if !seen.insert(key) {
168                // Duplicate (name, version) -- skip.
169                continue;
170            }
171            if kept >= MAX_FRAMEWORK_METADATA {
172                tracing::warn!(
173                    "More than {MAX_FRAMEWORK_METADATA} unique framework metadata entries \
174                     were configured; only the first {MAX_FRAMEWORK_METADATA} will be included \
175                     in the user agent."
176                );
177                break;
178            }
179            // `md` is already the canonical `FrameworkMetadata` type, so no conversion is needed.
180            ua.add_framework_metadata(md.clone());
181            kept += 1;
182        }
183
184        cfg.interceptor_state().store_put(ua);
185
186        Ok(())
187    }
188
189    fn modify_before_signing(
190        &self,
191        context: &mut BeforeTransmitInterceptorContextMut<'_>,
192        runtime_components: &RuntimeComponents,
193        cfg: &mut ConfigBag,
194    ) -> Result<(), BoxError> {
195        let mut ua = cfg
196            .load::<AwsUserAgent>()
197            .expect("`AwsUserAgent should have been created in `read_before_execution`")
198            .clone();
199
200        let mut added_metrics = std::collections::HashSet::new();
201
202        add_metrics_unique!(cfg.load::<SmithySdkFeature>(), &mut ua, &mut added_metrics);
203        add_metrics_unique!(cfg.load::<AwsSdkFeature>(), &mut ua, &mut added_metrics);
204        // The order we emit credential features matters.
205        // Reverse to preserve emission order since StoreAppend pops backwards.
206        add_metrics_unique_reverse!(
207            cfg.load::<AwsCredentialFeature>(),
208            &mut ua,
209            &mut added_metrics
210        );
211
212        let maybe_connector_metadata = runtime_components
213            .http_client()
214            .and_then(|c| c.connector_metadata());
215        if let Some(connector_metadata) = maybe_connector_metadata {
216            let am = AdditionalMetadata::new(Cow::Owned(connector_metadata.to_string()))?;
217            ua.add_additional_metadata(am);
218        }
219
220        let headers = context.request_mut().headers_mut();
221        let (user_agent, x_amz_user_agent) = header_values(&ua)?;
222        headers.append(USER_AGENT, user_agent);
223        headers.append(X_AMZ_USER_AGENT, x_amz_user_agent);
224        Ok(())
225    }
226}
227
228#[cfg(test)]
229mod tests {
230    use super::*;
231    use aws_smithy_runtime_api::client::interceptors::context::{Input, InterceptorContext};
232    use aws_smithy_runtime_api::client::interceptors::Intercept;
233    use aws_smithy_runtime_api::client::orchestrator::HttpRequest;
234    use aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder;
235    use aws_smithy_types::config_bag::{ConfigBag, Layer};
236    use aws_smithy_types::error::display::DisplayErrorContext;
237
238    fn expect_header<'a>(context: &'a InterceptorContext, header_name: &str) -> &'a str {
239        context
240            .request()
241            .expect("request is set")
242            .headers()
243            .get(header_name)
244            .unwrap()
245    }
246
247    fn context() -> InterceptorContext {
248        let mut context = InterceptorContext::new(Input::doesnt_matter());
249        context.enter_serialization_phase();
250        context.set_request(HttpRequest::empty());
251        let _ = context.take_input();
252        context.enter_before_transmit_phase();
253        context
254    }
255
256    #[test]
257    fn test_overridden_ua() {
258        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
259        let mut context = context();
260
261        let mut layer = Layer::new("test");
262        layer.store_put(AwsUserAgent::for_tests());
263        layer.store_put(ApiMetadata::new("unused", "unused"));
264        let mut cfg = ConfigBag::of_layers(vec![layer]);
265
266        let interceptor = UserAgentInterceptor::new();
267        let mut ctx = Into::into(&mut context);
268        interceptor
269            .modify_before_signing(&mut ctx, &rc, &mut cfg)
270            .unwrap();
271
272        let ua_header = expect_header(&context, "user-agent");
273        assert_eq!(AwsUserAgent::for_tests().ua_header(), ua_header);
274        assert!(!ua_header.contains("unused"));
275
276        let aws_ua_header = expect_header(&context, "x-amz-user-agent");
277        assert_eq!(AwsUserAgent::for_tests().ua_header(), aws_ua_header);
278        assert!(!aws_ua_header.contains("unused"));
279    }
280
281    #[test]
282    fn test_default_ua() {
283        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
284        let mut context = context();
285
286        let api_metadata = ApiMetadata::new("some-service", "some-version");
287        let mut layer = Layer::new("test");
288        layer.store_put(api_metadata.clone());
289        let mut config = ConfigBag::of_layers(vec![layer]);
290
291        let interceptor = UserAgentInterceptor::new();
292        let ctx = Into::into(&context);
293        interceptor
294            .read_after_serialization(&ctx, &rc, &mut config)
295            .unwrap();
296        let mut ctx = Into::into(&mut context);
297        interceptor
298            .modify_before_signing(&mut ctx, &rc, &mut config)
299            .unwrap();
300
301        let expected_ua = AwsUserAgent::new_from_environment(Env::real(), api_metadata);
302        assert!(
303            expected_ua.aws_ua_header().contains("some-service"),
304            "precondition"
305        );
306        assert_eq!(
307            expected_ua.ua_header(),
308            expect_header(&context, "user-agent")
309        );
310        assert_eq!(
311            expected_ua.aws_ua_header(),
312            expect_header(&context, "x-amz-user-agent")
313        );
314    }
315
316    #[test]
317    fn test_modify_before_signing_no_duplicate_metrics() {
318        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
319        let mut context = context();
320
321        let api_metadata = ApiMetadata::new("test-service", "1.0");
322        let mut layer = Layer::new("test");
323        layer.store_put(api_metadata);
324        // Duplicate features
325        layer.store_append(SmithySdkFeature::Waiter);
326        layer.store_append(SmithySdkFeature::Waiter);
327        layer.store_append(AwsSdkFeature::S3Transfer);
328        layer.store_append(AwsSdkFeature::S3Transfer);
329        layer.store_append(AwsCredentialFeature::CredentialsCode);
330        layer.store_append(AwsCredentialFeature::CredentialsCode);
331        let mut config = ConfigBag::of_layers(vec![layer]);
332
333        let interceptor = UserAgentInterceptor::new();
334        let ctx = Into::into(&context);
335        interceptor
336            .read_after_serialization(&ctx, &rc, &mut config)
337            .unwrap();
338        let mut ctx = Into::into(&mut context);
339        interceptor
340            .modify_before_signing(&mut ctx, &rc, &mut config)
341            .unwrap();
342
343        let ua_header = expect_header(&context, "x-amz-user-agent");
344        let aws_ua_header = expect_header(&context, "x-amz-user-agent");
345        let ua_metrics_section = ua_header.split(" m/").nth(1).unwrap();
346        let aws_ua_metrics_section = aws_ua_header.split(" m/").nth(1).unwrap();
347        assert_eq!(ua_metrics_section, aws_ua_metrics_section);
348
349        let waiter_count = ua_metrics_section.matches("B").count();
350        let s3_transfer_count = ua_metrics_section.matches("G").count();
351        let credentials_code_count = ua_metrics_section.matches("e").count();
352        assert_eq!(
353            1, waiter_count,
354            "Waiter metric should appear only once, but found {waiter_count} occurrences in: {aws_ua_header}",
355        );
356        assert_eq!(1, s3_transfer_count, "S3Transfer metric should appear only once, but found {s3_transfer_count} occurrences in metrics section: {aws_ua_header}");
357        assert_eq!(1, credentials_code_count, "CredentialsCode metric should appear only once, but found {credentials_code_count} occurrences in metrics section: {aws_ua_header}");
358    }
359
360    #[test]
361    fn test_metrics_order_preserved() {
362        use aws_credential_types::credential_feature::AwsCredentialFeature;
363
364        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
365        let mut context = context();
366
367        let api_metadata = ApiMetadata::new("test-service", "1.0");
368        let mut layer = Layer::new("test");
369        layer.store_put(api_metadata);
370        layer.store_append(AwsCredentialFeature::CredentialsCode);
371        layer.store_append(AwsCredentialFeature::CredentialsEnvVars);
372        layer.store_append(AwsCredentialFeature::CredentialsProfile);
373        let mut config = ConfigBag::of_layers(vec![layer]);
374
375        let interceptor = UserAgentInterceptor::new();
376        let ctx = Into::into(&context);
377        interceptor
378            .read_after_serialization(&ctx, &rc, &mut config)
379            .unwrap();
380        let mut ctx = Into::into(&mut context);
381        interceptor
382            .modify_before_signing(&mut ctx, &rc, &mut config)
383            .unwrap();
384
385        let ua_header = expect_header(&context, "user-agent");
386        let ua_metrics_section = ua_header.split(" m/").nth(1).unwrap();
387        assert_eq!(
388            ua_metrics_section, "e,g,n",
389            "AwsCredentialFeature metrics should preserve order"
390        );
391
392        let aws_ua_header = expect_header(&context, "x-amz-user-agent");
393        let aws_ua_metrics_section = aws_ua_header.split(" m/").nth(1).unwrap();
394        assert_eq!(
395            aws_ua_metrics_section, "e,g,n",
396            "AwsCredentialFeature metrics should preserve order"
397        );
398    }
399
400    #[test]
401    fn test_app_name() {
402        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
403        let mut context = context();
404
405        let api_metadata = ApiMetadata::new("some-service", "some-version");
406        let mut layer = Layer::new("test");
407        layer.store_put(api_metadata);
408        layer.store_put(AppName::new("my_awesome_app").unwrap());
409        let mut config = ConfigBag::of_layers(vec![layer]);
410
411        let interceptor = UserAgentInterceptor::new();
412        let ctx = Into::into(&context);
413        interceptor
414            .read_after_serialization(&ctx, &rc, &mut config)
415            .unwrap();
416        let mut ctx = Into::into(&mut context);
417        interceptor
418            .modify_before_signing(&mut ctx, &rc, &mut config)
419            .unwrap();
420
421        let app_value = "app/my_awesome_app";
422        let ua_header = expect_header(&context, "user-agent");
423        assert!(
424            ua_header.contains(app_value),
425            "expected `{ua_header}` to contain `{app_value}`"
426        );
427
428        let aws_ua_header = expect_header(&context, "x-amz-user-agent");
429        assert!(
430            aws_ua_header.contains(app_value),
431            "expected `{aws_ua_header}` to contain `{app_value}`"
432        );
433    }
434
435    fn run_interceptor_with_framework_metadata(
436        entries: Vec<aws_types::sdk_ua_metadata::FrameworkMetadata>,
437    ) -> String {
438        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
439        let mut context = context();
440
441        let api_metadata = ApiMetadata::new("some-service", "some-version");
442        let mut layer = Layer::new("test");
443        layer.store_put(api_metadata);
444        for entry in entries {
445            layer.store_append(entry);
446        }
447        let mut config = ConfigBag::of_layers(vec![layer]);
448
449        let interceptor = UserAgentInterceptor::new();
450        let ctx = Into::into(&context);
451        interceptor
452            .read_after_serialization(&ctx, &rc, &mut config)
453            .unwrap();
454        let mut ctx = Into::into(&mut context);
455        interceptor
456            .modify_before_signing(&mut ctx, &rc, &mut config)
457            .unwrap();
458
459        expect_header(&context, "x-amz-user-agent").to_string()
460    }
461
462    #[test]
463    fn test_framework_metadata() {
464        use aws_types::sdk_ua_metadata::FrameworkMetadata;
465
466        let header = run_interceptor_with_framework_metadata(vec![
467            FrameworkMetadata::new("framework-one", Some("1.0")).unwrap(),
468            FrameworkMetadata::new("framework-two", Some("2.0")).unwrap(),
469        ]);
470
471        assert!(
472            header.contains("lib/framework-one/1.0"),
473            "expected `{header}` to contain `lib/framework-one/1.0`"
474        );
475        assert!(
476            header.contains("lib/framework-two/2.0"),
477            "expected `{header}` to contain `lib/framework-two/2.0`"
478        );
479        // First-seen order must be preserved.
480        let pos_one = header.find("lib/framework-one/1.0").unwrap();
481        let pos_two = header.find("lib/framework-two/2.0").unwrap();
482        assert!(
483            pos_one < pos_two,
484            "expected framework-one before framework-two in `{header}`"
485        );
486    }
487
488    #[test]
489    fn test_framework_metadata_dedup() {
490        use aws_types::sdk_ua_metadata::FrameworkMetadata;
491
492        let header = run_interceptor_with_framework_metadata(vec![
493            FrameworkMetadata::new("dup-framework", Some("1.0")).unwrap(),
494            FrameworkMetadata::new("dup-framework", Some("1.0")).unwrap(),
495        ]);
496
497        assert_eq!(
498            1,
499            header.matches("lib/dup-framework/1.0").count(),
500            "expected `lib/dup-framework/1.0` to appear exactly once in `{header}`"
501        );
502    }
503
504    #[test]
505    fn test_framework_metadata_cap() {
506        use aws_types::sdk_ua_metadata::FrameworkMetadata;
507
508        let entries = (0..15)
509            .map(|i| FrameworkMetadata::new(format!("framework-{i}"), Some("1.0")).unwrap())
510            .collect();
511        let header = run_interceptor_with_framework_metadata(entries);
512
513        let count = header.matches("lib/framework-").count();
514        assert_eq!(
515            10, count,
516            "expected at most 10 framework metadata entries, found {count} in `{header}`"
517        );
518    }
519
520    #[test]
521    fn test_framework_metadata_cap_boundary() {
522        use aws_types::sdk_ua_metadata::FrameworkMetadata;
523
524        // Exactly 10 unique entries: all retained.
525        let ten = (0..10)
526            .map(|i| FrameworkMetadata::new(format!("fw-{i}"), Some("1.0")).unwrap())
527            .collect();
528        let header = run_interceptor_with_framework_metadata(ten);
529        for i in 0..10 {
530            assert!(
531                header.contains(&format!("lib/fw-{i}/1.0")),
532                "expected `lib/fw-{i}/1.0` in `{header}`"
533            );
534        }
535
536        // Eleven unique entries: the first 10 (first-seen) are retained, the 11th is dropped.
537        let eleven = (0..11)
538            .map(|i| FrameworkMetadata::new(format!("gw-{i}"), Some("1.0")).unwrap())
539            .collect();
540        let header = run_interceptor_with_framework_metadata(eleven);
541        assert_eq!(
542            10,
543            header.matches("lib/gw-").count(),
544            "expected exactly 10 entries in `{header}`"
545        );
546        assert!(
547            !header.contains("lib/gw-10/1.0"),
548            "the 11th entry should be dropped in `{header}`"
549        );
550    }
551
552    #[test]
553    fn test_framework_metadata_dedup_preserves_first_occurrence_order() {
554        use aws_types::sdk_ua_metadata::FrameworkMetadata;
555
556        // A duplicate of an earlier entry must not reorder the surviving entries.
557        let header = run_interceptor_with_framework_metadata(vec![
558            FrameworkMetadata::new("a", Some("1.0")).unwrap(),
559            FrameworkMetadata::new("b", Some("1.0")).unwrap(),
560            FrameworkMetadata::new("a", Some("1.0")).unwrap(), // duplicate of the first
561            FrameworkMetadata::new("c", Some("1.0")).unwrap(),
562        ]);
563
564        let pa = header.find("lib/a/1.0").expect("a present");
565        let pb = header.find("lib/b/1.0").expect("b present");
566        let pc = header.find("lib/c/1.0").expect("c present");
567        assert!(
568            pa < pb && pb < pc,
569            "expected first-seen order a, b, c in `{header}`"
570        );
571        assert_eq!(
572            1,
573            header.matches("lib/a/1.0").count(),
574            "duplicate entry should appear once in `{header}`"
575        );
576    }
577
578    #[test]
579    fn test_framework_metadata_no_version() {
580        use aws_types::sdk_ua_metadata::FrameworkMetadata;
581
582        let header = run_interceptor_with_framework_metadata(vec![FrameworkMetadata::new(
583            "noversion-framework",
584            None::<&str>,
585        )
586        .unwrap()]);
587
588        assert!(
589            header.contains("lib/noversion-framework"),
590            "expected `lib/noversion-framework` in `{header}`"
591        );
592        assert!(
593            !header.contains("lib/noversion-framework/"),
594            "expected no trailing slash for a versionless entry in `{header}`"
595        );
596    }
597
598    #[test]
599    fn test_framework_metadata_across_layers_preserves_first_seen_order() {
600        use aws_types::sdk_ua_metadata::FrameworkMetadata;
601
602        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
603        let mut context = context();
604
605        // Simulate the real flow: entries copied in from `SdkConfig` live in an earlier (base)
606        // layer, and client-level entries are appended in a later layer. First-seen order must be
607        // preserved across both layers despite `StoreAppend` loading newest-first.
608        let mut base_layer = Layer::new("from_sdk_config");
609        base_layer.store_put(ApiMetadata::new("some-service", "some-version"));
610        base_layer.store_append(FrameworkMetadata::new("from-sdk-config", Some("1.0")).unwrap());
611
612        let mut client_layer = Layer::new("from_client");
613        client_layer.store_append(FrameworkMetadata::new("from-client", Some("2.0")).unwrap());
614
615        let mut config = ConfigBag::of_layers(vec![base_layer, client_layer]);
616
617        let interceptor = UserAgentInterceptor::new();
618        let ctx = Into::into(&context);
619        interceptor
620            .read_after_serialization(&ctx, &rc, &mut config)
621            .unwrap();
622        let mut ctx = Into::into(&mut context);
623        interceptor
624            .modify_before_signing(&mut ctx, &rc, &mut config)
625            .unwrap();
626        let header = expect_header(&context, "x-amz-user-agent");
627
628        let pos_sdk = header
629            .find("lib/from-sdk-config/1.0")
630            .expect("sdk-config entry present");
631        let pos_client = header
632            .find("lib/from-client/2.0")
633            .expect("client entry present");
634        assert!(
635            pos_sdk < pos_client,
636            "expected the SdkConfig entry before the client entry in `{header}`"
637        );
638    }
639
640    #[test]
641    fn test_api_metadata_missing() {
642        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
643        let context = context();
644        let mut config = ConfigBag::base();
645
646        let interceptor = UserAgentInterceptor::new();
647        let ctx = Into::into(&context);
648
649        let error = format!(
650            "{}",
651            DisplayErrorContext(
652                &*interceptor
653                    .read_after_serialization(&ctx, &rc, &mut config)
654                    .expect_err("it should error")
655            )
656        );
657        assert!(
658            error.contains("This is a bug"),
659            "`{error}` should contain message `This is a bug`"
660        );
661    }
662
663    #[test]
664    fn test_api_metadata_missing_with_ua_override() {
665        let rc = RuntimeComponentsBuilder::for_tests().build().unwrap();
666        let mut context = context();
667
668        let mut layer = Layer::new("test");
669        layer.store_put(AwsUserAgent::for_tests());
670        let mut config = ConfigBag::of_layers(vec![layer]);
671
672        let interceptor = UserAgentInterceptor::new();
673        let mut ctx = Into::into(&mut context);
674
675        interceptor
676            .modify_before_signing(&mut ctx, &rc, &mut config)
677            .expect("it should succeed");
678
679        let ua_header = expect_header(&context, "user-agent");
680        assert_eq!(AwsUserAgent::for_tests().ua_header(), ua_header);
681        assert!(!ua_header.contains("unused"));
682
683        let aws_ua_header = expect_header(&context, "x-amz-user-agent");
684        assert_eq!(AwsUserAgent::for_tests().ua_header(), aws_ua_header);
685        assert!(!aws_ua_header.contains("unused"));
686    }
687}