SetGroupPresharedKey

El método SetGroupPresharedKey permite a una aplicación de administración configurar un HBA de iniciador para usar la clave precompartida indicada siempre que se requiere una clave, pero no hay ninguna clave asociada actualmente con el identificador (ID) de una sesión.

Cuando un iniciador usa una clave precompartida en un intercambio de claves, asocia la clave con un identificador para el iniciador y pasa el identificador y su clave asociada al destino en la parte de datos de un paquete de identificación (también conocido como carga de identificación). El iniciador pasa el identificador y su clave asociada durante la fase 1 de un intercambio agresivo o en modo principal de claves de Internet (IKE), tal y como se describe en RFC 2407. La carga de identificación permite al destino identificar al iniciador de una manera segura y elegir una directiva de seguridad adecuada para una conexión con ese iniciador determinado.

El método SetGroupPresharedKey configura un iniciador para usar la clave precompartida predeterminada para los identificadores que aún no están asociados a una clave. Para establecer una asociación explícita entre una clave y un identificador de iniciador determinado, una aplicación de administración debe llamar al método SetPresharedKeyForId . Si existe una asociación explícita entre un identificador y una clave, la clave que la asociación tiene prioridad sobre la clave predeterminada.

Después de que el método SetGroupPresharedKey especifique la clave predeterminada, el iniciador debe almacenar esta clave en un almacenamiento no volátil si el almacenamiento no volátil está disponible. Pero el iniciador también debe mantener la clave en memoria de trabajo, de modo que estará disponible rápidamente durante la negociación de la fase 1 de IKE. Esto mejora la eficacia del intercambio de claves.

SetGroupPresharedKey pertenece a la clase WMI MSiSCSI_SecurityConfigOperations no publicada. Para obtener una descripción de los parámetros del método SetGroupPresharedKey , consulte las descripciones de miembros de las estructuras de SetGroupPresharedKey_IN y SetGroupPresharedKey_OUT .

Los controladores de miniporte que implementan la clase WMI de MSiSCSI_SecurityConfigOperations deben admitir SetGroupPresharedKey.