gcloud_sdk/token_source/
metadata.rs

1use url::form_urlencoded::Serializer;
2
3use async_trait::async_trait;
4use hyper::http::uri::PathAndQuery;
5use secret_vault_value::SecretValue;
6use std::convert::TryFrom;
7use std::str::FromStr;
8use tracing::*;
9
10use crate::token_source::gce::gce_metadata_client::GceMetadataClient;
11use crate::token_source::{BoxSource, Source, Token, TokenResponse};
12
13#[derive(Debug)]
14pub struct Metadata {
15    account: String,
16    scopes: Vec<String>,
17    client: GceMetadataClient,
18}
19
20impl Metadata {
21    pub fn new(scopes: impl Into<Vec<String>>) -> Self {
22        Self::with_account(scopes, "default".to_string())
23    }
24
25    pub fn with_account(scopes: impl Into<Vec<String>>, account: String) -> Self {
26        Self {
27            account,
28            scopes: scopes.into(),
29            client: GceMetadataClient::new(),
30        }
31    }
32
33    pub async fn init(&mut self) -> bool {
34        self.client.init().await
35    }
36
37    fn uri_suffix(&self) -> String {
38        let query = if self.scopes.is_empty() {
39            String::new()
40        } else {
41            Serializer::new(String::new())
42                .append_pair("scopes", &self.scopes.join(","))
43                .finish()
44        };
45        format!("instance/service-accounts/{}/token?{}", self.account, query)
46    }
47
48    pub async fn detect_google_project_id(&self) -> Option<String> {
49        match PathAndQuery::from_str("/computeMetadata/v1/project/project-id") {
50            Ok(url) if self.client.is_available() => {
51                trace!("Receiving Project ID token from Metadata Server");
52                self.client
53                    .get(url)
54                    .await
55                    .ok()
56                    .map(|project_id| project_id.trim().to_string())
57            }
58            Ok(_) => None,
59            Err(e) => {
60                error!("Internal URL format error: '{}'", e);
61                None
62            }
63        }
64    }
65
66    pub async fn id_token(&self, audience: &str) -> crate::error::Result<SecretValue> {
67        let url = PathAndQuery::from_str(
68            format!(
69                "/computeMetadata/v1/instance/service-accounts/{}/identity?audience={}",
70                self.account, audience
71            )
72            .as_str(),
73        )?;
74        trace!(
75            "Receiving a new ID token from Metadata Server using '{}'",
76            url
77        );
78        let resp = self.client.get(url).await?;
79        Ok(SecretValue::from(resp))
80    }
81}
82
83impl From<Metadata> for BoxSource {
84    fn from(v: Metadata) -> Self {
85        Box::new(v)
86    }
87}
88
89#[async_trait]
90impl Source for Metadata {
91    async fn token(&self) -> crate::error::Result<Token> {
92        let url =
93            PathAndQuery::from_str(format!("/computeMetadata/v1/{}", self.uri_suffix()).as_str())?;
94        trace!("Receiving a new token from Metadata Server using '{}'", url);
95
96        let resp_str = self.client.get(url).await?;
97        let resp = TokenResponse::try_from(resp_str.as_str())?;
98        Token::try_from(resp)
99    }
100}
101
102pub async fn from_metadata(
103    scopes: &[String],
104    account: String,
105) -> crate::error::Result<Option<Metadata>> {
106    let mut metadata = Metadata::with_account(scopes, account);
107
108    if metadata.init().await {
109        Ok(Some(metadata))
110    } else {
111        Ok(None)
112    }
113}
114
115#[cfg(test)]
116mod test {
117    use super::*;
118
119    #[test]
120    fn test_metadata_uri_suffix() {
121        let m = Metadata::new(Vec::new());
122        assert_eq!(m.uri_suffix(), "instance/service-accounts/default/token?");
123
124        let m = Metadata::new(crate::GCP_DEFAULT_SCOPES.clone());
125
126        assert_eq!(
127            m.uri_suffix(),
128            "instance/service-accounts/default/token?scopes=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform"
129        );
130
131        let m = Metadata::new(vec!["scope1".into(), "scope2".into()]);
132        assert_eq!(
133            m.uri_suffix(),
134            "instance/service-accounts/default/token?scopes=scope1%2Cscope2",
135        );
136    }
137}