RSACryptoServiceProvider Constructores

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblado:

System.Security.Cryptography.dll

Inicializa una nueva instancia de la clase RSACryptoServiceProvider.

Sobrecargas

RSACryptoServiceProvider()	Inicializa una nueva instancia de la clase RSACryptoServiceProvider con un par de claves aleatorio.
RSACryptoServiceProvider(Int32)	Inicializa una nueva instancia de la clase RSACryptoServiceProvider con un par de claves aleatorio del tamaño de clave especificado.
RSACryptoServiceProvider(CspParameters)	Inicializa una nueva instancia de la clase RSACryptoServiceProvider con los parámetros especificados.
RSACryptoServiceProvider(Int32, CspParameters)	Inicializa una nueva instancia de la clase RSACryptoServiceProvider con los parámetros y el tamaño de clave especificados.

RSACryptoServiceProvider()

Source:

RSACryptoServiceProvider.Unix.cs

Inicializa una nueva instancia de la clase RSACryptoServiceProvider con un par de claves aleatorio.

C#

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public RSACryptoServiceProvider ();

Atributos

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

No se puede adquirir el proveedor de servicios criptográficos (CSP).

Ejemplos

En el ejemplo de código siguiente se usa la RSACryptoServiceProvider clase para cifrar una cadena en una matriz de bytes y, a continuación, descifrar los bytes de nuevo en una cadena.

C#

using System;
using System.Security.Cryptography;
using System.Text;

class RSACSPSample
{

