1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
//-----------------------------------------------------------------------
// <copyright file="ReceivingTokenEventArgs.cs" company="Outercurve Foundation">
// Copyright (c) Outercurve Foundation. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------
namespace DotNetOpenAuth.InfoCard {
using System;
using System.Collections.Generic;
using System.Diagnostics.CodeAnalysis;
using System.IdentityModel.Tokens;
using System.Security.Cryptography.X509Certificates;
using Validation;
/// <summary>
/// Arguments for the <see cref="InfoCardSelector.ReceivingToken"/> event.
/// </summary>
public class ReceivingTokenEventArgs : EventArgs {
/// <summary>
/// Initializes a new instance of the <see cref="ReceivingTokenEventArgs"/> class.
/// </summary>
/// <param name="tokenXml">The raw token XML, prior to any decryption.</param>
internal ReceivingTokenEventArgs(string tokenXml) {
Requires.NotNull(tokenXml, "tokenXml");
this.TokenXml = tokenXml;
this.IsEncrypted = Token.IsEncrypted(this.TokenXml);
this.DecryptingTokens = new List<SecurityToken>();
}
/// <summary>
/// Gets a value indicating whether the token is encrypted.
/// </summary>
/// <value>
/// <c>true</c> if the token is encrypted; otherwise, <c>false</c>.
/// </value>
public bool IsEncrypted { get; private set; }
/// <summary>
/// Gets the raw token XML, prior to any decryption.
/// </summary>
public string TokenXml { get; private set; }
/// <summary>
/// Gets or sets a value indicating whether processing
/// this token should be canceled.
/// </summary>
/// <value><c>true</c> if cancel; otherwise, <c>false</c>.</value>
/// <remarks>
/// If set the <c>true</c>, the <see cref="InfoCardSelector.ReceivedToken"/>
/// event will never be fired.
/// </remarks>
public bool Cancel { get; set; }
/// <summary>
/// Gets a list where security tokens such as X.509 certificates may be
/// added to be used for token decryption.
/// </summary>
internal IList<SecurityToken> DecryptingTokens { get; private set; }
/// <summary>
/// Adds a security token that may be used to decrypt the incoming token.
/// </summary>
/// <param name="securityToken">The security token.</param>
public void AddDecryptingToken(SecurityToken securityToken) {
Requires.NotNull(securityToken, "securityToken");
this.DecryptingTokens.Add(securityToken);
}
/// <summary>
/// Adds an X.509 certificate with a private key that may be used to decrypt the incoming token.
/// </summary>
/// <param name="certificate">The certificate.</param>
[SuppressMessage("Microsoft.Reliability", "CA2000:Dispose objects before losing scope", Justification = "False positive")]
public void AddDecryptingToken(X509Certificate2 certificate) {
Requires.NotNull(certificate, "certificate");
Requires.That(certificate.HasPrivateKey, "certificate", "requires private key");
var cert = new X509SecurityToken(certificate);
try {
this.AddDecryptingToken(cert);
} catch {
cert.Dispose();
throw;
}
}
#if CONTRACTS_FULL
/// <summary>
/// Verifies conditions that should be true for any valid state of this object.
/// </summary>
[SuppressMessage("Microsoft.Performance", "CA1822:MarkMembersAsStatic", Justification = "Called by code contracts.")]
[SuppressMessage("Microsoft.Performance", "CA1811:AvoidUncalledPrivateCode", Justification = "Called by code contracts.")]
[ContractInvariantMethod]
private void ObjectInvariant() {
Contract.Invariant(this.TokenXml != null);
Contract.Invariant(this.DecryptingTokens != null);
}
#endif
}
}
|
