Configurar autenticação pessoal

Você pode configurar a autenticação OAuth pessoal com a etapa REST no Flow Designer.

Antes de Iniciar

Função necessária: administrador

Certifique-se de instalar o Instalador do IntegrationHub Starter Pack ( com.glide.hub.integrations ) ou uma versão superior.

Por Que e Quando Desempenhar Esta Tarefa

Esta tarefa orienta você na configuração da autenticação OAuth pessoal para as etapas REST em ServiceNow® Flow Designer. Ele permite que as chamadas REST sejam executadas usando as credenciais do usuário da sessão, garantindo acesso seguro e personalizado à API.

Para obter informações sobre como verificar se existe um token OAuth pessoal para um usuário, consulte Obter token OAuth pessoal (usando GlideOAuthClient).

Para obter informações sobre como gerar o token inicial para um usuário, que não tem acesso à página de credenciais, consulte Gerar URL do iniciador de autenticação pessoal.

Procedimento

1. Navegue até Registros de aplicações E criar um registro de aplicação OAuth para se conectar a um endpoint externo.
2. Navegue até Aliases de conexão e credenciais e criam um alias de conexão.
   Este alias é usado nas etapas REST. Para obter mais informações, consulte Crie um alias de Conexão e Credenciais.
3. Navegue até Conexão HTTP(s) e atualize os detalhes do endpoint externo para o registro de conexão criado na etapa anterior.
4. Crie um Credencial do OAuth .
   1. Navegue até Credenciais do OAuth 2,0 .
   2. Crie um novo registro de credencial OAuth e vincule-o ao perfil OAuth criado na etapa 1.
5. Adicione IntegrationType campo para o formulário de credencial.
6. Atualize o. IntegrationType Campo da credencial criada na Etapa 4 para Pessoal .
7. Gere um token de acesso pessoal.
   1. Como um usuário conectado, abra o registro de credencial.
   2. Selecione Obter token OAuth para criar um token pessoal.
   3. Selecione Gerenciar tokens para exibir e gerenciar os tokens.
   Nota:

   Adicione uma ação de IU à sua aplicação para que os usuários finais possam gerar tokens. Somente administradores podem abrir o formulário de credencial diretamente.
8. Navegue até Ação para criar uma ação para seu caso de uso.
9. Adicione uma etapa REST à ação.
   Selecione o alias de conexão criado na Etapa 2.

   Nota:

   Teste a ação com a chamada de saída REST. A credencial está marcada para ser usada para integração pessoal. A etapa REST pode exibir um erro, já que a ação é executada com a função de Integração do sistema.
10. Crie um novo subfluxo e adicione a ação criada na Etapa 8.
    1. Em Propriedades do subfluxo , selecione Usuário que inicia a sessão em Executar como campo de texto.
       Não selecione Usuário do sistema em vez de Executar como campo de texto.
11. Teste o subfluxo.
    A etapa REST usa o token criado para o usuário da sessão. O subfluxo também pode ser invocado usando FlowAPIs.

    Script de amostra para invocar um subfluxo:

    try {
        // Execute synchronously in the foreground. Allows access to subflow outputs.
        var result = sn_fd.FlowAPI.getRunner()
            .subflow('global.getpersonalincidentssubflow')
            .inForeground()
            .run();
    
        var outputs = result.getOutputs();
    } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
    }

12. Gerencie tokens ausentes ou expirados.

    Se o usuário da sessão não tiver token de acesso, a solicitação REST retornará um Código de status não autorizado HTTP 401 resposta. Certifique-se de que o token seja criado antes de iniciar o fluxo.

    Se o token de acesso expirar, mas houver um token de atualização válido, o sistema renovará automaticamente o token de acesso.