Configurar um navegador de autenticação externa para ServiceNow aplicativos para celular

Os administradores podem configurar um navegador externo para aplicativos para celular. Este navegador externo é usado durante a autenticação para que os URLs externos que são abertos pelo mesmo navegador possam manter sessões e cookies.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Os cookies não são compartilhados entre os navegadores do app ServiceNow® Mobile e navegadores externos que carregam sites externos. Os aplicativos ServiceNow Mobile permitem que os usuários finais façam login com um serviço de SSO (single sign-on), como Okta ou Microsoft Entra ID. Esses serviços de SSO fornecem uma experiência de autenticação contínua e segura para os usuários finais. No entanto, às vezes os usuários finais podem querer abrir links de terceiros autenticados que usam o mesmo serviço SSO no aplicativo, mas não precisam fazer login novamente. Por exemplo, um usuário final pode abrir um link para um relatório que está hospedado em uma plataforma diferente que usa o mesmo serviço SSO que o aplicativo ServiceNow Mobile.

Para permitir que os usuários finais acessem links em diferentes plataformas que usam o mesmo serviço SSO que o app ServiceNow Mobile, os administradores podem configurar um navegador externo para fazer login no app ServiceNow Mobile, para que os cookies sejam compartilhados entre o login e o site externo. Isso significa que a sessão do SSO persiste depois que o usuário final faz login e, em seguida, faz login automaticamente do usuário final em sites externos se esses sites usarem o mesmo provedor de SSO que o app ServiceNow Mobile.

Propriedades do navegador da Web

Use as propriedades a seguir para especificar o navegador externo e o navegador de autenticação na inclusão de script CustomPreAuthProperties.

Tabela 1. Propriedades do navegador da Web

Sistema operacional do aplicativo para celular	Propriedade	Descrição
iOS	SNExternalBrowseriOS	Configura o tipo de navegador a ser usado para abrir links externos em iOS apps.
iOS	SNAuthenticationBrowseriOS	Configura o tipo de navegador a ser usado para autenticar usuários em iOS apps.
Android	SNExternalBrowserAndroid	Configura o tipo de navegador a ser usado para abrir links externos em Android apps.
Android	SNAuthenticationBrowserAndroid	Configura o tipo de navegador a ser usado para autenticar usuários em Android apps.

Valores da propriedade

Os seguintes tipos de navegador podem ser especificados para as propriedades do navegador da web.

Tabela 2. Tipos de navegadores

Valor da propriedade	Descrição
safari	Apple Safari
chrome	Google Chrome
firefox	Mozilla Firefox
edge	Microsoft Edge
workspaceone	Espaço do AirWatch VMware ONE
webatwork	MobileIron Web@Work
blackberryaccess	Acesso de BlackBerry
maas360	IBM MaaS360
citrix	Citrix Seguro

Exemplo

{"SNExternalBrowseriOS": "safari", "SNAuthenticationBrowseriOS": "safari"}

Importante:

Os valores de ambas as propriedades devem corresponder para que as sessões do SSO persistam entre o login e outras navegações.

Procedimento

1. Navegar até Tudo > sys_extension_point.list.
   A tabela Pontos de extensão é exibida.
2. Na coluna Nome da API, localize a entrada global.CustomPreAuthProperties e selecione-a.
3. No registro Ponto de extensão CustomPreAuthProperties, em Links relacionados, selecione Criar implementação.
4. No registro de Inclusão de script CustomPreAuthProperties, adicione o navegador externo e as propriedades do navegador de autenticação ao Script.

   Por exemplo, esta é uma configuração que especifica o navegador Apple Safari para os navegadores externos e de autenticação:

   var CustomPreAuthProperties = Class.create();
   CustomPreAuthProperties.prototype = {
        initialize: function() {
        },
   
        /**
         * Returns a JSON object keyed by the custom property names.
         */
        getProperties: function(input) {
             return {"SNExternalBrowseriOS": "safari", "SNAuthenticationBrowseriOS": "safari"};
        },
   
        type: 'CustomPreAuthProperties'
   };

5. Selecione Ativo para ativar a inclusão de script.
6. Selecione Atualizar para salvar suas mudanças.