Partager via


SetGroupPresharedKey

La méthode SetGroupPresharedKey permet à une application de gestion de configurer un adaptateur HBA initiateur pour utiliser la clé prépartagée indiquée chaque fois qu’une clé est requise, mais qu’aucune clé n’est actuellement associée à l’identificateur (ID) d’une session

Lorsqu’un initiateur utilise une clé prépartagée dans un échange de clés, il associe la clé à un identificateur de l’initiateur et transmet l’identificateur et sa clé associée à la cible dans la partie de données d’un paquet d’identification (également appelée charge utile d’identification). L’initiateur transmet l’identificateur et la clé associée pendant la phase 1 d’un échange de clés Internet (IKE) agressif ou en mode main, comme décrit dans RFC 2407. La charge utile d’identification permet à la cible d’identifier l’initiateur de manière sécurisée et de choisir une stratégie de sécurité appropriée pour une connexion avec cet initiateur particulier.

La méthode SetGroupPresharedKey configure un initiateur pour qu’il utilise la clé prépartagée par défaut pour les identificateurs qui ne sont pas déjà associés à une clé. Pour établir une association explicite entre une clé et un identificateur d’initiateur particulier, une application de gestion doit appeler la méthode SetPresharedKeyForId . S’il existe une association explicite entre un identificateur et une clé, la clé que l’association est prioritaire sur la clé par défaut.

Une fois que la méthode SetGroupPresharedKey a spécifié la clé par défaut, l’initiateur doit stocker cette clé dans un stockage non volatile si le stockage non volatile est disponible. Mais l’initiateur doit également conserver la clé dans la mémoire de travail, afin qu’elle soit rapidement disponible pendant la négociation de la phase 1 d’IKE. Cela améliore l’efficacité de l’échange de clés.

SetGroupPresharedKey appartient à la classe WMI non publiée MSiSCSI_SecurityConfigOperations. Pour obtenir une description des paramètres de la méthode SetGroupPresharedKey , consultez les descriptions des membres pour les structures SetGroupPresharedKey_IN et SetGroupPresharedKey_OUT .

Les pilotes miniport qui implémentent la classe WMI MSiSCSI_SecurityConfigOperations doivent prendre en charge SetGroupPresharedKey.