Win32 API 日本語リファレンス
ホーム › Networking.WindowsWebServices › WS_SECURITY_PROPERTY_ID

WS_SECURITY_PROPERTY_ID

列挙型
📘 Microsoft Learn (日本語) · English
基底型i4

メンバー 12

名前10進16進説明
WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL10x1WS_PROTECTION_LEVEL 値で、その接続に対して署名のみを行うか、 署名に加えて暗号化も行うかを決定します。セキュリティ記述にトランスポートセキュリティバインドが 少なくとも 1 つ含まれる場合、既定値は WS_PROTECTION_LEVEL_SIGN_AND_ENCRYPT です。
WS_SECURITY_PROPERTY_ALGORITHM_SUITE20x2

混在モードセキュリティの場合、このプロパティは使用するアルゴリズムスイートを指定する WS_SECURITY_ALGORITHM_SUITE 構造体です。 このプロパティを WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME と併用することはできません。

このプロパティと WS_SECURITY_ALGORITHM_SUITE_NAME のいずれも指定されない場合、アルゴリズムスイートの既定値は、 WS_KERBEROS_APREQ_MESSAGE_SECURITY_BINDING が使用されるときは WS_SECURITY_ALGORITHM_SUITE_NAME_BASIC128、 それ以外の場合は WS_SECURITY_ALGORITHM_SUITE_NAME_BASIC256 になります。

WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME30x3

混在モードセキュリティの場合、このプロパティは使用するアルゴリズムスイートを指定する WS_SECURITY_ALGORITHM 構造体です。 スイート名は WS-SecurityPolicy 1.1 のセクション 7.1 で定義されている アルゴリズムの集合を指します。 このプロパティを WS_SECURITY_PROPERTY_ALGORITHM_SUITE と併用することはできません。

このプロパティと WS_SECURITY_ALGORITHM_SUITE のいずれも指定されない場合、アルゴリズムスイートの既定値は、 WS_KERBEROS_APREQ_MESSAGE_SECURITY_BINDING が使用されるときは WS_SECURITY_ALGORITHM_SUITE_NAME_BASIC128、 それ以外の場合は WS_SECURITY_ALGORITHM_SUITE_NAME_BASIC256 になります。

WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY40x4混在モードセキュリティの場合、このプロパティは WS_TIMESPAN 構造体で、セキュリティヘッダー内の受信タイムスタンプについて 許容される最大の経過時間を指定します。既定値は 5 分です。
WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION50x5混在モードセキュリティの場合、このプロパティは WS_TIMESPAN 構造体で、送信者が生成したタイムスタンプが セキュリティ適用時点からこの期間だけ有効であり続けることを指定します。この設定は 'time-to-live' または 'TTL' と呼ばれることがあります。既定値は 5 分です。
WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW60x6混在モードセキュリティの場合、このプロパティは WS_TIMESPAN 構造体で、送信者と受信者のクロック間に 許容される最大のずれを指定します。この値は WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY などの設定を適用する際の 許容範囲として機能します。 既定値は 5 分です。
WS_SECURITY_PROPERTY_TIMESTAMP_USAGE70x7混在モードセキュリティの場合、このプロパティは WS_SECURITY_TIMESTAMP_USAGE 値で、セキュリティヘッダーにおいてタイムスタンプを (送信者側で) 生成し、(受信者側で) 要求するかどうかを指定します。 既定値は WS_SECURITY_TIMESTAMP_USAGE_ALWAYS です。
WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT80x8混在モードセキュリティの場合、このプロパティは WS_SECURITY_HEADER_LAYOUT 値で、セキュリティヘッダーのレイアウトを 指定します。既定値は WS_SECURITY_HEADER_LAYOUT_STRICT です。
WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION90x9混在モードセキュリティの場合、このプロパティは WS_SECURITY_HEADER_VERSION 値で、セキュリティヘッダーに使用する WS-Security のバージョンを指定します。既定値は WS_SECURITY_HEADER_VERSION_1_1 です。
WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY100xA

WS_EXTENDED_PROTECTION_POLICY 値で、Extended Protection のデータを検証するかどうかを指定します。拡張保護 (Extended Protection) が使用される場合にのみ利用できます。

拡張保護をサポートする構成では、既定値は WS_EXTENDED_PROTECTION_POLICY_WHEN_SUPPORTED です。

このプロパティはサーバー側でのみ利用でき、WS_HTTP_CHANNEL_BINDING を WS_HTTP_HEADER_AUTH_SECURITY_BINDING または WS_KERBEROS_APREQ_MESSAGE_SECURITY_BINDING と共に使用する場合にのみ指定できます。

