Unformatierte RSA-Schlüsselbunde

Der Raw RSA-Schlüsselbund führt eine asymmetrische Verschlüsselung und Entschlüsselung von Datenschlüsseln im lokalen Speicher mit den von Ihnen bereitgestellten öffentlichen und privaten RSA-Schlüsseln durch. Sie müssen den privaten Schlüssel generieren, speichern und schützen, vorzugsweise in einem Hardware-Sicherheitsmodul (HSM) oder einem Schlüsselverwaltungssystem. Die Verschlüsselungsfunktion verschlüsselt den Datenschlüssel unter dem öffentlichen RSA-Schlüssel. Die Entschlüsselungsfunktion entschlüsselt den Datenschlüssel mithilfe des privaten Schlüssels. Sie können aus mehreren RSA-Padding-Modi auswählen.

Ein unformatierter RSA-Schlüsselbund, der verschlüsselt und entschlüsselt, muss ein asymmetrisches öffentliches und privates Schlüsselpaar enthalten. Sie können Daten jedoch mit einem Raw RSA Keyring verschlüsseln, der nur über einen öffentlichen Schlüssel verfügt, und Sie können Daten mit einem Raw RSA Schlüsselbund entschlüsseln, der nur über einen privaten Schlüssel verfügt. Sie können einen beliebigen Raw RSA-Schlüsselbund in einen Mehrfachschlüsselbund aufnehmen. Wenn Sie einen Raw RSA-Schlüsselbund mit einem öffentlichen und einem privaten Schlüssel konfigurieren, stellen Sie sicher, dass sie Teil desselben key pair sind. In einigen Sprachimplementierungen von AWS Encryption SDK wird kein Raw RSA-Schlüsselbund mit Schlüsseln aus verschiedenen Paaren erstellt. Andere verlassen sich darauf, dass Sie überprüfen, ob Ihre Schlüssel von demselben key pair stammen.

Der Raw RSA Keyring entspricht in the und the JceMasterKey AWS-Verschlüsselungs-SDK for Java in und arbeitet mit ihnen zusammen, AWS-Verschlüsselungs-SDK for Python wenn sie mit RawMasterKeyasymmetrischen RSA-Verschlüsselungsschlüsseln verwendet werden. Sie können Ihrer Daten mit einer Programmiersprachen-Implementierung verschlüsseln und mit jeder beliebigen anderen Sprachenimplementierung unter Verwendung desselben Umhüllungsschlüssels entschlüsseln. Details hierzu finden Sie unter Schlüsselbund-Kompatibilität.

Anmerkung

Der Raw RSA-Schlüsselbund unterstützt keine asymmetrischen KMS-Schlüssel. Wenn Sie asymmetrische RSA-KMS-Schlüssel verwenden möchten, Version 4. x von AWS Encryption SDK für .NET und Version 3. x der AWS-Verschlüsselungs-SDK for Java unterstützenden AWS KMS Schlüsselbunde, die symmetrische Verschlüsselung (SYMMETRIC_DEFAULT) oder asymmetrisches RSA verwenden. AWS KMS keys

Wenn Sie Daten mit einem RSA-RSA-Schlüsselbund verschlüsseln, der den öffentlichen Schlüssel eines RSA-KMS-Schlüssels enthält, können weder der RSA-KMS-Schlüssel noch ihn entschlüsseln. AWS Encryption SDK AWS KMS Sie können den privaten Schlüssel eines AWS KMS asymmetrischen KMS-Schlüssels nicht in einen Raw RSA-Schlüsselbund exportieren. Der AWS KMS Decrypt-Vorgang kann die verschlüsselte Nachricht, die zurückgegeben wird, nicht entschlüsseln. AWS Encryption SDK

Achten Sie beim Erstellen eines RSA-Schlüsselbunds in der darauf AWS-Verschlüsselungs-SDK for C, dass Sie den Inhalt der PEM-Datei, die jeden Schlüssel enthält, als Null-terminierte C-Zeichenfolge angeben, nicht als Pfad oder Dateiname. Achten Sie bei der Erstellung eines Raw RSA-Schlüsselbundes auf mögliche Inkompatibilitäten mit anderen Sprachimplementierungen JavaScript.

Namespaces und Namen

Um das RSA-Schlüsselmaterial in einem Schlüsselbund zu identifizieren, verwendet der RSA-RSA-Schlüsselbund einen Schlüsselnamespace und einen Schlüsselnamen, die Sie angeben. Diese Werte sind nicht geheim. Sie erscheinen im Klartext in der Kopfzeile der verschlüsselten Nachricht, die der Verschlüsselungsvorgang zurückgibt. Wir empfehlen, den Schlüsselnamespace und den Schlüsselnamen zu verwenden, die das RSA-Schlüsselpaar (oder seinen privaten Schlüssel) in Ihrem HSM oder Schlüsselverwaltungssystem identifizieren.

