Autenticar em um ServiceNow e armazenar credenciais de usuário para acessar a instância em seu sistema com ServiceNow SDK.

Você pode usar credenciais básicas ou OAuth 2,0 para autenticar em uma instância. Para usar a autenticação OAuth 2,0, sua instância deve ter IDE da ServiceNow(Versão 1,1 ou posterior) instalado ou ter a configuração XML necessária importada. Por padrão, instâncias no Zurich inclusão da versão IDE da ServiceNow Versão 1.1.4 e suporte usando autenticação OAuth 2,0 com o. ServiceNow SDK.

Depois de autenticar em uma instância com ServiceNow SDK Interface de linha de comando (CLI), você pode começar a desenvolver aplicações e instalá-las em sua instância. Uma instância de não produção deve ser usada para desenvolvimento de aplicações.

Autenticar em um ServiceNow instância que usa autenticação básica com ServiceNow SDK

Use autenticação básica para se conectar a um ServiceNow instância com ServiceNow SDK.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Este procedimento usa o. ServiceNow SDK CLI (Command-Line Interface, interface de linha de comando). Em uma ferramenta de linha de comando, insira now-sdk --help para obter informações sobre os comandos disponíveis e as opções globais. Para obter informações adicionais sobre um comando e seus parâmetros, insira o comando e. --help ou -h . Por exemplo, now-sdk auth --help . Para obter mais informações sobre a CLI, consulte ServiceNow SDK CLI.

Procedimento

  1. Crie um diretório local para sua aplicação.
  2. Em Visual Studio Code, abra o diretório.
  3. No diretório da aplicação, abra uma janela do Terminal integrada.
  4. Especifique a instância para autenticar com autenticação comando. 
    npx @servicenow/sdk auth --add <instance>
    Por exemplo:
    npx @servicenow/sdk auth --add https://myinstance.service-now.com
    Nota: Usando o. npx o comando instala o. ServiceNow SDK em seu diretório de aplicações em vez de globalmente.
  5. Responda às seguintes séries de prompts.
    Aviso Resposta
    Tipo de autenticação a ser usada Selecione básico .
    Alias para essas credenciais Insira um alias para suas credenciais e a instância.

    O alias pode ser usado para autenticação com inic , transformação , dependências e instalar comandos.

    O nome de usuário a ser autenticado com a instância Insira seu nome de usuário da instância.

    A função de administrador deve ser atribuída a você.
    A senha para autenticar com a instância Insira sua senha.

Resultado

O alias e as credenciais são armazenados na cadeia de chaves do dispositivo ou no gerenciador de credenciais em seu sistema e são definidos como as credenciais padrão.

O que Fazer Depois

Crie uma aplicação com escopo ou converta uma aplicação existente para uso com ServiceNow SDK. Para obter mais informações, consulte Criar uma aplicação com ServiceNow SDKou Converta uma aplicação com ServiceNow SDK.

Configure um ServiceNow Instância para autenticação OAuth 2,0 com ServiceNow SDK

Importe a configuração para usar a autenticação OAuth 2,0 com ServiceNow SDK para uma instância.

Antes de Iniciar

Importante: Este procedimento é necessário somente para instâncias que não têm IDE da ServiceNow(versão 1,1 ou posterior) instalada. Por padrão, instâncias no Zurich inclusão da versão IDE da ServiceNow Versão 1.1.4 e suporte usando autenticação OAuth 2,0 com o. ServiceNow SDK.

O usuário Administrador do sistema (admin) padrão deve elevar para a função security_admin privilegiada para configurar uma instância para autenticação OAuth 2,0 com o. ServiceNow SDK. Para obter mais informações, consulte Elevação para uma função privilegiada.

Função necessária: security_admin

Procedimento

  1. Navegue até Configuração do SDK da ServiceNow para autenticação OAuth 2,0 (SSO) artigo no Comunidade ServiceNow.
  2. Baixe o arquivo ZIP anexado e descompacte seu conteúdo.
  3. Importe o XML para sua instância.
    1. Em sua instância, navegue até qualquer lista.
      Qualquer lista pode ser usada porque o arquivo XML contém o nome da tabela de destino dos registros.
    2. Selecione e mantenha pressionado (ou clique com o botão direito do mouse) qualquer título de coluna e selecione XML de importação .
    3. No formulário Importar XML, selecione Escolha Arquivo E selecione um dos arquivos XML baixados.
    4. Selecione Carregar.
    5. Repita essas etapas para cada arquivo XML.
    Para obter informações adicionais, confira Importar dados do XML.

Resultado

Os desenvolvedores podem autenticar a instância usando OAuth 2,0 com ServiceNow SDK.

Autenticar em um ServiceNow Instância que usa OAuth 2,0 com ServiceNow SDK

Use a autenticação OAuth 2,0 para se conectar a um ServiceNow instância com ServiceNow SDK.

Antes de Iniciar

Para usar a autenticação OAuth 2,0, sua instância deve ter IDE da ServiceNow(Versão 1,1 ou posterior) instalado ou ter a configuração XML necessária importada. Por padrão, instâncias no Zurich inclusão da versão IDE da ServiceNow Versão 1.1.4 e suporte usando autenticação OAuth 2,0 com o. ServiceNow SDK. Para obter mais informações, consulte Configure um ServiceNow Instância para autenticação OAuth 2,0 com ServiceNow SDK.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Este procedimento usa o. ServiceNow SDK CLI (Command-Line Interface, interface de linha de comando). Em uma ferramenta de linha de comando, insira now-sdk --help para obter informações sobre os comandos disponíveis e as opções globais. Para obter informações adicionais sobre um comando e seus parâmetros, insira o comando e. --help ou -h . Por exemplo, now-sdk auth --help . Para obter mais informações sobre a CLI, consulte ServiceNow SDK CLI.

Procedimento

  1. Crie um diretório local para sua aplicação.
  2. Em Visual Studio Code, abra o diretório.
  3. No diretório da aplicação, abra uma janela do Terminal integrada.
  4. Especifique a instância para autenticar com autenticação comando. 
    npx @servicenow/sdk auth --add <instance>
    Por exemplo:
    npx @servicenow/sdk auth --add https://myinstance.service-now.com
    Nota: Usando o. npx o comando instala o. ServiceNow SDK em seu diretório de aplicações em vez de globalmente.
  5. Responda às seguintes séries de prompts.
    Aviso Resposta
    Tipo de autenticação a ser usada Selecione oauth .
    Alias para essas credenciais Insira um alias para suas credenciais e a instância.

    O alias pode ser usado para autenticação com inic , transformação , dependências e instalar comandos.

    . ServiceNow SDK abre um navegador da web para autenticar com a instância .
  6. Navegue até a página da Web que é aberta e faça login na instância se você não estiver conectado no momento.
  7. Selecione Aceitar para permitir ServiceNow SDK para se conectar à instância.
    A página é atualizada e inclui um código de autenticação.
  8. Selecione Cópia para copiar o código de autenticação fornecido.
  9. Na linha de comando, cole o código de autenticação.

Resultado

O alias e as credenciais são armazenados na cadeia de chaves do dispositivo ou no gerenciador de credenciais em seu sistema e são definidos como as credenciais padrão.

O que Fazer Depois

Crie uma aplicação com escopo ou converta uma aplicação existente para uso com ServiceNow SDK. Para obter mais informações, consulte Criar uma aplicação com ServiceNow SDKou Converta uma aplicação com ServiceNow SDK.