CryptographicEngine.DecryptAndAuthenticate 메서드

정의

네임스페이스:

Windows.Security.Cryptography.Core

데이터의 암호를 해독하고 인증합니다. 자세한 내용과 전체 코드 샘플 은 EncryptedAndAuthenticatedData를 참조하세요.

public:
 static IBuffer ^ DecryptAndAuthenticate(CryptographicKey ^ key, IBuffer ^ data, IBuffer ^ nonce, IBuffer ^ authenticationTag, IBuffer ^ authenticatedData);

 static IBuffer DecryptAndAuthenticate(CryptographicKey const& key, IBuffer const& data, IBuffer const& nonce, IBuffer const& authenticationTag, IBuffer const& authenticatedData);

public static IBuffer DecryptAndAuthenticate(CryptographicKey key, IBuffer data, IBuffer nonce, IBuffer authenticationTag, IBuffer authenticatedData);

function decryptAndAuthenticate(key, data, nonce, authenticationTag, authenticatedData)

Public Shared Function DecryptAndAuthenticate (key As CryptographicKey, data As IBuffer, nonce As IBuffer, authenticationTag As IBuffer, authenticatedData As IBuffer) As IBuffer

매개 변수

key

CryptographicKey

사용할 대칭 키입니다.

data

IBuffer

암호 해독 및 인증할 데이터입니다.

nonce

IBuffer

사용할 Nonce입니다. EncryptAndAuthenticate 메서드에서 사용하는 것과 동일한 nonce여야 합니다.

authenticationTag

IBuffer

인증 태그.

authenticatedData

IBuffer

인증된 데이터입니다. Null일 수 있습니다.

반환

IBuffer

암호 해독된 데이터를 포함하는 버퍼입니다. 메서드가 실패하면 인증이 실패합니다. 메서드가 성공하면 인증도 성공했습니다.

예제

public void AuthenticatedDecryption(
    String strAlgName,
    CryptographicKey key,
    EncryptedAndAuthenticatedData objEncrypted,
    BinaryStringEncoding encoding,
    IBuffer buffNonce)
{
    // Declare a buffer to contain the decrypted data.
    IBuffer buffDecrypted;

    // Open a SymmetricKeyAlgorithmProvider object for the specified algorithm.
    SymmetricKeyAlgorithmProvider objAlgProv = SymmetricKeyAlgorithmProvider.OpenAlgorithm(strAlgName);

    // The input key must be securely shared between the sender of the encrypted message
    // and the recipient. The nonce must also be shared but does not need to be shared
    // in a secure manner. If the sender encodes the message string to a buffer, the
    // binary encoding method must also be shared with the recipient.
    // The recipient uses the DecryptAndAuthenticate() method as follows to decrypt the 
    // message, authenticate it, and verify that it has not been altered in transit.
    buffDecrypted = CryptographicEngine.DecryptAndAuthenticate(
        key,
        objEncrypted.EncryptedData,
        buffNonce,
        objEncrypted.AuthenticationTag,
        null);

    // Convert the decrypted buffer to a string (for display). If the sender created the
    // original message buffer from a string, the sender must tell the recipient what 
    // BinaryStringEncoding value was used. Here, BinaryStringEncoding.Utf8 is used to
    // convert the message to a buffer before encryption and to convert the decrypted
    // buffer back to the original plaintext.
    String strDecrypted = CryptographicBuffer.ConvertBinaryToString(encoding, buffDecrypted);

}

설명

인증된 암호화는 한 작업에서 콘텐츠를 암호화하고 인증합니다. 태그라고도 하는 인증자는 암호화 중에 사용되며 프로세스의 출력에는 태그 암호 텍스트 쌍이 포함됩니다. 자세한 내용은 AuthenticationTag 및 EncryptedData 속성을 참조하세요. 암호 해독 프로세스는 태그에 대해 암호 텍스트를 확인합니다.

SymmetricKeyAlgorithmProvider 클래스에서 OpenAlgorithm 메서드를 호출하고 열 알고리즘의 이름을 지정한 후 인증된 암호화 알고리즘을 사용할 수 있습니다. 인증된 암호화 및 암호 해독에는 다음 알고리즘 이름이 지원됩니다.

• SymmetricAlgorithmNames.AesGcm
• SymmetricAlgorithmNames.AesCcm 다음 코드 예제를 포함하는 전체 샘플은 EncryptedAndAuthenticatedData 클래스를 참조하세요.

추가 정보

• EncryptedAndAuthenticatedData