Windows 7 以降では既定でサポートされます。それ以前のバージョンの Windows を実行しているシステムでは更新プログラムが必要になる場合があります。オペレーティングシステムが更新されていない場合でも、 このプロパティ自体は利用できますが、効果はありません。

WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO110xB

WS_EXTENDED_PROTECTION_SCENARIO 値で、Extended Protection に関するサーバーの配置シナリオを指定します。拡張保護 (Extended Protection) が使用される場合にのみ利用できます。

このプロパティはサーバー側でのみ利用でき、WS_HTTP_CHANNEL_BINDING を WS_HTTP_HEADER_AUTH_SECURITY_BINDING または WS_KERBEROS_APREQ_MESSAGE_SECURITY_BINDING と共に使用する場合にのみ指定できます。

既定値は WS_EXTENDED_PROTECTION_SCENARIO_BOUND_SERVER です。

Windows 7 以降では既定でサポートされます。それ以前のバージョンの Windows を実行しているシステムでは更新プログラムが必要になる場合があります。オペレーティングシステムが更新されていない場合でも、 このプロパティ自体は利用できますが、効果はありません。

WS_SECURITY_PROPERTY_SERVICE_IDENTITIES120xC

WS_SERVICE_SECURITY_IDENTITIES 構造体で、Extended Protection のデータを検証する際に、サーバーが受け入れるサーバープリンシパル名 (SPN) を設定します。 SPN が検証されるのは、WS_HTTP_HEADER_AUTH_SECURITY_BINDING が WS_SSL_TRANSPORT_SECURITY_BINDING なしで使用される場合、または WS_EXTENDED_PROTECTION_SCENARIO_TERMINATED_SSL が設定されている場合です。

このプロパティはサーバー側でのみ利用でき、WS_HTTP_CHANNEL_BINDING と共に使用する場合にのみ指定できます。

上記の条件がすべて満たされる場合、セキュリティの検証を成功させるにはこのプロパティを設定しなければなりません。それ以外の場合は設定してはなりません。

Windows 7 以降では既定でサポートされます。その他のプラットフォームではオペレーティングシステムの更新が必要です。オペレーティングシステムが更新されていない場合でも、 このプロパティ自体は利用できますが、効果はありません。

公式ドキュメント

チャネル全体のセキュリティ設定を表すプロパティを識別します。この列挙型は WS_SECURITY_PROPERTY 構造体の中で使用され、その構造体はさらに WS_SECURITY_DESCRIPTION 構造体の中で使用されます。

解説(Remarks)

ここに挙げたキーによって定義されるすべてのプロパティには妥当な既定値があるため、 これらを指定するかどうかは任意です。一般的なケースでは、以下のプロパティを 1 つも設定せずに WS_SECURITY_DESCRIPTION を作成できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum WS_SECURITY_PROPERTY_ID : int {
    WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL = 1,
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE = 2,
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME = 3,
    WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY = 4,
    WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION = 5,
    WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW = 6,
    WS_SECURITY_PROPERTY_TIMESTAMP_USAGE = 7,
    WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT = 8,
    WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION = 9,
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY = 10,
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO = 11,
    WS_SECURITY_PROPERTY_SERVICE_IDENTITIES = 12
} WS_SECURITY_PROPERTY_ID;
public enum WS_SECURITY_PROPERTY_ID : int
{
    WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL = 1,
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE = 2,
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME = 3,
    WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY = 4,
    WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION = 5,
    WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW = 6,
    WS_SECURITY_PROPERTY_TIMESTAMP_USAGE = 7,
    WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT = 8,
    WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION = 9,
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY = 10,
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO = 11,
    WS_SECURITY_PROPERTY_SERVICE_IDENTITIES = 12,
}
Public Enum WS_SECURITY_PROPERTY_ID As Integer
    WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL = 1
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE = 2
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME = 3
    WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY = 4
    WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION = 5
    WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW = 6
    WS_SECURITY_PROPERTY_TIMESTAMP_USAGE = 7
    WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT = 8
    WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION = 9
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY = 10
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO = 11
    WS_SECURITY_PROPERTY_SERVICE_IDENTITIES = 12
End Enum
import enum

class WS_SECURITY_PROPERTY_ID(enum.IntEnum):
    WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL = 1
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE = 2
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME = 3
    WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY = 4
    WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION = 5
    WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW = 6
    WS_SECURITY_PROPERTY_TIMESTAMP_USAGE = 7
    WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT = 8
    WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION = 9
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY = 10
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO = 11
    WS_SECURITY_PROPERTY_SERVICE_IDENTITIES = 12
