Поделиться через


SetPresharedKeyForId

The SetPresharedKeyForId method allows a management application to associate a particular preshared key with the identifier (ID) that an initiator uses to identify itself during phase 1 of an aggressive or main-mode Internet key exchange (IKE).

When an initiator uses a preshared key in a key exchange, it associates the key with an identifier for the initiator (and with an IP address) and passes the identifier and its associated key to the target in the data portion of an identification packet (also known as the identification payload). The initiator passes the identifier and its associated key during phase 1 of an aggressive or main-mode IKE, as described in RFC 2407. Полезные данные идентификации позволяют целевому объекту идентифицировать инициатора таким образом, чтобы обеспечить безопасность и выбрать политику безопасности, подходящую для подключения к конкретному инициатору.

After the SetPresharedKeyForId method specifies the preshared key, the initiator should store it in nonvolatile storage if nonvolatile storage is available. Но инициатор должен также сохранить предварительно общий ключ в рабочей памяти, чтобы он был быстро доступен во время переговоров на этапе IKE 1. Это повышает эффективность обмена ключами. Если недоступная память недоступна инициатору, служба инициатора будет хранить ключ от имени инициатора.

A management application can use the SetPresharedKeyForId method to associate a preshared key with a particular initiator identifier. To associate a default key with all of an initiator's identifiers, the application can call the SetGroupPresharedKey method. Если явная связь существует между идентификатором и ключом, ключ, заданный явной ассоциацией, имеет приоритет над ключом по умолчанию.

SetPresharedKeyForId belongs to the unpublished MSiSCSI_SecurityConfigOperations WMI class. For a description of the parameters of the SetPresharedKeyForId method, see the member descriptions for the SetPresharedKeyForId_IN and SetPresharedKeyForId_OUT structures.

Miniport drivers that implement the MSiSCSI_SecurityConfigOperations WMI class must support SetPresharedKeyForId.