MailSecurityMode 列挙体
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
SOAP メッセージ セキュリティを有効にするかどうかを定義します。
名前空間: Microsoft.ServiceModel.Channels.Mail
アセンブリ: Microsoft.ServiceModel.Channels.Mail (Microsoft.ServiceModel.Channels.Mail.dll 内)
構文
'宣言
Public Enumeration MailSecurityMode
'使用
Dim instance As MailSecurityMode
public enum MailSecurityMode
public enum class MailSecurityMode
type MailSecurityMode
メンバー
| メンバー名 | 説明 | |
|---|---|---|
.gif ".NET Compact Framework によるサポート") |
None | SOAP メッセージ セキュリティが無効になります。この値は既定値です。 |
|
Message | SOAP メッセージ セキュリティが有効になります。 |
解説
既定では、メール バインディングで SOAP メッセージ セキュリティが MailSecurityMode.None に設定され、SOAP メッセージ セキュリティが無効にされます。
SOAP メッセージ セキュリティを有効にすると、メール バインディングで AsymmetricSecurityBindingElement が使用されます。メール トランスポートの SOAP メッセージ セキュリティは、X.509 証明書に基づきます。AsymmetricSecurityBindingElement プロパティの既定値は、次のとおりです。
MessageSecurityVersion = MessageSecurityVersion.WSSecurity10WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10
SecurityHeaderLayout = SecurityHeaderLayout.Lax
MessageProtectionOrder = MessageProtectionOrder.SignBeforeEncrypt
IncludeTimestamp = true
SecurityBindingElement.LocalServiceSettings.TimestampValidityDuration = 24 時間
SecurityBindingElement.LocalClientSettings.TimestampValidityDuration = 24 時間
デバイス ベースのアプリケーションでは、次の既定の設定も使用されます。
SecurityBindingElement.LocalClientSettings.DetectReplays = false
SecurityBindingElement.LocalServiceSettings.DetectReplays = false
デスクトップ アプリケーションでは、次の既定の設定も使用されます。
SecurityBindingElement.LocalClientSettings.ReplayWindow = 24 時間
SecurityBindingElement.LocalServiceSettings.ReplayWindow = 24 時間
System.ServiceModel.Channels.AsymmetricSecurityBindingElement.InitiatorTokenParameters.RequireDerivedKeys = false
System.ServiceModel.Channels.AsymmetricSecurityBindingElement.RecipientTokenParameters.RequireDerivedKeys = false
既定の SOAP メッセージ セキュリティを変更する必要がある場合、CustomBinding オブジェクトから派生したクラスを使用する代わりに、すべてのバインディング要素をインスタンス化して、それらを MailBindingBase オブジェクトのコンストラクターに渡すことができます。別の方法として、バインディング要素を返す CreateBindingElements メソッドを呼び出し、特定のバインディング要素の値を変更して、そのバインディング要素を CustomBinding オブジェクトに渡すこともできます。
例
メール バインディングのメッセージ セキュリティを有効にする方法の例を次に示します。コード全体については、MailSecurity クラスのトピックを参照してください。
Dim binding As ExchangeWebServiceMailBinding
Dim clientEmailServer AsNew Uri("http://mail.example.com")
Dim clientEmailAddress AsString = "client@example.com"Dim password AsString = "password"
binding = New ExchangeWebServiceMailBinding(clientEmailServer, New NetworkCredential(clientEmailAddress, password))
binding.Security.Mode = MailSecurityMode.Message
ExchangeWebServiceMailBinding binding;
Uri clientEmailServer = new Uri("http://mail.example.com");
string clientEmailAddress = "client@example.com";
string password = "password";
binding = new ExchangeWebServiceMailBinding(clientEmailServer,
new NetworkCredential(clientEmailAddress, password));
binding.Security.Mode = MailSecurityMode.Message;
プラットフォーム
Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。
バージョン情報
.NET Compact Framework
サポート対象 : 3.5