// WS_SECURITY_PROPERTY_ID
pub const WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL: i32 = 1;
pub const WS_SECURITY_PROPERTY_ALGORITHM_SUITE: i32 = 2;
pub const WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME: i32 = 3;
pub const WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY: i32 = 4;
pub const WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION: i32 = 5;
pub const WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW: i32 = 6;
pub const WS_SECURITY_PROPERTY_TIMESTAMP_USAGE: i32 = 7;
pub const WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT: i32 = 8;
pub const WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION: i32 = 9;
pub const WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY: i32 = 10;
pub const WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO: i32 = 11;
pub const WS_SECURITY_PROPERTY_SERVICE_IDENTITIES: i32 = 12;
// WS_SECURITY_PROPERTY_ID
const (
	WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL int32 = 1
	WS_SECURITY_PROPERTY_ALGORITHM_SUITE int32 = 2
	WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME int32 = 3
	WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY int32 = 4
	WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION int32 = 5
	WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW int32 = 6
	WS_SECURITY_PROPERTY_TIMESTAMP_USAGE int32 = 7
	WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT int32 = 8
	WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION int32 = 9
	WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY int32 = 10
	WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO int32 = 11
	WS_SECURITY_PROPERTY_SERVICE_IDENTITIES int32 = 12
)
const
  WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL = 1;
  WS_SECURITY_PROPERTY_ALGORITHM_SUITE = 2;
  WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME = 3;
  WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY = 4;
  WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION = 5;
  WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW = 6;
  WS_SECURITY_PROPERTY_TIMESTAMP_USAGE = 7;
  WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT = 8;
  WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION = 9;
  WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY = 10;
  WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO = 11;
  WS_SECURITY_PROPERTY_SERVICE_IDENTITIES = 12;
// WS_SECURITY_PROPERTY_ID
pub const WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL: i32 = 1;
pub const WS_SECURITY_PROPERTY_ALGORITHM_SUITE: i32 = 2;
pub const WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME: i32 = 3;
pub const WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY: i32 = 4;
pub const WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION: i32 = 5;
pub const WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW: i32 = 6;
pub const WS_SECURITY_PROPERTY_TIMESTAMP_USAGE: i32 = 7;
pub const WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT: i32 = 8;
pub const WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION: i32 = 9;
pub const WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY: i32 = 10;
pub const WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO: i32 = 11;
pub const WS_SECURITY_PROPERTY_SERVICE_IDENTITIES: i32 = 12;
const
  WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL* = 1
  WS_SECURITY_PROPERTY_ALGORITHM_SUITE* = 2
  WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME* = 3
  WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY* = 4
  WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION* = 5
  WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW* = 6
  WS_SECURITY_PROPERTY_TIMESTAMP_USAGE* = 7
  WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT* = 8
  WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION* = 9
  WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY* = 10
  WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO* = 11
  WS_SECURITY_PROPERTY_SERVICE_IDENTITIES* = 12
enum WS_SECURITY_PROPERTY_ID : int {
    WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL = 1,
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE = 2,
    WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME = 3,
    WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY = 4,
    WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION = 5,
    WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW = 6,
    WS_SECURITY_PROPERTY_TIMESTAMP_USAGE = 7,
    WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT = 8,
    WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION = 9,
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY = 10,
    WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO = 11,
    WS_SECURITY_PROPERTY_SERVICE_IDENTITIES = 12,
}
#define global WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL   0x1
#define global WS_SECURITY_PROPERTY_ALGORITHM_SUITE              0x2
#define global WS_SECURITY_PROPERTY_ALGORITHM_SUITE_NAME         0x3
#define global WS_SECURITY_PROPERTY_MAX_ALLOWED_LATENCY          0x4
#define global WS_SECURITY_PROPERTY_TIMESTAMP_VALIDITY_DURATION  0x5
#define global WS_SECURITY_PROPERTY_MAX_ALLOWED_CLOCK_SKEW       0x6
#define global WS_SECURITY_PROPERTY_TIMESTAMP_USAGE              0x7
#define global WS_SECURITY_PROPERTY_SECURITY_HEADER_LAYOUT       0x8
#define global WS_SECURITY_PROPERTY_SECURITY_HEADER_VERSION      0x9
#define global WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_POLICY   0xA
#define global WS_SECURITY_PROPERTY_EXTENDED_PROTECTION_SCENARIO 0xB
#define global WS_SECURITY_PROPERTY_SERVICE_IDENTITIES           0xC