Compartilhar via


SetGroupPresharedKey

O método SetGroupPresharedKey permite que um aplicativo de gerenciamento configure um HBA iniciador para usar a chave pré-compartilhada indicada sempre que uma chave for necessária, mas nenhuma chave está associada ao identificador (ID) de uma sessão

Quando um iniciador usa uma chave pré-compartilhada em uma troca de chaves, ele associa a chave a um identificador para o iniciador e passa o identificador e sua chave associada para o destino na parte de dados de um pacote de identificação (também conhecido como carga de identificação). O iniciador passa o identificador e sua chave associada durante a fase 1 de uma IKE (troca de chaves de Internet) agressiva ou no modo main, conforme descrito no RFC 2407. A carga de identificação permite que o destino identifique o iniciador de uma maneira segura e escolha uma política de segurança apropriada para uma conexão com esse iniciador específico.

O método SetGroupPresharedKey configura um iniciador para usar a chave pré-compartilhada padrão para identificadores que ainda não estão associados a uma chave. Para estabelecer uma associação explícita entre uma chave e um identificador de iniciador específico, um aplicativo de gerenciamento deve chamar o método SetPresharedKeyForId . Se existir uma associação explícita entre um identificador e uma chave, a chave que a associação terá precedência sobre a chave padrão.

Depois que o método SetGroupPresharedKey especificar a chave padrão, o iniciador deverá armazenar essa chave no armazenamento nãovolatile se o armazenamento nãovolatile estiver disponível. Mas o iniciador também deve manter a chave na memória de trabalho, para que ela fique disponível rapidamente durante a negociação da fase 1 do IKE. Isso melhora a eficiência da troca de chaves.

SetGroupPresharedKey pertence à classe WMI MSiSCSI_SecurityConfigOperations não publicada. Para obter uma descrição dos parâmetros do método SetGroupPresharedKey , consulte as descrições de membro para as estruturas SetGroupPresharedKey_IN e SetGroupPresharedKey_OUT .

Os drivers de miniport que implementam a classe WMI MSiSCSI_SecurityConfigOperations devem dar suporte a SetGroupPresharedKey.