Conectando-se a ServiceNow

Editar online

ServiceNow é uma plataforma baseada na nuvem que oferece suporte à gestão de serviços em toda a empresa, abrangendo departamentos como TI, RH, instalações, atendimento ao cliente e outros. A integração do ServiceNow com o watsonx Orchestrate permite a automação contínua dos fluxos de trabalho de serviços, o acompanhamento de incidentes e a sincronização de dados entre os sistemas.

Para habilitar essa integração, estabeleça uma conexão segura entre as duas plataformas. Consulte “Gerenciamento de conexões” para obter mais detalhes.

Tipos de autenticação suportados

ServiceNow suporta os seguintes tipos de autenticação:

OAuth2 Código de autorização (padrão)
OAuth2 Senha
Token de Acesso
OAuth2 Troca de tokens (requer SSO)
OAuth Em nome de (OBO) (requer SSO)

Selecione o tipo de autenticação que corresponda à configuração do ServiceNow e aos requisitos da sua organização.

Importante:

Por padrão, o Single Sign-On (SSO) está desativado. Para utilizar os tipos de autenticação “ OAuth2 ” (Troca de tokens) ou “ OAuth ” (Em nome de), habilite o SSO. Consulte a seção “Configuração do logon único para aplicativos ”.

Conexão com ServiceNow

Para conectar watsonx Orchestrate a ServiceNow :

No menu principal, vá para Gerenciar > Conexões.
Pesquise por ServiceNow ou o ID da conexão: servicenow_ibm_184bdbd3
Clique no ícone de edição para configurar a conexão.
Selecione o ambiente em que você deseja criar a conexão:
- Rascunho : para testes e desenvolvimento
- Ao vivo : para uso em produção
No menu suspenso “Tipo de autenticação ”, selecione o tipo de autenticação que corresponde à configuração do seu ServiceNow :
- OAuth2 Código de autorização (padrão)
- OAuth2 Senha
- Token de Acesso
- OAuth2 Troca de token (aparece apenas quando o SSO está ativado)
- OAuth Em nome de (OBO) (aparece apenas quando o SSO está ativado)
Forneça os valores necessários com base no tipo de autenticação selecionado. Consulte a seção Campos de configuração do tipo de autenticação para obter detalhes.
Escolha o tipo de credencial apropriado:
- Credenciais dos membros : cada usuário acessa o aplicativo com suas credenciais pessoais
- Credenciais da equipe : Todos os usuários podem acessar o aplicativo com suas credenciais da equipe
Salve a conexão e teste-a para confirmar se o ServiceNow está conectado corretamente.

Nota: O ícone de verificação ícone indica que a conexão foi estabelecida com sucesso.

Campos de configuração do tipo de autenticação

As tabelas a seguir descrevem os campos de configuração para cada tipo de autenticação.

OAuth2 Código de autorização

OAuth2 O código de autorização é o tipo de autenticação padrão para conexões ServiceNow. Consulte a visão geral dos tipos de autenticação.


Campo	Obrigatório	Descrição
`server_url`	True	A base URL de sua instância ServiceNow
`authorization_url`	True	O site URL para onde os usuários são redirecionados para fazer login e autorizar o acesso
`token_url`	True	O ponto de extremidade usado para trocar o código de autorização por um token de acesso
`client_id`	True	O ID do cliente de seu aplicativo ServiceNow
`client_secret`	True	O segredo do cliente associado ao seu aplicativo em ServiceNow

OAuth2 Senha

OAuth2 A autenticação por senha é adequada para aplicativos confiáveis que lidam diretamente com as credenciais do usuário.


Campo	Obrigatório	Descrição
`server_url`	True	A base URL de sua instância ServiceNow
`token_url`	True	O endpoint usado para trocar credenciais por um token de acesso
`client_id`	True	O ID do cliente de seu aplicativo ServiceNow
`client_secret`	True	O segredo do cliente associado ao seu aplicativo em ServiceNow
`username`	True	Seu nome de usuário ServiceNow
`password`	True	Sua senha ServiceNow
`scope`	True	As permissões ou recursos aos quais o acesso é permitido

Token de Acesso

A autenticação por token de portador utiliza um token para autenticação.


Campo	Obrigatório	Descrição
`server_url`	True	A base URL de sua instância ServiceNow
`bearer_token`	True	Seu token portador ServiceNow

OAuth2 Troca de tokens

OAuth2 A troca de tokens permite a delegação segura de tokens entre serviços. Este tipo de autenticação requer que o SSO esteja habilitado. Para obter mais informações, consulte OAuth2 Troca de tokens.

Pré-requisitos:

O SSO deve estar habilitado para o seu aplicativo


Campo	Obrigatório	Descrição
`token_url`	True	O ponto final usado para trocar tokens
`client_id`	True	O ID do cliente de seu aplicativo ServiceNow
`grant_type`	True	Valor pré-preenchido: `urn:ietf:params:oauth:grant-type:saml2-bearer`. Indica ao servidor de autorização que o cliente está solicitando uma troca de token.
`server_url`	Não	A base URL de sua instância ServiceNow
Campo de solicitação de token	Não	Clique em Adicionar campo para incluir parâmetros adicionais exigidos pelo seu servidor de autorização

OAuth Em nome de (OBO)

OAuth Em nome de (OBO) permite que um aplicativo atue em nome de um usuário ao chamar outro serviço. Este tipo de autenticação requer que o SSO esteja habilitado. Para mais informações, consulte OAuth2 Em nome da Flow.

Pré-requisitos:

O SSO deve estar habilitado para o seu aplicativo

Configuração de Aplicativo


Campo	Obrigatório	Descrição
`token_url`	True	O ponto final usado para trocar tokens
`application_client_id`	True	A identificação do cliente do seu aplicativo ServiceNow
`grant_type`	True	Valor pré-preenchido: `urn:ietf:params:oauth:grant-type:saml2-bearer`. Indica ao servidor de autorização que o cliente está usando o fluxo On-Behalf-Of.
`server_url`	Não	A base URL de sua instância ServiceNow
Campo de solicitação de token	Não	Clique em Adicionar campo para incluir mais parâmetros exigidos pelo seu servidor de autorização

Detalhes adicionais sobre a configuração do SSO


Campo	Obrigatório	Descrição
`idp_url`	True	O provedor de identidade URL para autenticação SSO
`idp_grant_type`	True	Valor pré-preenchido: `urn:ietf:params:oauth:grant-type:jwt-bearer`. Indica o tipo de concessão para o provedor de identidade.
`client_id`	True	A identificação do cliente para o provedor de identidade
`client_secret`	True	O segredo do cliente para o provedor de identidade
`scope`	Não	As permissões ou recursos aos quais o acesso é permitido
`request_token_use`	Não	Valor pré-preenchido: `on_behalf_of`. Especifica que o token é usado para delegação em nome de terceiros.
`request_token_type`	Não	Valor pré-preenchido: `urn:ietf:params:oauth:token-type:saml2`. Especifica o tipo de token que está sendo solicitado.
Campo de solicitação de token	Não	Clique em Adicionar campo para incluir parâmetros adicionais exigidos pelo seu servidor de autorização

Obtenção dos valores de configuração

Para obter os valores de configuração da sua conexão com o ServiceNow, consulte a documentação da API do ServiceNow.