aws-sdk-ssooidc

IAM 身份中心 OpenID Connect (OIDC) 是一项网络服务，它允许客户端（如 CLI 或原生应用程序）注册到 IAM 身份中心。该服务还允许客户端在 IAM 身份中心成功进行身份验证和授权后检索用户的访问令牌。

使用本指南的注意事项

在您开始使用本指南之前，我们建议您首先了解有关 IAM 身份中心 OIDC 服务工作方式的重要信息。

• 当前 IAM 身份中心 OIDC 服务仅实现了 OAuth 2.0 设备授权授予标准（《https://tools.ietf.org/html/rfc8628》）中用于启用 CLI 单点登录身份验证的部分。
• 对于 CLI 的旧版本，该服务只发出 OIDC 访问令牌，因此要获取新的令牌，用户必须显式重新进行身份验证。要访问支持令牌刷新且无需重新进行身份验证的 OIDC 流，请升级到支持 OIDC 令牌刷新和可配置 IAM 身份中心会话持续时间的最新 CLI 版本（CLI V1 的 1.27.10 和 CLI V2 的 2.9.0）。有关更多信息，请参阅《配置 Amazon Web Services 访问门户会话持续时间》。
• 此服务提供的访问令牌授予对 IAM 身份中心用户分配的所有 Amazon Web Services 账户权益的访问权限，而不仅仅是特定应用程序。
• 本指南中的文档不描述将访问令牌转换为用于 IAM 保护的 Amazon Web Services 服务端点的 Amazon Web Services 认证（“sigv4”）凭据的机制。有关更多信息，请参阅《IAM 身份中心门户 API 参考指南》中的 GetRoleCredentials。

关于IAM身份中心的一般信息，请参阅《IAM身份中心用户指南》中的什么是IAM身份中心？。

入门指南

许多服务和操作都有示例代码，请查看GitHub中的示例文件夹。

SDK为每个AWS服务提供了一个crate。您必须在Rust项目中添加Tokio作为依赖项以执行异步代码。要将aws-sdk-ssooidc添加到您的项目中，请在您的Cargo.toml文件中添加以下内容

[dependencies]
aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }
aws-sdk-ssooidc = "1.40.0"
tokio = { version = "1", features = ["full"] }

然后在代码中，可以使用以下方式创建客户端

use aws_sdk_ssooidc as ssooidc;

#[::tokio::main]
async fn main() -> Result<(), ssooidc::Error> {
    let config = aws_config::load_from_env().await;
    let client = aws_sdk_ssooidc::Client::new(&config);

    // ... make some calls with the client

    Ok(())
}

有关可以发出哪些调用以及每个调用的输入和输出的信息，请参阅客户端文档。

使用SDK

在SDK发布之前，我们将把有关使用SDK的信息添加到开发者指南中。请随时通过打开问题并描述您要尝试做什么来提出指南的附加部分。

获取帮助

• GitHub讨论 - 用于想法、RFC和一般问题
• GitHub问题 - 用于错误报告和功能请求
• 生成的文档（最新版本）
• 使用示例

许可证

本项目采用Apache-2.0许可证。