ASP.NET Core'da çekirdek şifreleme genişletilebilirliği

IAuthenticatedEncryptorFactory arabirimi, IAuthenticatedEncryptor örneğinin nasıl oluşturulacağını bilen bir türü temsil eder. API'leri aşağıdaki gibidir.

• CreateEncryptorInstance(IKey anahtarı) : IAuthenticatedEncryptor

Belirli bir IKey örneği için, aşağıdaki kod örneğinde olduğu gibi CreateEncryptorInstance yöntemi tarafından oluşturulan kimliği doğrulanmış tüm şifreleyiciler eşdeğer kabul edilmelidir.

// we have an IAuthenticatedEncryptorFactory instance and an IKey instance
IAuthenticatedEncryptorFactory factory = ...;
IKey key = ...;

// get an encryptor instance and perform an authenticated encryption operation
ArraySegment<byte> plaintext = new ArraySegment<byte>(Encoding.UTF8.GetBytes("plaintext"));
ArraySegment<byte> aad = new ArraySegment<byte>(Encoding.UTF8.GetBytes("AAD"));
var encryptor1 = factory.CreateEncryptorInstance(key);
byte[] ciphertext = encryptor1.Encrypt(plaintext, aad);

// get another encryptor instance and perform an authenticated decryption operation
var encryptor2 = factory.CreateEncryptorInstance(key);
byte[] roundTripped = encryptor2.Decrypt(new ArraySegment<byte>(ciphertext), aad);


// the 'roundTripped' and 'plaintext' buffers should be equivalent

IAuthenticatedEncryptorDescriptor arabirimi, IAuthenticatedEncryptor örneğinin nasıl oluşturulacağını bilen bir türü temsil eder. API'leri aşağıdaki gibidir.

• CreateEncryptorInstance() : IAuthenticatedEncryptor

• ExportToXml() : XmlSerializedDescriptorInfo

IAuthenticatedEncryptor gibi bir IAuthenticatedEncryptorDescriptor örneğinin de belirli bir anahtarı sarmalama olduğu varsayılır. Bu, belirli bir IAuthenticatedEncryptorDescriptor örneği için, aşağıdaki kod örneğinde olduğu gibi CreateEncryptorInstance yöntemi tarafından oluşturulan kimliği doğrulanmış tüm şifrelemecilerin eşdeğer olarak kabul edilmesi gerektiği anlamına gelir.

// we have an IAuthenticatedEncryptorDescriptor instance
IAuthenticatedEncryptorDescriptor descriptor = ...;

// get an encryptor instance and perform an authenticated encryption operation
ArraySegment<byte> plaintext = new ArraySegment<byte>(Encoding.UTF8.GetBytes("plaintext"));
ArraySegment<byte> aad = new ArraySegment<byte>(Encoding.UTF8.GetBytes("AAD"));
var encryptor1 = descriptor.CreateEncryptorInstance();
byte[] ciphertext = encryptor1.Encrypt(plaintext, aad);

// get another encryptor instance and perform an authenticated decryption operation
var encryptor2 = descriptor.CreateEncryptorInstance();
byte[] roundTripped = encryptor2.Decrypt(new ArraySegment<byte>(ciphertext), aad);


// the 'roundTripped' and 'plaintext' buffers should be equivalent

IAuthenticatedEncryptorDescriptor arabirimi, kendisini XML'ye aktarmayı bilen bir türü temsil eder. API'leri aşağıdaki gibidir.

• ExportToXml() : XmlSerializedDescriptorInfo

AlgorithmConfiguration sınıfı, IAuthenticatedEncryptorDescriptor örneklerinin nasıl oluşturulacağını bilen bir türü temsil eder. Tek bir API'nin kullanıma sunar.

• CreateNewDescriptor() : IAuthenticatedEncryptorDescriptor

AlgorithmConfiguration'ın en üst düzey fabrika olduğunu düşünün. Yapılandırma bir şablon görevi görür. Algoritmik bilgileri sarmalar (örneğin, bu yapılandırma AES-128-GCM ana anahtarıyla tanımlayıcılar oluşturur), ancak henüz belirli bir anahtarla ilişkilendirilmemiştir.

CreateNewDescriptor çağrıldığında, yalnızca bu çağrı için yeni anahtar malzemesi oluşturulur ve bu anahtar malzemeyi ve malzemeyi kullanmak için gereken algoritma bilgilerini sarmalayan yeni bir IAuthenticatedEncryptorDescriptor oluşturulur. Anahtar malzeme yazılımda oluşturulabilir (ve bellekte tutulabilir), bir HSM içinde oluşturulabilir ve tutulabilir vb. Kritik nokta, CreateNewDescriptor'a yapılan iki çağrının hiçbir zaman eşdeğer IAuthenticatedEncryptorDescriptor örnekleri oluşturmamasıdır.

AlgorithmConfiguration türü, otomatik anahtar sıralı gibi anahtar oluşturma yordamları için giriş noktası görevi görür. Gelecekteki tüm anahtarların uygulamasını değiştirmek için KeyManagementOptions içinde AuthenticatedEncryptorConfiguration özelliğini ayarlayın.

IAuthenticatedEncryptorConfiguration arabirimi, IAuthenticatedEncryptorDescriptor örneklerinin nasıl oluşturulacağını bilen bir türü temsil eder. Tek bir API'nin kullanıma sunar.

• CreateNewDescriptor() : IAuthenticatedEncryptorDescriptor

IAuthenticatedEncryptorConfiguration'ı en üst düzey fabrika olarak düşünün. Yapılandırma bir şablon görevi görür. Algoritmik bilgileri sarmalar (örneğin, bu yapılandırma AES-128-GCM ana anahtarıyla tanımlayıcılar oluşturur), ancak henüz belirli bir anahtarla ilişkilendirilmemiştir.

CreateNewDescriptor çağrıldığında, yalnızca bu çağrı için yeni anahtar malzemesi oluşturulur ve bu anahtar malzemeyi ve malzemeyi kullanmak için gereken algoritma bilgilerini sarmalayan yeni bir IAuthenticatedEncryptorDescriptor oluşturulur. Anahtar malzeme yazılımda oluşturulabilir (ve bellekte tutulabilir), bir HSM içinde oluşturulabilir ve tutulabilir vb. Kritik nokta, CreateNewDescriptor'a yapılan iki çağrının hiçbir zaman eşdeğer IAuthenticatedEncryptorDescriptor örnekleri oluşturmamasıdır.

IAuthenticatedEncryptorConfiguration türü, otomatik anahtar döndürme gibi anahtar oluşturma yordamları için giriş noktası görevi görür. Gelecekteki tüm anahtarların uygulamasını değiştirmek için hizmet kapsayıcısına tekil bir IAuthenticatedEncryptorConfiguration kaydedin.