    static void Main()
    {
        try
        {
            //Create a UnicodeEncoder to convert between byte array and string.
            UnicodeEncoding ByteConverter = new UnicodeEncoding();

            //Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] dataToEncrypt = ByteConverter.GetBytes("Data to Encrypt");
            byte[] encryptedData;
            byte[] decryptedData;

            //Create a new instance of RSACryptoServiceProvider to generate
            //public and private key data.
            using (RSACryptoServiceProvider RSA = new RSACryptoServiceProvider())
            {

                //Pass the data to ENCRYPT, the public key information 
                //(using RSACryptoServiceProvider.ExportParameters(false),
                //and a boolean flag specifying no OAEP padding.
                encryptedData = RSAEncrypt(dataToEncrypt, RSA.ExportParameters(false), false);

                //Pass the data to DECRYPT, the private key information 
                //(using RSACryptoServiceProvider.ExportParameters(true),
                //and a boolean flag specifying no OAEP padding.
                decryptedData = RSADecrypt(encryptedData, RSA.ExportParameters(true), false);

                //Display the decrypted plaintext to the console. 
                Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));
            }
        }
        catch (ArgumentNullException)
        {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");
        }
    }

    public static byte[] RSAEncrypt(byte[] DataToEncrypt, RSAParameters RSAKeyInfo, bool DoOAEPPadding)
    {
        try
        {
            byte[] encryptedData;
            //Create a new instance of RSACryptoServiceProvider.
            using (RSACryptoServiceProvider RSA = new RSACryptoServiceProvider())
            {

                //Import the RSA Key information. This only needs
                //to include the public key information.
                RSA.ImportParameters(RSAKeyInfo);

                //Encrypt the passed byte array and specify OAEP padding.  
                //OAEP padding is only available on Microsoft Windows XP or
                //later.  
                encryptedData = RSA.Encrypt(DataToEncrypt, DoOAEPPadding);
            }
            return encryptedData;
        }
        //Catch and display a CryptographicException  
        //to the console.
        catch (CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    public static byte[] RSADecrypt(byte[] DataToDecrypt, RSAParameters RSAKeyInfo, bool DoOAEPPadding)
    {
        try
        {
            byte[] decryptedData;
            //Create a new instance of RSACryptoServiceProvider.
            using (RSACryptoServiceProvider RSA = new RSACryptoServiceProvider())
            {
                //Import the RSA Key information. This needs
                //to include the private key information.
                RSA.ImportParameters(RSAKeyInfo);

                //Decrypt the passed byte array and specify OAEP padding.  
                //OAEP padding is only available on Microsoft Windows XP or
                //later.  
                decryptedData = RSA.Decrypt(DataToDecrypt, DoOAEPPadding);
            }
            return decryptedData;
        }
        //Catch and display a CryptographicException  
        //to the console.
        catch (CryptographicException e)
        {
            Console.WriteLine(e.ToString());

            return null;
        }
    }
}

Comentarios

Este constructor crea un Exchange par de claves adecuado para cifrar las claves de sesión para que se puedan almacenar e intercambiar de forma segura con otros usuarios. La clave generada corresponde a una clave generada mediante el AT_KEYEXCHANGE valor utilizado en la API criptográfica de Microsoft (CAPI) no administrada.

Este constructor no genera inmediatamente una nueva clave pública o privada. Si no se carga ninguna clave a través del ImportParameters método , o cualquier otro método de importación de claves, antes de que se necesite una clave, se crea una clave efímera de 1024 bits a petición.

Consulte también

• servicios criptográficos

RSACryptoServiceProvider(Int32)

Source:

RSACryptoServiceProvider.Unix.cs

Inicializa una nueva instancia de la clase RSACryptoServiceProvider con un par de claves aleatorio del tamaño de clave especificado.

C#

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public RSACryptoServiceProvider (int dwKeySize);

Parámetros

dwKeySize

Int32

Tamaño de la clave que se va a usar en bits.

Atributos

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

No se puede adquirir el proveedor de servicios criptográficos (CSP).

Ejemplos

En el ejemplo de código siguiente se crea , RSACryptoServiceProviderse genera una nueva clave y se almacena en un contenedor de claves.

C#

using System;
using System.Security.Cryptography;
using System.Text;

class RSACSPSample
{

    static void Main()
    {
        try
        {
            //Create a UnicodeEncoder to convert between byte array and string.
            UnicodeEncoding ByteConverter = new UnicodeEncoding();

            //Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] dataToEncrypt = ByteConverter.GetBytes("Data to Encrypt");
            byte[] encryptedData;
            byte[] decryptedData;
            
            //Create a new instance of RSACryptoServiceProvider to generate
            //public and private key data.  Pass an integer specifying a key-
            //length of 2048.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(2048);

            //Display the key-legth to the console.
            Console.WriteLine("A new key pair of legth {0} was created", RSAalg.KeySize);

            //Pass the data to ENCRYPT, the public key information
            //(using RSACryptoServiceProvider.ExportParameters(false),
            //and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt,RSAalg.ExportParameters(false), false);

            //Pass the data to DECRYPT, the private key information
            //(using RSACryptoServiceProvider.ExportParameters(true),
            //and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData,RSAalg.ExportParameters(true), false);

            //Display the decrypted plaintext to the console.
            Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));
        }
        catch(ArgumentNullException)
        {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");
        }
    }

    static public byte[] RSAEncrypt(byte[] DataToEncrypt, RSAParameters RSAKeyInfo, bool DoOAEPPadding)
    {
        try
        {	
            //Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            //Import the RSA Key information. This only needs
            //toinclude the public key information.
            RSAalg.ImportParameters(RSAKeyInfo);

            //Encrypt the passed byte array and specify OAEP padding.
            //OAEP padding is only available on Microsoft Windows XP or
            //later.
            return RSAalg.Encrypt(DataToEncrypt, DoOAEPPadding);
        }
            //Catch and display a CryptographicException
            //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    static public byte[] RSADecrypt(byte[] DataToDecrypt, RSAParameters RSAKeyInfo,bool DoOAEPPadding)
    {
        try
        {
            //Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            //Import the RSA Key information. This needs
            //to include the private key information.
            RSAalg.ImportParameters(RSAKeyInfo);

            //Decrypt the passed byte array and specify OAEP padding.
            //OAEP padding is only available on Microsoft Windows XP or
            //later.
            return RSAalg.Decrypt(DataToDecrypt, DoOAEPPadding);
        }
            //Catch and display a CryptographicException
            //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.ToString());

            return null;
        }
    }
}

Comentarios

Este constructor crea un Exchange par de claves adecuado para cifrar las claves de sesión para que se puedan almacenar e intercambiar de forma segura con otros usuarios. La clave generada corresponde a una clave generada mediante el AT_KEYEXCHANGE valor utilizado en la API criptográfica de Microsoft (CAPI) no administrada.

Este constructor no genera inmediatamente una nueva clave pública o privada. Si no se carga ninguna clave a través del ImportParameters método o cualquier otro método de importación de claves, antes de que se necesite una clave, se crea una dwKeySizeclave efímera de bits a petición.

Consulte también

• servicios criptográficos

RSACryptoServiceProvider(CspParameters)

Source:

RSACryptoServiceProvider.Unix.cs

Inicializa una nueva instancia de la clase RSACryptoServiceProvider con los parámetros especificados.

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public RSACryptoServiceProvider (System.Security.Cryptography.CspParameters? parameters);

Parámetros

parameters

CspParameters

Parámetros que se pasan al proveedor de servicios criptográficos (CSP).

Atributos

SupportedOSPlatformAttribute

Excepciones

CryptographicException

No se puede adquirir el CSP.

Ejemplos

