通过 IAM 角色授予访问权限 - Amazon SDK for .NET
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

HelloAmazon.NET 社区!请分享您的经验,帮助我们改进Amazon SDK for .NET及其学习资源进行调查。此项调查大约需要 10 分钟能完成。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

通过 IAM 角色授予访问权限

本教程向您演示如何使用Amazon SDK for .NET以在 Amazon EC2 实例上启用 IAM 角色。

Overview

所有发送给Amazon必须通过使用由Amazon。因此,您需要通过某种策略为 Amazon EC2 实例上运行的应用程序管理凭证。您必须以安全的方式分发、存储和轮换这些凭证,并且能让应用程序访问这些凭证。

借助 IAM 角色,您可以有效地管理这些证书。您可以创建 IAM 角色并使用应用程序所需的权限对其进行配置,然后将该角色附加到 EC2 实例。有关使用 IAM 角色的好处,请参阅适用于 Linux 的 EC2 用户指南适用于 Windows 的 EC2 用户指南。另请参阅有关IAM 角色(在 IAM 用户指南中)。

对于使用Amazon SDK for .NET,当应用程序为Amazon服务时,对象将搜索来自多个潜在来源的凭据。它的搜索顺序在凭证和配置文件解析

如果客户端对象找不到任何其他源的凭证,它会检索与已配置到 IAM 角色的具有相同权限且位于 EC2 实例元数据的临时凭证。这些凭证用于调用Amazon从客户端对象。

关于本教程

当您遵循本教程时,您将使用Amazon SDK for .NET(和其他工具)启动带有 IAM 角色的 Amazon EC2 实例,然后使用 IAM 角色的权限查看实例上的应用程序。

创建示例 Amazon S3 应用程序

此示例应用程序从 Amazon S3 中检索对象。要运行应用程序,您需要以下条件:

  • 包含文本文件的 Amazon S3 存储桶。

  • Amazon凭据,以允许您访问存储桶。

有关创建 Amazon S3 存储桶和上传对象的信息,请参阅Amazon S3 入门指南。有关的信息Amazon凭据,请参阅配置Amazon凭证

使用以下代码创建 .NET Core 项目。然后在您的开发计算机上测试应用程序。

注意

在您的开发计算机上安装了 .NET Core 运行时,这使您能够在不发布应用程序的情况下运行应用程序。在本教程稍后部分创建 EC2 实例时,您可以选择在实例上安装 .NET 核心运行时。这为您提供了类似的体验和较小的文件传输。

但是,您也可以选择不在实例上安装 .NET 核心运行时。如果选择此操作方法,则必须发布应用程序,以便在将其传输到实例时包括所有依赖关系。

NuGet 软件包:

编程元素:

