Configurar o app para dispositivos móveis

Nesta página, explicamos como configurar o app Gemini Enterprise para dispositivos móveis nos dispositivos dos usuários. O administrador do app Gemini Enterprise pode configurar o acesso para os usuários usando um dos três métodos disponíveis.

Visão geral

Como administrador do Gemini Enterprise, você pode configurar o app para dispositivos móveis para os usuários com um dos três métodos:

• Você pode usar uma solução de gerenciamento de dispositivos móveis (MDM, na sigla em inglês) para instalar e configurar o app remotamente nos dispositivos dos usuários. As soluções de MDM permitem que os administradores concluam as etapas de configuração antes de entregar os apps aos usuários.

• Você pode ativar um QR code no web app do Gemini Enterprise. Os usuários podem configurar o app para dispositivos móveis lendo esse QR code. Os QR codes podem simplificar a distribuição de acesso aos usuários e podem ser usados além das soluções de MDM.

• Gere um link de acesso e distribua-o aos usuários, permitindo que eles configurem o app abrindo o link nos dispositivos móveis.

Observação:a configuração de MDM substitui todos os outros métodos de configuração. Se você configurou uma solução de MDM em um dispositivo, ela tem prioridade e substitui qualquer tentativa de um usuário de configurar o app usando um QR code ou um link de acesso. Nesse caso, o app mostra uma mensagem indicando que a configuração é gerenciada.

As seções a seguir descrevem as etapas necessárias para cada método.

Antes de começar

Antes de configurar o app para os usuários, configure um provedor de identidade para sua organização do Gemini Enterprise. O app Gemini Enterprise para dispositivos móveis é compatível com o uso do Google Identity e de provedores de identidade de terceiros. Para mais informações, consulte Configurar o provedor de identidade.

Observação: fazer login com vários provedores de identidade em um único dispositivo pode causar conflitos de autenticação, resultando em um erro de "Detalhes de login incompletos". Se um usuário encontrar essa mensagem, ele poderá resolver o problema fazendo logout e login novamente.

Usar uma solução de gerenciamento de dispositivos móveis (MDM)

O painel de administrador do Gemini Enterprise fornece um URL do aplicativo que contém os parâmetros necessários para configurar o app para dispositivos móveis na sua solução de MDM. Esses parâmetros são mapeados diretamente para os parâmetros AppConfig no padrão AppConfig e podem ser usados para configurar o app e aplicar políticas de segurança.

As etapas a seguir usam o gerenciamento de endpoints do Google (GEM, na sigla em inglês) como um exemplo de configuração de um MDM, mas os parâmetros AppConfig devem ser aplicáveis a outras soluções de MDM. Essas etapas exigem acesso ao console de administrador do MDM. Se você não tiver acesso, entre em contato com o administrador da organização para saber as próximas etapas.

Para configurar o app para usuários na solução de gerenciamento de MDM do GEM:

1. No Google Cloud console, acesse a página Gemini Enterprise.

   Gemini Enterprise

2. Clique no app. A página Visão geral será exibida.

3. Clique em Copiar URL para copiar o link móvel. O formato do link móvel varia de acordo com o provedor de identidade.

   Google Identity

   Se o app Gemini Enterprise usar o Google como provedor de identidade, o URL do aplicativo para dispositivos móveis será assim:

   https://vertexaisearch.cloud.google.com/mobile?cid=123&cid_location=global
   

   Provedor de identidade terceirizado

   Se o app Gemini Enterprise usar um provedor de identidade de terceiros, o URL do aplicativo para dispositivos móveis será assim:

   https://vertexaisearch.cloud.google.com/mobile?cid=123&cid_location=global&idp=locations/global/workforcePools/my-pool/providers/my-provider
   

4. Extraia os parâmetros do URL do aplicativo e use-os para preencher a configuração do aplicativo no console de administrador do MDM:

   Google Identity

   Parâmetro de link direto	Chave de configuração do MDM	Nome da configuração do MDM	Valor de exemplo
   cid	config_id	ID de configuração	123
   cid_location	location	Local	global

   Deixe todos os outros campos vazios.

   Observação: ao configurar o app Android no gerenciamento de endpoints do Google (GEM), use o nome da configuração do MDM no formulário de configuração gerenciada. No entanto, para iOS, insira manualmente a chave de configuração do MDM com o valor correspondente.

   Por exemplo, a configuração XML a seguir configura um aplicativo iOS no GEM:

   <dict>
      <key>config_id</key>
      <string>123</string>
      <key>location</key>
      <string>global</string>
   </dict>
   

   Provedor de identidade terceirizado

   Parâmetro de link direto	Chave de configuração do MDM	Nome da configuração do MDM	Valor de exemplo
   cid	config_id	ID de configuração	123
   cid_location	location	Local	global
   idp	identity_provider	Provedor de identidade	locations/global/workforcePools/my-pool/providers/my-provider
   tenant_id	tenant_id	ID do locatário (descontinuado, deixe em branco)
   client_id	client_id	ID do cliente (descontinuado, deixe em branco)
   project_id	project_id	ID do projeto (descontinuado, deixe em branco)

