SetGroupPresharedKey

The SetGroupPresharedKey method allows a management application to configure an initiator HBA to use the indicated preshared key whenever a key is required but no key is currently associated with the identifier (ID) for a session

When an initiator uses a preshared key in a key exchange, it associates the key with an identifier for the initiator 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 Internet key exchange (IKE), as described in RFC 2407. Полезные данные идентификации позволяют целевому объекту идентифицировать инициатора таким образом, чтобы обеспечить безопасность и выбрать политику безопасности, подходящую для подключения к конкретному инициатору.

The SetGroupPresharedKey method configures an initiator to use the default preshared key for identifiers that are not already associated with a key. To establish an explicit association between a key and a particular initiator identifier, a management application must call the SetPresharedKeyForId method. Если явная связь существует между идентификатором и ключом, ключ, который ассоциация имеет приоритет над ключом по умолчанию.

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

SetGroupPresharedKey belongs to the unpublished MSiSCSI_SecurityConfigOperations WMI class. For a description of the parameters of the SetGroupPresharedKey method, see the member descriptions for the SetGroupPresharedKey_IN and SetGroupPresharedKey_OUT structures.

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