Anmerkung

Der Schlüsselnamespace und der Schlüsselname entsprechen den Feldern Provider-ID (oder Provider) und Key-ID in den Feldern und. JceMasterKey RawMasterKey

Der AWS-Verschlüsselungs-SDK for C reserviert den aws-kms Schlüsselnamespace-Wert für KMS-Schlüssel. Verwenden Sie ihn nicht in einem Raw AES Keyring oder Raw RSA Keyring mit dem. AWS-Verschlüsselungs-SDK for C

Wenn Sie verschiedene Schlüsselbunde zum Verschlüsseln und Entschlüsseln einer bestimmten Nachricht erstellen, sind der Namespace und die Namenswerte entscheidend. Wenn der Schlüsselnamespace und der Schlüsselname im Entschlüsselungsschlüsselbund nicht exakt und unter Berücksichtigung der Groß- und Kleinschreibung für den Schlüsselnamespace und den Schlüsselnamen im Verschlüsselungsschlüsselbund übereinstimmen, wird der Entschlüsselungsschlüsselbund nicht verwendet, auch wenn die Schlüssel aus demselben key pair stammen.

Der Schlüsselnamespace und der Schlüsselname des Schlüsselmaterials in den Verschlüsselungs- und Entschlüsselungsschlüsselbunden müssen identisch sein, unabhängig davon, ob der Schlüsselbund den öffentlichen RSA-Schlüssel, den privaten RSA-Schlüssel oder beide Schlüssel im key pair enthält. Nehmen wir beispielsweise an, Sie verschlüsseln Daten mit einem RSA-Rohschlüsselbund für einen öffentlichen RSA-Schlüssel mit Schlüsselnamespace und Schlüsselname. HSM_01 RSA_2048_06 Um diese Daten zu entschlüsseln, erstellen Sie einen RSA-Rohschlüsselbund mit dem privaten Schlüssel (oder key pair) und demselben Schlüsselnamespace und Namen.

Padding-Modus

Sie müssen einen Füllmodus für RSA-Rohschlüsselringe angeben, die für die Verschlüsselung und Entschlüsselung verwendet werden, oder Funktionen Ihrer Sprachimplementierung verwenden, die ihn für Sie spezifizieren.

Der AWS Encryption SDK unterstützt die folgenden Füllmodi, die den Einschränkungen der jeweiligen Sprache unterliegen. Wir empfehlen einen OAEP-Padding-Modus, insbesondere OAEP mit SHA-256 und MGF1 mit SHA-256-Padding. Der PKCS1-Padding-Modus wird nur aus Gründen der Abwärtskompatibilität unterstützt.

• OAEP mit SHA-1 und MGF1 mit SHA-1-Padding

• OAEP mit SHA-256 und MGF1 mit SHA-256-Padding

• OAEP mit SHA-384 und MGF1 mit SHA-384-Padding

• OAEP mit SHA-512 und MGF1 mit SHA-512-Padding

• PKCS1 v1.5 Polsterung

Die folgenden Beispiele zeigen, wie Sie einen RSA-Rohschlüsselbund mit dem öffentlichen und privaten Schlüssel eines RSA-Schlüsselpaars und den OAEP mit SHA-256 und MGF1 mit dem SHA-256-Padding-Modus erstellen. RSAPublicKeyRSAPrivateKeyDie Variablen und stellen das von Ihnen bereitgestellte Hauptmaterial dar.

C

Um einen RSA-Schlüsselbund in Raw zu erstellen AWS-Verschlüsselungs-SDK for C, verwenden Sie. aws_cryptosdk_raw_rsa_keyring_new

Achten Sie beim Aufbau eines Raw RSA-Schlüsselbunds in der darauf AWS-Verschlüsselungs-SDK for C, dass Sie den Inhalt der PEM-Datei, die jeden Schlüssel enthält, als Null-terminierte C-Zeichenfolge angeben, nicht als Pfad oder Dateiname. Ein vollständiges Beispiel finden Sie unter raw_rsa_keyring.c.

struct aws_allocator *alloc = aws_default_allocator();

AWS_STATIC_STRING_FROM_LITERAL(key_namespace, "HSM_01");
AWS_STATIC_STRING_FROM_LITERAL(key_name, "RSA_2048_06");

struct aws_cryptosdk_keyring *rawRsaKeyring = aws_cryptosdk_raw_rsa_keyring_new(
    alloc,
    key_namespace,
    key_name,
    private_key_from_pem,
    public_key_from_pem,
    AWS_CRYPTOSDK_RSA_OAEP_SHA256_MGF1);