using System; using System.Collections.Generic; using System.IO; using System.Threading.Tasks; using Amazon.S3; using Amazon.S3.Model; namespace S3GetTextItem { // = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = // Class to retrieve a text file from an S3 bucket and write it to a local file class Program { static async Task Main(string[] args) { // Parse the command line and show help if necessary var parsedArgs = CommandLine.Parse(args); if(parsedArgs.Count == 0) { PrintHelp(); return; } // Get the application parameters from the parsed arguments string bucket = CommandLine.GetParameter(parsedArgs, null, "-b", "--bucket-name"); string item = CommandLine.GetParameter(parsedArgs, null, "-t", "--text-object"); string outFile = CommandLine.GetParameter(parsedArgs, null, "-o", "--output-filename"); if( string.IsNullOrEmpty(bucket) || string.IsNullOrEmpty(item) || string.IsNullOrEmpty(outFile)) CommandLine.ErrorExit( "\nOne or more of the required arguments is missing or incorrect." + "\nRun the command with no arguments to see help."); // Create the S3 client object and get the file object from the bucket. var response = await GetObject(new AmazonS3Client(), bucket, item); // Write the contents of the file object to the given output file. var reader = new StreamReader(response.ResponseStream); string contents = reader.ReadToEnd(); using (var s = new FileStream(outFile, FileMode.Create)) using (var writer = new StreamWriter(s)) writer.WriteLine(contents); } // // Method to get an object from an S3 bucket. private static async Task<GetObjectResponse> GetObject( IAmazonS3 s3Client, string bucket, string item) { Console.WriteLine($"Retrieving {item} from bucket {bucket}."); return await s3Client.GetObjectAsync(bucket, item); } // // Command-line help private static void PrintHelp() { Console.WriteLine( "\nUsage: S3GetTextItem -b <bucket-name> -t <text-object> -o <output-filename>" + "\n -b, --bucket-name: The name of the S3 bucket." + "\n -t, --text-object: The name of the text object in the bucket." + "\n -o, --output-filename: The name of the file to write the text to."); } } // = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = // Class that represents a command line on the console or terminal // (This is the same for all examples. When you have seen it once, you can ignore it) static class CommandLine { // Method to parse a command line of the form: "--param value" or "-p value". // If "param" is found without a matching "value", Dictionary.Value is an empty string. // If "value" is found without a matching "param", Dictionary.Key is "--NoKeyN" // where "N" represents sequential numbers. public static Dictionary<string,string> Parse(string[] args) { var parsedArgs = new Dictionary<string,string>(); int i = 0, n = 0; while(i < args.Length) { // If the first argument in this iteration starts with a dash it's an option. if(args[i].StartsWith("-")) { var key = args[i++]; var value = string.Empty; // Is there a value that goes with this option? if((i < args.Length) && (!args[i].StartsWith("-"))) value = args[i++]; parsedArgs.Add(key, value); } // If the first argument in this iteration doesn't start with a dash, it's a value else { parsedArgs.Add("--NoKey" + n.ToString(), args[i++]); n++; } } return parsedArgs; } // // Method to get a parameter from the parsed command-line arguments public static string GetParameter( Dictionary<string,string> parsedArgs, string def, params string[] keys) { string retval = null; foreach(var key in keys) if(parsedArgs.TryGetValue(key, out retval)) break; return retval ?? def; } // // Exit with an error. public static void ErrorExit(string msg, int code=1) { Console.WriteLine("\nError"); Console.WriteLine(msg); Environment.Exit(code); } } }

如果需要,可以暂时删除在开发计算机上使用的凭据,以查看应用程序的响应情况。(但请务必在完成后恢复凭据。)

创建 IAM 角色

创建具有合适权限以访问 Amazon S3 的 IAM 角色。

  1. 打开 IAM 控制台

  2. 在导航窗格中,选择角色,然后选择创建角色

  3. SelectAmazon服务,查找并选择EC2,然后选择后续:Permissions (下一步:权限)

  4. 根据附加权限策略,查找并选择AmazonS3ReadOnlyAccess。如果需要,请检查策略,然后选择后续:标签

  5. 如果需要,添加标签,然后选择后续:审核

  6. 键入角色的名称和描述,然后选择创建角色。请记住此名称,因为在启动 EC2 实例时会用到它。

启动 EC2 实例并附加 IAM 角色

启动一个 EC2 实例,该实例具有您以前创建的 IAM 角色。您可以通过以下方法来执行此操作。

  • 使用 Amazon SDK for .NET

    有关此问题的信息,请参阅启动 Amazon EC2 实例,其中包括其他注意事项接近该主题的末尾。

要启动附加 IAM 角色的 EC2 实例,IAM 用户的配置必须包含特定权限。有关所需权限的更多信息,请参阅适用于 Linux 的 EC2 用户指南适用于 Windows 的 EC2 用户指南

Connect 到 EC2 实例

Connect 到 EC2 实例,以便您可以将示例应用程序转移到该实例,然后运行该应用程序。您需要包含用于启动实例的 key pair 的私有部分的文件,即 PEM 文件。

您可以按照适用于 Linux 的 EC2 用户指南适用于 Windows 的 EC2 用户指南。连接时,您可以将文件从开发计算机传输到实例的方式执行此操作。

如果您在 Windows 上使用 Visual Studio,则还可以使用适用于 Visual Studio 的工具包连接到实例。有关更多信息,请参阅 。连接到 Amazon EC2 实例中的Amazon Toolkit for Visual Studio用户指南。

在 EC2 实例上运行示例应用程序

  1. 将应用程序文件从本地驱动器复制到实例。

    传输哪些文件取决于您构建应用程序的方式以及您的实例是否安装了 .NET Core 运行时。有关如何将文件传输到实例的信息,请参阅适用于 Linux 的 EC2 用户指南适用于 Windows 的 EC2 用户指南

  2. 启动应用程序并验证其运行结果与在开发计算机上的运行结果相同。

  3. 验证应用程序是否使用 IAM 角色提供的凭证。

    1. 打开 Amazon EC2 控制台

    2. 选择实例并通过操作实例设置附加/替换IAM 角色

    3. 再次运行该应用程序并查看它返回授权错误。

清除

完成本教程后,如果您不再需要创建的 EC2 实例,请务必终止该实例以避免不必要的成本。您可以在Amazon EC2 控制台或编程方式,如终止 Amazon EC2 实例。如果需要,您还可以删除为本教程创建的其他资源。这些可能包括 IAM 角色、EC2 密钥对和 PEM 文件、安全组等。