RSAParameters Структура

Определение

Представляет стандартные параметры для алгоритма RSA.Represents the standard parameters for the RSA algorithm.

public value class RSAParameters
public struct RSAParameters
[System.Serializable]
public struct RSAParameters
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct RSAParameters
type RSAParameters = struct
Public Structure RSAParameters
Наследование
RSAParameters
Атрибуты

Комментарии

Класс RSA предоставляет метод ExportParameters, который позволяет получить необработанный ключ RSA в форме структуры RSAParameters.The RSA class exposes an ExportParameters method that enables you to retrieve the raw RSA key in the form of an RSAParameters structure. Понимание содержимого этой структуры требует понимания того, как работает алгоритм RSA.Understanding the contents of this structure requires familiarity with how the RSA algorithm works. В следующем разделе приводится краткое описание алгоритма.The next section discusses the algorithm briefly.

Алгоритм RSARSA Algorithm

Чтобы создать пару ключей, начните с создания двух больших простых чисел с именами p и q.To generate a key pair, you start by creating two large prime numbers named p and q. Эти числа умножаются, а результат называется n.These numbers are multiplied and the result is called n. Поскольку p и q являются простыми числами, единственными факторами для n являются 1, p, q и n.Because p and q are both prime numbers, the only factors of n are 1, p, q, and n.

Если мы будем рассматривать только числа, которые меньше n, число, относительное, равное n, то есть не имеет факторов, общих с n, равно (p-1) (q-1).If we consider only numbers that are less than n, the count of numbers that are relatively prime to n, that is, have no factors in common with n, equals (p - 1)(q - 1).

Теперь вы выбираете число e, которое относительно простое в вычисленном значении.Now you choose a number e, which is relatively prime to the value you calculated. Открытый ключ теперь представлен как {e, n}.The public key is now represented as {e, n}.

Чтобы создать закрытый ключ, необходимо вычислить значение d, которое представляет собой число (d) (e) mod (p-1) (q-1) = 1.To create the private key, you must calculate d, which is a number such that (d)(e) mod (p - 1)(q - 1) = 1. В соответствии с алгоритмом евклидово закрытый ключ теперь имеет значение {d, n}.In accordance with the Euclidean algorithm, the private key is now {d, n}.

Шифрование обычного текста m в зашифрованном тексте c определяется как c = (m ^ e) mod n.Encryption of plaintext m to ciphertext c is defined as c = (m ^ e) mod n. Расшифровка затем будет определена как m = (c ^ d) mod n.Decryption would then be defined as m = (c ^ d) mod n.

Сводка полейSummary of Fields

Раздел A. 1.2 в стандарте PKCS #1: RSA Cryptography Standard на веб-сайте RSA лаборатории определяет формат для закрытых ключей RSA.Section A.1.2 of the PKCS #1: RSA Cryptography Standard on the RSA Laboratories Web site defines a format for RSA private keys.

В следующей таблице перечислены поля структуры RSAParameters.The following table summarizes the fields of the RSAParameters structure. Третий столбец предоставляет соответствующее поле в разделе A. 1.2 из PKCS #1: стандарт RSA Cryptography Standard.The third column provides the corresponding field in section A.1.2 of PKCS #1: RSA Cryptography Standard.

ПолеRSAParametersRSAParameters field СодержитContains Соответствующее поле #1 PKCSCorresponding PKCS #1 field
D г. закрытый показатель степениd, the private exponent приватикспонентprivateExponent
DP d Mod (p-1)d mod (p - 1) exponent1exponent1
DQ d Mod (q-1)d mod (q - 1) exponent2exponent2
Exponent e, Открытый показатель степениe, the public exponent публицекспонентpublicExponent
InverseQ (Инверсек) (q) = 1 mod p(InverseQ)(q) = 1 mod p Частиcoefficient
Modulus nn остатка от деленияmodulus
P pp prime1prime1
Q qq prime2prime2

Безопасность RSA является производной от того факта, что при наличии открытого ключа {e, n} вычисление нецелесообразно для вычисления d, либо напрямую, либо путем факторинга n в p и q.The security of RSA derives from the fact that, given the public key { e, n }, it is computationally infeasible to calculate d, either directly or by factoring n into p and q. Таким образом, любая часть ключа, относящаяся к d, p или q, должна храниться в секрете.Therefore, any part of the key related to d, p, or q must be kept secret. Если вызванIf you call

ExportParameters и запросить только сведения об открытом ключе, поэтому вы получите только Exponent и Modulus.ExportParameters and ask for only the public key information, this is why you will receive only Exponent and Modulus. Другие поля доступны только в том случае, если у вас есть доступ к закрытому ключу и вы запрашиваете его.The other fields are available only if you have access to the private key, and you request it.

RSAParameters не шифруется каким-либо образом, поэтому необходимо соблюдать осторожность при его использовании со сведениями о закрытом ключе.RSAParameters is not encrypted in any way, so you must be careful when you use it with the private key information. На самом деле ни одно из полей, содержащих сведения о закрытом ключе, не может быть сериализовано.In fact, none of the fields that contain private key information can be serialized. При попытке сериализации структуры RSAParameters с вызовом удаленного взаимодействия или с помощью одного из сериализаторов вы получите только сведения об открытом ключе.If you try to serialize an RSAParameters structure with a remoting call or by using one of the serializers, you will receive only public key information. Если вы хотите передать сведения о закрытом ключе, придется вручную отправить эти данные.If you want to pass private key information, you will have to manually send that data. Во всех случаях, если любой пользователь может получить параметры, передаваемые ключи становятся бесполезными.In all cases, if anyone can derive the parameters, the key that you transmit becomes useless.

.NET Core 2.1.0 и более поздние версии: ограничения сериализации удалены, а все члены RSAParameters сериализуются..NET Core 2.1.0 and later: The serialization restrictions have been removed and all members of RSAParameters are serialized. При написании или обновлении кода в среде .NET Core 2.1.0 или более поздней версии следует соблюдать осторожность, так как если любой пользователь может наследовать или перехватить параметры закрытого ключа, ключ и все данные, зашифрованные или подписанные с помощью этого ключа, будут скомпрометированы.Care must be excercised when writing or upgrading code against .NET Core 2.1.0 or later, because if anyone can derive or intercept the private key parameters the key and all the information encrypted or signed with it are compromised.

Поля

D

Представляет параметр D для алгоритма RSA.Represents the D parameter for the RSA algorithm.

DP

Представляет параметр DP для алгоритма RSA.Represents the DP parameter for the RSA algorithm.

DQ

Представляет параметр DQ для алгоритма RSA.Represents the DQ parameter for the RSA algorithm.

Exponent

Представляет параметр Exponent для алгоритма RSA.Represents the Exponent parameter for the RSA algorithm.

InverseQ

Представляет параметр InverseQ для алгоритма RSA.Represents the InverseQ parameter for the RSA algorithm.

Modulus

Представляет параметр Modulus для алгоритма RSA.Represents the Modulus parameter for the RSA algorithm.

P

Представляет параметр P для алгоритма RSA.Represents the P parameter for the RSA algorithm.

Q

Представляет параметр Q для алгоритма RSA.Represents the Q parameter for the RSA algorithm.

Применяется к

Дополнительно