authorization 的安装和配置教程

1. 项目基础介绍和主要编程语言

authorization 是一个为 GraphQL.NET 提供授权工具集的开源项目。它允许开发者在 GraphQL.NET 应用中实现对图类型（GraphType）的访问控制。该项目主要是用 C# 编写的，它是 .NET 平台上的一种流行的编程语言，以它的强类型、面向对象和安全性等特点而著称。

2. 项目使用的关键技术和框架

本项目依赖于以下几个关键技术框架：

• GraphQL.NET：一个用于构建 GraphQL 服务的 .NET 库。
• ASP.NET Core：一个开源的、跨平台的框架，用于构建现代的、云基础的、互联网连接的应用程序。
• 依赖注入（DI）：.NET Core 的一个功能，允许将依赖关系注入到类中，从而实现控制反转（IoC）。
• 授权策略：用于定义授权规则，控制用户对资源的访问。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装之前，请确保您已经满足了以下条件：

• 安装了 .NET Core SDK。
• 安装了 Git。
• 熟悉基本的命令行操作。

安装步骤

以下是在您的本地环境中安装 authorization 的步骤：

1. 克隆项目

   打开命令行，使用以下命令克隆项目仓库：

   git clone https://github.com/graphql-dotnet/authorization.git
   

2. 安装依赖项

   进入项目目录：

   cd authorization
   

   使用 dotnet 命令安装项目所需的依赖项：

   dotnet restore
   

3. 构建项目

   构建项目以编译所有的源代码文件：

   dotnet build
   

4. 添加授权到您的 GraphQL 项目

   在您的 GraphQL 项目中，您需要在依赖注入容器中注册授权类。在调用 AddGraphQL 方法时，添加 AddAuthorization：

   services.AddGraphQL(serverBuilder =>
       serverBuilder
           .AddAuthorization()
           // ... 其他配置项
   );
   

5. 配置授权策略

   定义授权策略并应用于 GraphType 或 Field。例如：

   public class MyType : ObjectGraphType
   {
       public MyType()
       {
           this.AuthorizeWithPolicy("AdminPolicy");
           Field<StringGraphType>("name")
               .AuthorizeWithPolicy("SomePolicy");
       }
   }
   

6. 使用授权属性

   如果您使用的是 Schema + Handler 语法，可以使用 AuthorizeAttribute 属性：

   [Authorize("MyPolicy")]
   public class MutationType
   {
       [Authorize("AnotherPolicy")]
       public async Task<string> CreateSomething(MyInput input)
       {
           return await SomeMethodAsync(input);
       }
   
       [Authorize("SuperPolicy")]
       public string SomeProperty => Guid.NewGuid().ToString();
   }
   

7. 运行项目

   使用以下命令运行您的 GraphQL 服务：

   dotnet run
   

按照以上步骤操作，您就可以成功安装并配置 authorization 项目，开始在您的 GraphQL.NET 应用中实现授权功能了。