데이터 보호: 비-DI 인식 시나리오

데이터 보호 시스템은 일반적으로 서비스 컨테이너에 추가되어 DI 메커니즘을 통해서 종속 구성 요소에 제공되도록 설계되었습니다. 그러나 경우에 따라서는 이런 구성이 불가능한 경우도 있으며, 그 대표적인 사례가 기존 응용 프로그램에 데이터 보호 시스템을 추가하는 경우입니다.

Microsoft.AspNetCore.DataProtection.Extensions 패키지는 이런 시나리오를 지원하기 위해서 DI 관련 코드 경로를 거치지 않고도 데이터 보호 시스템을 사용할 수 있도록 간편한 방법을 제공해주는 DataProtectionProvider 구체 형식을 제공합니다. 이 형식은 자체적으로 IDataProtectionProvider 인터페이스를 구현하고 있으며 생성하는 방법도 매우 쉬워서, 해당 공급자의 암호화 키를 저장할 위치를 가리키는 DirectoryInfo 개체를 전달하기만 하면 됩니다.

사용 예제:

using System;
using System.IO;
using Microsoft.AspNetCore.DataProtection;

public class Program
{
    public static void Main(string[] args)
    {
        // get the path to %LOCALAPPDATA%\myapp-keys
        string destFolder = Path.Combine(
            Environment.GetEnvironmentVariable("LOCALAPPDATA"),
            "myapp-keys");

        // instantiate the data protection system at this folder
        var dataProtectionProvider = DataProtectionProvider.Create(
            new DirectoryInfo(destFolder));

        var protector = dataProtectionProvider.CreateProtector("Program.No-DI");
        Console.Write("Enter input: ");
        string input = Console.ReadLine();

        // protect the payload
        string protectedPayload = protector.Protect(input);
        Console.WriteLine($"Protect returned: {protectedPayload}");

        // unprotect the payload
        string unprotectedPayload = protector.Unprotect(protectedPayload);
        Console.WriteLine($"Unprotect returned: {unprotectedPayload}");
    }
}

/*
 * SAMPLE OUTPUT
 *
 * Enter input: Hello world!
 * Protect returned: CfDJ8FWbAn6...ch3hAPm1NJA
 * Unprotect returned: Hello world!
 */

필요하다면 응용 프로그램 개발자가 이 문제점들을 모두 해결할 수 있습니다. DataProtectionProvider 구체 형식의 생성자에는 데이터 보호 시스템의 동작을 제어할 때 사용되는 선택적 구성 콜백을 전달할 수 있습니다. 다음 예제는 명시적으로 SetApplicationName 메서드를 호출해서 격리 기능을 활성화하고, 자동으로 Windows DPAPI를 이용해서 저장되는 키를 암호화하도록 시스템을 구성하는 방법을 보여줍니다. 만약 디렉터리가 UNC 공유를 가리키고 있다면, 관련된 모든 머신에 공유 인증서를 배포한 다음, ProtectKeysWithCertificate 메서드를 호출해서 시스템이 대신 인증서 기반 암호화를 사용하도록 구성할 수도 있습니다.

using System;
using System.IO;
using Microsoft.AspNetCore.DataProtection;

public class Program
{
    public static void Main(string[] args)
    {
        // get the path to %LOCALAPPDATA%\myapp-keys
        string destFolder = Path.Combine(
            Environment.GetEnvironmentVariable("LOCALAPPDATA"),
            "myapp-keys");

        // instantiate the data protection system at this folder
        var dataProtectionProvider = DataProtectionProvider.Create(
            new DirectoryInfo(destFolder),
            configuration =>
            {
                configuration.SetApplicationName("my app name");
                configuration.ProtectKeysWithDpapi();
            });

        var protector = dataProtectionProvider.CreateProtector("Program.No-DI");
        Console.Write("Enter input: ");
        string input = Console.ReadLine();

        // protect the payload
        string protectedPayload = protector.Protect(input);
        Console.WriteLine($"Protect returned: {protectedPayload}");

        // unprotect the payload
        string unprotectedPayload = protector.Unprotect(protectedPayload);
        Console.WriteLine($"Unprotect returned: {unprotectedPayload}");
    }
}