AesCryptoServiceProvider Kelas

Definisi

Ruang nama:

System.Security.Cryptography

Rakitan:

System.Core.dll

Melakukan enkripsi dan dekripsi simetris menggunakan implementasi Antarmuka Pemrograman Aplikasi Kriptografi (CAPI) dari algoritma Standar Enkripsi Lanjutan (AES).

public ref class AesCryptoServiceProvider sealed : System::Security::Cryptography::Aes

public sealed class AesCryptoServiceProvider : System.Security.Cryptography.Aes

type AesCryptoServiceProvider = class
    inherit Aes

Public NotInheritable Class AesCryptoServiceProvider
Inherits Aes

Warisan

Object

SymmetricAlgorithm

Aes

AesCryptoServiceProvider

Contoh

Contoh berikut menunjukkan cara mengenkripsi dan mendekripsi data sampel menggunakan AesCryptoServiceProvider kelas .

using System;
using System.IO;
using System.Security.Cryptography;

namespace Aes_Example
{
    class AesExample
    {
        public static void Main()
        {
            string original = "Here is some data to encrypt!";

            // Create a new instance of the AesCryptoServiceProvider
            // class.  This generates a new key and initialization
            // vector (IV).
            using (AesCryptoServiceProvider myAes = new AesCryptoServiceProvider())
            {
                // Encrypt the string to an array of bytes.
                byte[] encrypted = EncryptStringToBytes_Aes(original, myAes.Key, myAes.IV);

                // Decrypt the bytes to a string.
                string roundtrip = DecryptStringFromBytes_Aes(encrypted, myAes.Key, myAes.IV);

                //Display the original data and the decrypted data.
                Console.WriteLine("Original:   {0}", original);
                Console.WriteLine("Round Trip: {0}", roundtrip);
            }
        }
        static byte[] EncryptStringToBytes_Aes(string plainText, byte[] Key, byte[] IV)
        {
            // Check arguments.
            if (plainText == null || plainText.Length <= 0)
                throw new ArgumentNullException("plainText");
            if (Key == null || Key.Length <= 0)
                throw new ArgumentNullException("Key");
            if (IV == null || IV.Length <= 0)
                throw new ArgumentNullException("IV");
            byte[] encrypted;

            // Create an AesCryptoServiceProvider object
            // with the specified key and IV.
            using (AesCryptoServiceProvider aesAlg = new AesCryptoServiceProvider())
            {
                aesAlg.Key = Key;
                aesAlg.IV = IV;

                // Create an encryptor to perform the stream transform.
                ICryptoTransform encryptor = aesAlg.CreateEncryptor(aesAlg.Key, aesAlg.IV);

                // Create the streams used for encryption.
                using (MemoryStream msEncrypt = new MemoryStream())
                {
                    using (CryptoStream csEncrypt = new CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write))
                    {
                        using (StreamWriter swEncrypt = new StreamWriter(csEncrypt))
                        {
                            //Write all data to the stream.
                            swEncrypt.Write(plainText);
                        }
                    }

                    encrypted = msEncrypt.ToArray();
                }
            }

            // Return the encrypted bytes from the memory stream.
            return encrypted;
        }

        static string DecryptStringFromBytes_Aes(byte[] cipherText, byte[] Key, byte[] IV)
        {
            // Check arguments.
            if (cipherText == null || cipherText.Length <= 0)
                throw new ArgumentNullException("cipherText");
            if (Key == null || Key.Length <= 0)
                throw new ArgumentNullException("Key");
            if (IV == null || IV.Length <= 0)
                throw new ArgumentNullException("IV");

            // Declare the string used to hold
            // the decrypted text.
            string plaintext = null;

            // Create an AesCryptoServiceProvider object
            // with the specified key and IV.
            using (AesCryptoServiceProvider aesAlg = new AesCryptoServiceProvider())
            {
                aesAlg.Key = Key;
                aesAlg.IV = IV;

                // Create a decryptor to perform the stream transform.
                ICryptoTransform decryptor = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV);

                // Create the streams used for decryption.
                using (MemoryStream msDecrypt = new MemoryStream(cipherText))
                {
                    using (CryptoStream csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read))
                    {
                        using (StreamReader srDecrypt = new StreamReader(csDecrypt))
                        {

                            // Read the decrypted bytes from the decrypting stream
                            // and place them in a string.
                            plaintext = srDecrypt.ReadToEnd();
                        }
                    }
                }
            }

            return plaintext;
        }
    }
}

Imports System.IO
Imports System.Security.Cryptography