Configurar as preferências do navegador de citações

Os administradores do Gemini Enterprise podem usar chaves de configuração de MDM para especificar como as citações e as páginas da Web são abertas nas sessões do Gemini Enterprise para dispositivos móveis.

• Abrir citações no navegador padrão

  Para abrir citações no navegador padrão do sistema usando o MDM, defina a seguinte chave de configuração do MDM:

  url_launch_mode = external_browser
  

• Abrir citações em um navegador específico

  Para forçar a abertura de citações em um navegador específico usando o MDM, defina uma chave de configuração de MDM adicional:

  url_launch_mode = external_browser, preferred_browser = chrome (or edge, or firefox)
  

Observação:se o navegador especificado não estiver instalado no dispositivo do usuário, a citação será aberta automaticamente no navegador padrão do sistema.

Ativar um QR code na página inicial do app da Web

Como administrador do Gemini Enterprise, você pode mostrar um QR code na página inicial do app da Web, permitindo que os usuários configurem o app para dispositivos móveis nos dispositivos deles lendo o QR code usando a câmera do dispositivo. Essa é uma maneira mais simples de distribuir o link de acesso aos usuários.

Para gerenciar a visibilidade do QR code de configuração:

1. No Google Cloud console, acesse a página Gemini Enterprise.

   Gemini Enterprise

2. Clique no nome do app que você quer configurar.

3. Clique em Configurações e, em seguida, na guia Gerenciamento de recursos.

4. Ative ou desative a opção Ativar acesso ao app para dispositivos móveis para mostrar ou ocultar o QR code na página inicial do usuário do app da Web.

Depois que o QR code for ativado, os usuários poderão ler o QR code mostrado no app da Web do Gemini Enterprise usando o dispositivo móvel para configurar e conectar o app para dispositivos móveis.

Observação: se o MDM estiver configurado no dispositivo do usuário, a configuração do MDM vai substituir a configuração do QR code e mostrar uma mensagem indicando que a configuração é gerenciada.

Para ver o QR code no app da Web e configurar o app para dispositivos móveis:

1. Abra o app da Web do Gemini Enterprise.
2. Clique em Configurações e ajuda.
3. Clique em Login para dispositivos móveis.
4. Leia o QR code com seu dispositivo móvel para fazer login no app Gemini Enterprise para dispositivos móveis.

Gerar um link de acesso

Para gerar o link de acesso para distribuição aos usuários do app Gemini Enterprise para dispositivos móveis, faça o seguinte:

1. No Google Cloud console, acesse a página Gemini Enterprise.

   Gemini Enterprise

2. Clique no app. A página Visão geral será exibida.

3. Clique em Copiar URL para copiar o link móvel. Em seguida, você pode distribuir o link aos usuários. O formato do link móvel varia de acordo com o provedor de identidade.

   Google Identity

   Se o Gemini Enterprise usar o Google como provedor de identidade, o URL do aplicativo para dispositivos móveis será assim:

   https://vertexaisearch.cloud.google.com/mobile?cid=123&cid_location=global
   

   Provedor de identidade terceirizado

   Se o Gemini Enterprise usar um provedor de identidade de terceiros, o URL do aplicativo para dispositivos móveis será assim:

   https://vertexaisearch.cloud.google.com/mobile?cid=123&cid_location=global&idp=locations/global/workforcePools/my-pool/providers/my-provider
   

Observação: se o MDM estiver configurado no dispositivo do usuário, a configuração do MDM vai substituir a configuração do link de acesso e mostrar uma mensagem indicando que a configuração é gerenciada.

Configurar as preferências do navegador de citações

Os administradores do Gemini Enterprise podem usar parâmetros de link de acesso para especificar como as citações e as páginas da Web são abertas nas sessões do Gemini Enterprise para dispositivos móveis.

• Abrir citações no navegador padrão

  Para abrir citações no navegador padrão do sistema com um link de acesso, transmita o seguinte parâmetro no URL:

  url_launch_mode=external_browser
  

• Abrir citações em um navegador específico

  Para forçar a abertura de citações em um navegador específico com um link de acesso, defina um parâmetro adicional no URL:

  url_launch_mode=external_browser, preferred_browser=chrome (or edge, or firefox)
  

  Exemplo:

  https://vertexaisearch.cloud.google.com/mobile?cid=123&cid_location=global&url_launch_mode=external_browser&preferred_browser=chrome
  

Observação:se o navegador especificado não estiver instalado no dispositivo do usuário, a citação será aberta automaticamente no navegador padrão do sistema.