Citrix DaaS™

Conexão ao Amulet Hotkey CoreStation (Pré-visualização)

Criar e gerenciar conexões e recursos descreve os assistentes gerais para criar uma conexão. As informações a seguir cobrem detalhes específicos do Amulet Hotkey CoreStation. Atualmente, você pode criar uma conexão com o Amulet Hotkey CoreStation usando comandos PowerShell.

Nota:

Antes de criar uma conexão com o Amulet Hotkey CoreStation, você precisa primeiro concluir a configuração da sua conta Amulet Hotkey CoreStation. Consulte Ambientes de virtualização Amulet Hotkey CoreStation

  • Criar uma conexão

Você pode criar uma conexão com o Amulet Hotkey CoreStation usando:

Criar uma conexão usando o Studio

  1. Na página “Adicionar Conexão e Recursos”, selecione “Amulet Hotkey CoreStation” como o tipo de conexão.
    1. Insira o endereço de conexão do seu Gerenciador de gabinete Amulet Hotkey CoreStation. Você pode usar um endereço IP, nome de host ou FQDN para o endereço.
    1. Insira suas credenciais administrativas do gabinete e um nome de conexão amigável.

    A configuração da conexão é interrompida quando uma das seguintes situações ocorre:

    • O DaaS recebe um certificado assinado por CA pública com erros: Uma mensagem de erro aparece. Siga as instruções na tela para corrigir o problema. Caso contrário, você não poderá prosseguir com a criação da conexão.
    • O DaaS recebe um certificado assinado por CA privada: Uma página de aviso aparece. Compare o thumbprint recebido com o do servidor para verificar a validade do certificado. Se for válido, selecione “Confiar no certificado” e clique em “OK” para prosseguir com a criação da conexão. O DaaS então confiará no certificado e armazenará o thumbprint para validação futura.

Criar uma conexão usando comandos PowerShell

Ao criar uma conexão usando o comando PowerShell, forneça as seguintes informações:

  • IP: Endereço IP do Amulet Hotkey CoreStation
  • Username: Nome de usuário do Amulet Hotkey CoreStation
  • Password: Senha do Amulet Hotkey CoreStation

Exemplo:


Get-ConfigZone
Get-HypHypervisorPlugin
New-Item `
    -ConnectionType "Custom" `
    -HypervisorAddress $IP `
    -Metadata @{"Citrix_Orchestration_Hypervisor_Secret_Allow_Edit"="false"} `
    -Path @("XDHyp:\Connections\$connectionName") `
    -Persist `
    -PluginId "AmuletHotkeyCoreStationFactory" `
    -Scope @() `
    -SecurePassword $Password `
    -UserName $UserName `
    -ZoneUid $ZoneUid `
    -SslThumbprint $SslThumbprint
New-BrokerHypervisorConnection -HypHypervisorConnectionUid $HypervisorConnectionID

<!--NeedCopy-->

Nota:

O parâmetro -SslThumbprint é necessário apenas para certificados assinados por CA privada.

Validação de certificado e thumbprint

Para criar uma conexão bem-sucedida com o Amulet Hotkey CoreStation, o certificado não deve ter erros e o thumbprint deve ter um valor correto. A seguir estão os casos de uso relacionados à validação de certificado e thumbprint:

Cenário Resultado
Certificado assinado por CA pública apresenta erros. A conexão não é criada com sucesso. Consulte os detalhes do erro e resolva o problema.
Certificado assinado por CA pública sem erros. A conexão é criada com sucesso, e o valor de SslThumbprints é Null.
Certificado assinado por CA privada sem erros e um valor sslthumbprint. A conexão é criada com sucesso com um valor SslThumbprints correto.
Certificado assinado por CA privada com um valor de thumbprint incorreto. A conexão não é criada com sucesso.
Certificado assinado por CA privada sem erros. (nenhum thumbprint fornecido) A conexão é criada com sucesso. O SSlThumbprints é Null ao criar a conexão. O valor de SSlThumbprints é atualizado para um valor pelo serviço do site.

Gerenciar conexões

Corrigir problemas de certificado

O Citrix DaaS bloqueia uma conexão Amulet Hotkey CoreStation quando surgem problemas de certificado, impedindo que você entregue e gerencie cargas de trabalho em nós Amulet Hotkey CoreStation associados. Você verá um ícone de erro ao lado da conexão na lista “Conexões de host”.

Consulte a tabela a seguir para problemas e soluções específicas.

Problema Solução
Ocorre um erro de certificado no certificado assinado por CA pública. Clique na conexão e selecione a guia “Solucionar problemas”. Visualize os detalhes do erro e resolva o problema.
O certificado recebido é assinado por CA privada ou expirou. Edite a conexão do host para atualizar o thumbprint do certificado. Etapas detalhadas:
  • ^^
    1. Selecione a conexão e clique em “Editar Conexão”.
  • ^^
    ^^1. Na página “Propriedades da Conexão”, clique em “Editar configurações”.
  • Insira a senha para conectar-se ao gabinete Amulet Hotkey CoreStation e, em seguida, clique em “Salvar”.
  • ^^ ^^1. Na página “Aviso” que aparece, compare o thumbprint recebido com o do servidor para verificar a validade do certificado.
  • ^^ ^^1. Se forem iguais, selecione “Confiar no certificado” e, em seguida, clique em “OK”.

Atualizar valor do thumbprint

Após criar a conexão, você pode atualizar o valor do thumbprint de uma conexão usando o comando PowerShell Set-Item. Siga as etapas para atualizar o valor do thumbprint.

  1. Obtenha os detalhes de uma conexão. Por exemplo:

    
    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
    
    <!--NeedCopy-->
    
  2. Atualize o valor do thumbprint. Por exemplo:

    
    Set-Item -LiteralPath xdhyp:\connections\AmuletCon-101 -Username Administrator -SslThumbprint xxxxxxxxxxx12AD048480631BB7AB10D69xxxxx
    
    <!--NeedCopy-->
    
  3. Verifique o valor do thumbprint atualizado. Por exemplo:

    
    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
    
    <!--NeedCopy-->
    

Nota:

A atualização falha se você fornecer um valor de thumbprint incorreto no comando Set-Item.

Próximos passos

Mais informações

Conexão ao Amulet Hotkey CoreStation (Pré-visualização)