Class AesExample

    Public Shared Sub Main()
        Dim original As String = "Here is some data to encrypt!"

        ' Create a new instance of the AesCryptoServiceProvider
        ' class.  This generates a new key and initialization 
        ' vector (IV).
        Using myAes As New AesCryptoServiceProvider()

            ' Encrypt the string to an array of bytes.
            Dim encrypted As Byte() = EncryptStringToBytes_Aes(original, myAes.Key, myAes.IV)

            ' Decrypt the bytes to a string.
            Dim roundtrip As String = DecryptStringFromBytes_Aes(encrypted, myAes.Key, myAes.IV)

            'Display the original data and the decrypted data.
            Console.WriteLine("Original:   {0}", original)
            Console.WriteLine("Round Trip: {0}", roundtrip)
        End Using

    End Sub

    Shared Function EncryptStringToBytes_Aes(ByVal plainText As String, ByVal Key() As Byte, ByVal IV() As Byte) As Byte() 
        ' Check arguments.
        If plainText Is Nothing OrElse plainText.Length <= 0 Then
            Throw New ArgumentNullException("plainText")
        End If
        If Key Is Nothing OrElse Key.Length <= 0 Then
            Throw New ArgumentNullException("Key")
        End If
        If IV Is Nothing OrElse IV.Length <= 0 Then
            Throw New ArgumentNullException("IV")
        End If
        Dim encrypted() As Byte
        
        ' Create an AesCryptoServiceProvider object
        ' with the specified key and IV.
        Using aesAlg As New AesCryptoServiceProvider()

            aesAlg.Key = Key
            aesAlg.IV = IV

            ' Create an encryptor to perform the stream transform.
            Dim encryptor As ICryptoTransform = aesAlg.CreateEncryptor(aesAlg.Key, aesAlg.IV)

            ' Create the streams used for encryption.
            Dim msEncrypt As New MemoryStream()
            Using csEncrypt As New CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write)
                Using swEncrypt As New StreamWriter(csEncrypt)
                    'Write all data to the stream.
                    swEncrypt.Write(plainText)
                End Using
                encrypted = msEncrypt.ToArray()

            End Using
        End Using

        ' Return the encrypted bytes from the memory stream.
        Return encrypted

    End Function 'EncryptStringToBytes_Aes

    Shared Function DecryptStringFromBytes_Aes(ByVal cipherText() As Byte,ByVal Key() As Byte, ByVal IV() As Byte) As String
        ' Check arguments.
        If cipherText Is Nothing OrElse cipherText.Length <= 0 Then
            Throw New ArgumentNullException("cipherText")
        End If
        If Key Is Nothing OrElse Key.Length <= 0 Then
            Throw New ArgumentNullException("Key")
        End If
        If IV Is Nothing OrElse IV.Length <= 0 Then
            Throw New ArgumentNullException("IV")
        End If
        ' Declare the string used to hold
        ' the decrypted text.
        Dim plaintext As String = Nothing

        ' Create an AesCryptoServiceProvider object
        ' with the specified key and IV.
        Using aesAlg As New AesCryptoServiceProvider()

            aesAlg.Key = Key
            aesAlg.IV = IV

            ' Create a decryptor to perform the stream transform.
            Dim decryptor As ICryptoTransform = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV)

            ' Create the streams used for decryption.
            Using msDecrypt As New MemoryStream(cipherText)

                Using csDecrypt As New CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read)

                    Using srDecrypt As New StreamReader(csDecrypt)

                        ' Read the decrypted bytes from the decrypting stream
                        ' and place them in a string.
                        plaintext = srDecrypt.ReadToEnd()
                    End Using
                End Using
            End Using
        End Using
        Return plaintext

    End Function 'DecryptStringFromBytes_Aes 
End Class

open System
open System.IO
open System.Security.Cryptography

let encryptStringToBytes_Aes (plainText: string, key : byte[], iv : byte[]) : byte[] =

    // Check arguments.
    if (isNull plainText || plainText.Length <= 0) then nullArg "plainText"
    if (isNull key || key.Length <= 0) then nullArg "key"
    if (isNull iv || iv.Length <= 0) then nullArg "iv"
    
    // Create an AesCryptoServiceProvider object
    // with the specified key and IV.
    use aesAlg = new AesCryptoServiceProvider()
    aesAlg.Key <- key
    aesAlg.IV <- iv

    // Create an encryptor to perform the stream transform.
    let encryptor = aesAlg.CreateEncryptor(aesAlg.Key, aesAlg.IV)

    // Create the streams used for encryption.
    use msEncrypt = new MemoryStream()
    use csEncrypt = new CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write)
    use swEncrypt = new StreamWriter(csEncrypt)
    
    //Write all data to the stream.
    swEncrypt.Write(plainText)
    swEncrypt.Flush()
    
    // Return the encrypted bytes from the memory stream.
    msEncrypt.ToArray()

