Skip to content

Latest commit

 

History

History
141 lines (106 loc) · 5.25 KB

ns-webservices-ws_security_algorithm_suite.md

File metadata and controls

141 lines (106 loc) · 5.25 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:webservices._WS_SECURITY_ALGORITHM_SUITE
WS_SECURITY_ALGORITHM_SUITE (webservices.h)
Defines the security algorithms and key lengths to be used with WS-Security. This setting is relevant to message security bindings and mixed-mode security bindings.
WS_SECURITY_ALGORITHM_SUITE
WS_SECURITY_ALGORITHM_SUITE structure [Web Services for Windows]
webservices/WS_SECURITY_ALGORITHM_SUITE
wsw.ws_security_algorithm_suite
wsw\ws_security_algorithm_suite.htm
wsw
aa2bb951-47ba-4241-b29a-2f54b92da4cb
12/05/2018
WS_SECURITY_ALGORITHM_SUITE, WS_SECURITY_ALGORITHM_SUITE structure [Web Services for Windows], webservices/WS_SECURITY_ALGORITHM_SUITE, wsw.ws_security_algorithm_suite
webservices.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Windows
WS_SECURITY_ALGORITHM_SUITE
19H1
_WS_SECURITY_ALGORITHM_SUITE
webservices/_WS_SECURITY_ALGORITHM_SUITE
WS_SECURITY_ALGORITHM_SUITE
webservices/WS_SECURITY_ALGORITHM_SUITE
c++
APIRef
kbSyntax
HeaderDef
WebServices.h
WS_SECURITY_ALGORITHM_SUITE

WS_SECURITY_ALGORITHM_SUITE structure

-description

Defines the security algorithms and key lengths to be used with WS-Security. This setting is relevant to message security bindings and mixed-mode security bindings.

-struct-fields

-field canonicalizationAlgorithm

Algorithm to use for XML canonicalization, such as the exclusive XML canonicalization algorithm. Setting this value to WS_SECURITY_ALGORITHM_DEFAULT will default to WS_SECURITY_ALGORITHM_CANONICALIZATION_EXCLUSIVE.

-field digestAlgorithm

Algorithm to use for message part digests, such as SHA-1, SHA-256, SHA-384, or SHA-512. Setting this value to WS_SECURITY_ALGORITHM_DEFAULT will default to WS_SECURITY_ALGORITHM_DIGEST_SHA1.

-field symmetricSignatureAlgorithm

Algorithm to use for message authentication codes (also known as MACs or symmetric signatures) such as HMAC-SHA1, HMAC-SHA256, HMAC-SHA384, or HMAC-SHA512. Setting this value to WS_SECURITY_ALGORITHM_DEFAULT will default to WS_SECURITY_ALGORITHM_SYMMETRIC_SIGNATURE_HMAC_SHA1.

-field asymmetricSignatureAlgorithm

Algorithm to use for asymmetric signatures. Setting this value to WS_SECURITY_ALGORITHM_DEFAULT will default to WS_SECURITY_ALGORITHM_ASYMMETRIC_SIGNATURE_RSA_SHA1.

-field encryptionAlgorithm

Algorithm to use for message part encryption. Reserved for future use. Should be set to WS_SECURITY_ALGORITHM_DEFAULT.

-field keyDerivationAlgorithm

Algorithm to use for deriving keys from other symmetric keys. Setting this value to WS_SECURITY_ALGORITHM_DEFAULT will default to WS_SECURITY_ALGORITHM_KEY_DERIVATION_P_SHA1.

-field symmetricKeyWrapAlgorithm

Algorithm to use for encrypting symmetric keys with other symmetric keys. Reserved for future use. Should be set to WS_SECURITY_ALGORITHM_DEFAULT.

-field asymmetricKeyWrapAlgorithm

Algorithm to use for encrypting symmetric keys with asymmetric keys. Setting this value to WS_SECURITY_ALGORITHM_DEFAULT will default to WS_SECURITY_ALGORITHM_ASYMMETRIC_KEYWRAP_RSA_OAEP.

-field minSymmetricKeyLength

The minimum key length (in bits) of symmetric key security tokens. Setting this value to 0 will default to 128 bits.

-field maxSymmetricKeyLength

The maximum key length (in bits) of symmetric key security tokens. Setting this value to 0 will default to 512 bits.

-field minAsymmetricKeyLength

The minimum key length (in bits) of asymmetric key security tokens. Setting this value to 0 will default to 1024 bits.

-field maxAsymmetricKeyLength

The maximum key length (in bits) of asymmetric key security tokens. Setting this value to 0 will default to 16384 bits.

-field properties

Algorithm properties. Reserved for future use. Should be set to NULL.

-field propertyCount

Number of entries in properties array. Reserved for future use. Should be set to 0.

-remarks

When key derivation is used, the key length restrictions apply to the source security token from which the signing or encryption derived token are derived.