Export (0) Print
Expand All

RsaSignatureCookieTransform Class

.NET Framework 4.6 and 4.5

Provides cookie integrity using an RSA signature.


Namespace:  System.IdentityModel
Assembly:  System.IdentityModel (in System.IdentityModel.dll)

public class RsaSignatureCookieTransform : CookieTransform

The RsaSignatureCookieTransform type exposes the following members.

Public methodRsaSignatureCookieTransform(RSA)Initializes a new instance of the RsaSignatureCookieTransform class by using the specified RSA key.
Public methodRsaSignatureCookieTransform(X509Certificate2)Initializes a new instance of the RsaSignatureCookieTransform class by using the private key of the specified certificate.

Public propertyHashNameGets or sets the name of the hash algorithm to use.
Public propertySigningKeyGets or sets the RSA key that is used for signing.
Protected propertyVerificationKeysGets the collection of keys used for signature verification. By default, this property returns a list that contains only the signing key.

Public methodDecodeVerifies the specified signature and returns the original, unsigned data. (Overrides CookieTransform.Decode(Byte[]).)
Public methodEncodeSigns the specified data. (Overrides CookieTransform.Encode(Byte[]).)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

RsaSignatureCookieTransform adds an RSA MAC to the cookie data. This provides integrity but not confidentiality. By default, the MAC uses SHA-256, but SHA-1 may be requested.

Cookies protected with this transform may be read by any computer that shares the same RSA private key (generally associated with an X509 certificate).

Important noteImportant

When using the RsaSignatureCookieTransform with a service, if a key provided by a certificate changes the service must be restarted.

.NET Framework

Supported in: 4.6, 4.5

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
© 2015 Microsoft