let decryptStringFromBytes_Aes (cipherText : byte[], key : byte[], iv : byte[]) : string =

    // Check arguments.
    if (isNull cipherText || cipherText.Length <= 0) then nullArg "cipherText"
    if (isNull key || key.Length <= 0) then nullArg "key"
    if (isNull iv || iv.Length <= 0) then nullArg "iv"

    // Create an AesCryptoServiceProvider object
    // with the specified key and IV.
    use aesAlg = new AesCryptoServiceProvider()
    aesAlg.Key <- key
    aesAlg.IV <- iv

    // Create a decryptor to perform the stream transform.
    let decryptor = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV)

    // Create the streams used for decryption.
    use msDecrypt = new MemoryStream(cipherText)
    use csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read)
    use srDecrypt = new StreamReader(csDecrypt)

    // Read the decrypted bytes from the decrypting stream
    // and return the resulting string.
    srDecrypt.ReadToEnd()

[<EntryPoint>]
let main argv = 

    let original = "Here is some data to encrypt!"

    // Create a new instance of the AesCryptoServiceProvider
    // class.  This generates a new key and initialization 
    // vector (IV).
    use myAes = new AesCryptoServiceProvider()

    // Encrypt the string to an array of bytes.
    let encrypted = encryptStringToBytes_Aes(original, myAes.Key, myAes.IV)

    // Decrypt the bytes to a string.
    let roundtrip = decryptStringFromBytes_Aes(encrypted, myAes.Key, myAes.IV)

    //Display the original data and the decrypted data.
    Console.WriteLine("Original:   {0}", original)
    Console.WriteLine("Round Trip: {0}", roundtrip)
    0

Konstruktor

Nama	Deskripsi
AesCryptoServiceProvider()	Menginisialisasi instans baru dari kelas AesCryptoServiceProvider.

Bidang

Nama	Deskripsi
BlockSizeValue	Mewakili ukuran blok, dalam bit, dari operasi kriptografi. (Diperoleh dari SymmetricAlgorithm)
FeedbackSizeValue	Mewakili ukuran umpan balik, dalam bit, dari operasi kriptografi. (Diperoleh dari SymmetricAlgorithm)
IVValue	Mewakili vektor inisialisasi (IV) untuk algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
KeySizeValue	Mewakili ukuran, dalam bit, dari kunci rahasia yang digunakan oleh algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
KeyValue	Mewakili kunci rahasia untuk algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
LegalBlockSizesValue	Menentukan ukuran blok, dalam bit, yang didukung oleh algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
LegalKeySizesValue	Menentukan ukuran kunci, dalam bit, yang didukung oleh algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
ModeValue	Mewakili mode sandi yang digunakan dalam algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
PaddingValue	Mewakili mode padding yang digunakan dalam algoritma simetris. (Diperoleh dari SymmetricAlgorithm)

Properti

Nama	Deskripsi
BlockSize	Mendapatkan atau mengatur ukuran blok, dalam bit, dari operasi kriptografi. (Diperoleh dari SymmetricAlgorithm)
FeedbackSize	Mendapatkan atau mengatur ukuran umpan balik, dalam bit, dari operasi kriptografi untuk mode sandi Umpan Balik Sandi (CFB) dan Umpan Balik Output (OFB). (Diperoleh dari SymmetricAlgorithm)
IV	Mendapatkan atau mengatur vektor inisialisasi (IV) untuk algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
Key	Mendapatkan atau mengatur kunci konten yang digunakan untuk enkripsi dan dekripsi.
KeySize	Mendapatkan atau mengatur ukuran, dalam bit, dari kunci rahasia.
Mode	Mendapatkan atau mengatur mode untuk pengoperasian algoritma simetris. (Diperoleh dari SymmetricAlgorithm)
Padding	Mendapatkan atau mengatur mode padding yang digunakan dalam algoritma simetris. (Diperoleh dari SymmetricAlgorithm)

Metode

Nama	Deskripsi
Clear()	Merilis semua sumber daya yang SymmetricAlgorithm digunakan oleh kelas . (Diperoleh dari SymmetricAlgorithm)
CreateDecryptor()	Membuat objek dekriptor AES simetris menggunakan kunci saat ini dan vektor inisialisasi (IV).
CreateDecryptor(Byte[], Byte[])	Membuat objek dekriptor AES simetris menggunakan kunci dan vektor inisialisasi (IV) yang ditentukan.
CreateEncryptor()	Membuat objek enkripsi AES simetris menggunakan kunci saat ini dan vektor inisialisasi (IV).
CreateEncryptor(Byte[], Byte[])	Membuat objek enkripsi simetris menggunakan kunci dan vektor inisialisasi (IV) yang ditentukan.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans SymmetricAlgorithm kelas saat ini. (Diperoleh dari SymmetricAlgorithm)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang SymmetricAlgorithm digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari SymmetricAlgorithm)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GenerateIV()	Menghasilkan vektor inisialisasi acak (IV) untuk digunakan untuk algoritma.
GenerateKey()	Menghasilkan kunci acak yang akan digunakan untuk algoritma.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
ValidKeySize(Int32)	Menentukan apakah ukuran kunci yang ditentukan valid untuk algoritma saat ini. (Diperoleh dari SymmetricAlgorithm)