En el ejemplo de código siguiente se crea un RSACryptoServiceProvider objeto , se genera una nueva clave y se almacena en un contenedor de claves.

C#

using System;
using System.Security.Cryptography;
using System.Text;

class RSACSPSample
{

    static void Main()
    {
        try
        {
            string KeyContainerName = "MyKeyContainer";

            //Create a new key and persist it in
            //the key container.
            RSAPersistKeyInCSP(KeyContainerName);

            //Create a UnicodeEncoder to convert between byte array and string.
            UnicodeEncoding ByteConverter = new UnicodeEncoding();

            //Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] dataToEncrypt = ByteConverter.GetBytes("Data to Encrypt");
            byte[] encryptedData;
            byte[] decryptedData;

            //Pass the data to ENCRYPT, the name of the key container,
            //and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt,KeyContainerName, false);

            //Pass the data to DECRYPT, the name of the key container,
            //and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData,KeyContainerName, false);

            //Display the decrypted plaintext to the console.
            Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));

            RSADeleteKeyInCSP(KeyContainerName);
        }
        catch(ArgumentNullException)
        {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");
        }
    }

    public static void RSAPersistKeyInCSP(string ContainerName)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of RSACryptoServiceProvider to generate
            //a new key pair.  Pass the CspParameters class to persist the
            //key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Indicate that the key was persisted.
            Console.WriteLine("The RSA key was persisted in the container, \"{0}\".", ContainerName);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);
        }
    }

    public static void RSADeleteKeyInCSP(string ContainerName)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of RSACryptoServiceProvider.
            //Pass the CspParameters class to use the
            //key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Delete the key entry in the container.
            RSAalg.PersistKeyInCsp = false;

            //Call Clear to release resources and delete the key from the container.
            RSAalg.Clear();

            //Indicate that the key was persisted.
            Console.WriteLine("The RSA key was deleted from the container, \"{0}\".", ContainerName);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);
        }
    }

    static public byte[] RSAEncrypt(byte[] DataToEncrypt, string ContainerName, bool DoOAEPPadding)
    {
        try
        {	
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of RSACryptoServiceProvider.
            //Pass the CspParameters class to use the key
            //from the key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Encrypt the passed byte array and specify OAEP padding.
            //OAEP padding is only available on Microsoft Windows XP or
            //later.
            return RSAalg.Encrypt(DataToEncrypt, DoOAEPPadding);
        }
            //Catch and display a CryptographicException
            //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    static public byte[] RSADecrypt(byte[] DataToDecrypt, string ContainerName, bool DoOAEPPadding)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of RSACryptoServiceProvider.
            //Pass the CspParameters class to use the key
            //from the key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Decrypt the passed byte array and specify OAEP padding.
            //OAEP padding is only available on Microsoft Windows XP or
            //later.
            return RSAalg.Decrypt(DataToDecrypt, DoOAEPPadding);
        }
            //Catch and display a CryptographicException
            //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.ToString());

            return null;
        }
    }
}

Comentarios

Este constructor crea o reutiliza un contenedor de claves especificado mediante el KeyContainerName campo del parameters parámetro .

De forma predeterminada, este constructor crea un Exchange par de claves adecuado para cifrar las claves de sesión para que se puedan almacenar e intercambiar de forma segura con otros usuarios. La clave generada corresponde a una clave generada mediante el AT_KEYEXCHANGE valor utilizado en la API criptográfica de Microsoft (CAPI) no administrada.

Puede crear un Signature par de claves adecuado para autenticar (firmado digitalmente) mensajes o archivos estableciendo el KeyNumber campo del parameters parámetro en el Signature valor. Este tipo de clave corresponde al AT_SIGNATURE valor utilizado en CAPI.

Si crea un RSACryptoServiceProvider objeto con el Exchange valor especificado y, a continuación, crea otro RSACryptoServiceProvider objeto con el Signature valor especificado, ambas claves se colocarán en un único contenedor si ambos objetos especifican el mismo nombre de contenedor de claves.

Para crear una clave compatible con la firma de nombre seguro mediante la RSACryptoServiceProvider clase , debe crear un Signature par de claves.

Consulte también

• servicios criptográficos

RSACryptoServiceProvider(Int32, CspParameters)

Source:

RSACryptoServiceProvider.Unix.cs

Inicializa una nueva instancia de la clase RSACryptoServiceProvider con los parámetros y el tamaño de clave especificados.

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public RSACryptoServiceProvider (int dwKeySize, System.Security.Cryptography.CspParameters? parameters);

Parámetros

dwKeySize

Int32

Tamaño de la clave que se va a usar en bits.

parameters