C# / .NET

Verwenden Sie die Methode, um einen Raw RSA-Schlüsselbund in für.NET zu instanziieren. AWS Encryption SDK materialProviders.CreateRawRsaKeyring() Ein vollständiges Beispiel finden Sie unter RawRSA .cs. KeyringExample

Das folgende Beispiel verwendet Version 4. x von AWS Encryption SDK für .NET.

// Instantiate the AWS Encryption SDK and material providers
var esdk =  new ESDK(new AwsEncryptionSdkConfig());
var mpl = new MaterialProviders(new MaterialProvidersConfig());

var keyNamespace = "HSM_01";
var keyName = "RSA_2048_06";

// Get public and private keys from PEM files
var publicKey = new MemoryStream(System.IO.File.ReadAllBytes("RSAKeyringExamplePublicKey.pem"));
var privateKey = new MemoryStream(System.IO.File.ReadAllBytes("RSAKeyringExamplePrivateKey.pem"));

// Create the keyring input
var createRawRsaKeyringInput = new CreateRawRsaKeyringInput
{
    KeyNamespace = keyNamespace,
    KeyName = keyName,
    PaddingScheme = PaddingScheme.OAEP_SHA512_MGF1,
    PublicKey = publicKey,
    PrivateKey = privateKey
};

// Create the keyring
var rawRsaKeyring = materialProviders.CreateRawRsaKeyring(createRawRsaKeyringInput);

JavaScript Browser

Das AWS-Verschlüsselungs-SDK for JavaScript im Browser bezieht seine kryptografischen Primitive aus der WebCryptoBibliothek. Bevor Sie den Schlüsselbund erstellen, müssen Sie das Rohschlüsselmaterial verwenden importPublicKey() und/oder importPrivateKey() in das Backend importieren. WebCrypto Dadurch wird sichergestellt, dass der Schlüsselbund vollständig ist, obwohl alle Aufrufe asynchron sind. WebCrypto Das Objekt, das die Importmethoden verwenden, beinhaltet den Wrapping-Algorithmus und seinen Padding-Modus.

Verwenden Sie nach dem Import des Schlüsselmaterials die RawRsaKeyringWebCrypto() Methode, um den Schlüsselbund zu instanziieren. Beachten Sie bei der Erstellung eines RSA-Schlüsselbundes in Raw die mögliche JavaScript Inkompatibilität mit anderen Sprachimplementierungen.

Ein vollständiges Beispiel finden Sie unter rsa_simple.ts (Browser). JavaScript

const privateKey = await RawRsaKeyringWebCrypto.importPrivateKey(
  privateRsaJwKKey
)

const publicKey = await RawRsaKeyringWebCrypto.importPublicKey(
  publicRsaJwKKey
)

const keyNamespace = 'HSM_01'
const keyName = 'RSA_2048_06'

const keyring = new RawRsaKeyringWebCrypto({
  keyName,
  keyNamespace,
  publicKey,
  privateKey,
})             

JavaScript Node.js

Um einen RSA-Schlüsselbund in Node.js zu instanziieren, erstellen Sie eine neue Instanz der Klasse AWS-Verschlüsselungs-SDK for JavaScript . RawRsaKeyringNode Der wrapKey Parameter enthält den öffentlichen Schlüssel. Der unwrapKey Parameter enthält den privaten Schlüssel. Der RawRsaKeyringNode Konstruktor berechnet einen Standard-Füllmodus für Sie, obwohl Sie einen bevorzugten Füllmodus angeben können.

Beachten Sie bei der Erstellung eines RSA-Schlüsselanhängers die mögliche Inkompatibilität mit JavaScript anderen Sprachimplementierungen.

Ein vollständiges Beispiel finden Sie unter rsa_simple.ts (Node.js). JavaScript

const keyNamespace = 'HSM_01'
const keyName = 'RSA_2048_06'

const keyring = new RawRsaKeyringNode({ keyName, keyNamespace, rsaPublicKey, rsaPrivateKey})

Java

final CreateRawRsaKeyringInput keyringInput = CreateRawRsaKeyringInput.builder()
        .keyName("RSA_2048_06")
        .keyNamespace("HSM_01")
        .paddingScheme(PaddingScheme.OAEP_SHA256_MGF1)
        .publicKey(RSAPublicKey)
        .privateKey(RSAPrivateKey)
        .build();
final MaterialProviders matProv = MaterialProviders.builder()
        .MaterialProvidersConfig(MaterialProvidersConfig.builder().build())
        .build();
IKeyring rawRsaKeyring = matProv.CreateRawRsaKeyring(keyringInput);