CspParameters

Parámetros que se pasan al proveedor de servicios criptográficos (CSP).

Atributos

SupportedOSPlatformAttribute

Excepciones

CryptographicException

No se puede adquirir el CSP.

o bien

La clave no se puede crear.

Ejemplos

En el ejemplo de código siguiente se crea , RSACryptoServiceProviderse genera una nueva clave y se almacena en un contenedor de claves.

C#

using System;
using System.Security.Cryptography;
using System.Text;

class RSACSPSample
{

    static void Main()
    {
        try
        {
            string KeyContainerName = "MyKeyContainer";

            //Create a new key and persist it in
            //the key container.
            RSAPersistKeyInCSP(KeyContainerName);

            //Create a UnicodeEncoder to convert between byte array and string.
            UnicodeEncoding ByteConverter = new UnicodeEncoding();

            //Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] dataToEncrypt = ByteConverter.GetBytes("Data to Encrypt");
            byte[] encryptedData;
            byte[] decryptedData;

            //Pass the data to ENCRYPT, the name of the key container,
            //and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt,KeyContainerName, false);

            //Pass the data to DECRYPT, the name of the key container,
            //and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData,KeyContainerName, false);

            //Display the decrypted plaintext to the console.
            Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));

            RSADeleteKeyInCSP(KeyContainerName);
        }
        catch(ArgumentNullException)
        {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");
        }
    }

    public static void RSAPersistKeyInCSP(string ContainerName)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of RSACryptoServiceProvider to generate
            //a new key pair.  Pass the CspParameters class to persist the
            //key in the container.  Pass an intger of 2048 to specify the
            //key-size.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider( 2048, cspParams);

            //Indicate that the key was persisted.
            Console.WriteLine("The RSA key with a key-size of {0} was persisted in the container, \"{1}\".",
                              RSAalg.KeySize , ContainerName);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);
        }
    }

    public static void RSADeleteKeyInCSP(string ContainerName)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of DSACryptoServiceProvider.
            //Pass the CspParameters class to use the
            //key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Delete the key entry in the container.
            RSAalg.PersistKeyInCsp = false;

            //Call Clear to release resources and delete the key from the container.
            RSAalg.Clear();

            //Indicate that the key was persisted.
            Console.WriteLine("The RSA key was deleted from the container, \"{0}\".", ContainerName);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);
        }
    }

    static public byte[] RSAEncrypt(byte[] DataToEncrypt, string ContainerName, bool DoOAEPPadding)
    {
        try
        {	
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of DSACryptoServiceProvider.
            //Pass the CspParameters class to use the key
            //from the key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Encrypt the passed byte array and specify OAEP padding.
            //OAEP padding is only available on Microsoft Windows XP or
            //later.
            return RSAalg.Encrypt(DataToEncrypt, DoOAEPPadding);
        }
            //Catch and display a CryptographicException
            //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    static public byte[] RSADecrypt(byte[] DataToDecrypt, string ContainerName, bool DoOAEPPadding)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an RSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of DSACryptoServiceProvider.
            //Pass the CspParameters class to use the key
            //from the key in the container.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);

            //Decrypt the passed byte array and specify OAEP padding.
            //OAEP padding is only available on Microsoft Windows XP or
            //later.
            return RSAalg.Decrypt(DataToDecrypt, DoOAEPPadding);
        }
            //Catch and display a CryptographicException
            //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.ToString());

            return null;
        }
    }
}

Comentarios

Este constructor crea o reutiliza un contenedor de claves especificado mediante el KeyContainerName campo del parameters parámetro .

De forma predeterminada, este constructor crea un Exchange par de claves adecuado para cifrar las claves de sesión para que se puedan almacenar e intercambiar de forma segura con otros usuarios. La clave generada corresponde a una clave generada mediante el AT_KEYEXCHANGE valor utilizado en la API criptográfica de Microsoft (CAPI) no administrada.

Puede crear un Signature par de claves adecuado para autenticar (firmado digitalmente) mensajes o archivos estableciendo el KeyNumber campo del parameters parámetro en el Signature valor. Este tipo de clave corresponde al AT_SIGNATURE valor utilizado en CAPI.

Si crea un RSACryptoServiceProvider objeto con el Exchange valor especificado y, a continuación, crea otro RSACryptoServiceProvider objeto con el Signature valor especificado, ambas claves se colocarán en un único contenedor si ambos objetos especifican el mismo nombre de contenedor de claves.

Para crear una clave compatible con la firma de nombre seguro mediante la RSACryptoServiceProvider clase , debe crear un Signature par de claves.

Consulte también

• servicios criptográficos