Configurar spoke da Ethoca

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Integre a instância ServiceNow à conta da Ethoca usando o protocolo OAuth (versão 1.0a) para a categoria Consumer Clarity e usando credenciais de autenticação básica para a categoria Gestão de alertas de emissores para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke da Ethoca.
    • Função necessária: administrador

    Para a categoria Consumer Clarity

    Integre a instância ServiceNow à conta da Ethoca na categoria Consumer Clarity usando o protocolo OAuth (versão 1.0a) para autorizar e autenticar com segurança as solicitações ServiceNow.

    Anexar um certificado Ethoca

    Use o certificado gerado durante a configuração da conta da Ethoca para assinar a solicitação e as cargas.

    Antes de Iniciar

    • Certificado Ethoca válido
    • Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Certificados.
    2. Clique em Nova.
    3. No formulário, preencha os campos:
      Tabela 1. Campos do formulário da certificação X.509
      Campo Descrição
      Nome Insira um nome para identificar o certificado.
      Tipo Tipo do certificado. Selecione Armazenamento de chaves PKCS12.
      Notificar no vencimento Selecione a lista de usuários a serem notificados quando o certificado expirar.
      Aviso emitido antes do vencimento (em dias) Insira o número de dias em que uma notificação é enviada aos usuários antes que um certificado expire.
      Senha do armazenamento de chaves Senha para acessar o certificado. Use a senha do armazenamento de chaves de destino especificada ao criar o certificado.
      Ativo Opção para ativar o certificado do cliente.
      Descrição resumida Descrição resumida do certificado de cliente do usuário.
    4. Clique no ícone gerenciar anexos ( ícone gerenciar anexos.) e anexe um certificado Ethoca.
    5. Clique em Validar armazenamentos/certificados para validar o certificado.
    6. Clique em Enviar.

    Criar registros de credenciais

    Crie um registro de credencial para sua conta da Ethoca. Os aliases de conexão e credencial do spoke do Ethoca usam essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
    2. Selecione Novo.

      O sistema exibe a mensagem: Que tipo de Credenciais você deseja criar?

    3. Selecione Credencial da Ethoca.
      Um formulário de credencial da Ethoca em branco é exibido.
    4. Insira estes valores.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, Ethoca Credentials.
      Ativo Habilitar
      Alias da chave Alias de chave associado à conta da Ethoca.
      Senha de armazenamento de chaves Senha associada ao certificado.
      Chave do consumidor Chave do consumidor que você gerou durante a configuração da Ethoca.
      Certificado Selecione o certificado Ethoca recém-criado.
      Algoritmo de autenticação Algoritmo de autenticação personalizado para solicitações de assinatura de saída. Selecione Ethoca.
      Nota:
      Os usuários são alertados para não modificar diretamente o algoritmo de autenticação padrão.
    5. Clique em Enviar.

    Criar registros de conexão

    Crie um registro de conexão para sua conta da Ethoca. Os aliases de conexão e credencial do spoke da Ethoca usam essas conexões para executar ações na Ethoca.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexões e credenciais.
    2. Abrir para o registro da Ethoca.
    3. Na guia Conexões, clique em Novo.
    4. No formulário, preencha estes valores.
      Campo Valor necessário
      URL de conexão URL base para se conectar à sua instância da Ethoca. Insira: https://sandbox.api.ethocaweb.com/ethoca .
      Credencial Registro de credencial que você criou para a Ethoca. Por exemplo, Ethoca Credentials.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Para a categoria Gestão de alertas do emissor

    Integre a instância ServiceNow à conta da Ethoca na categoria Gestão de alertas de emissor usando credenciais de autenticação básica para autenticar solicitações ServiceNow.

    Criar credenciais básicas de autenticação

    Crie credenciais para acessar uma instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
    3. Selecione Credenciais de autenticação básica.
    4. No formulário, preencha os campos.
      Campo Descrição
      Nome Nome exclusivo para identificar o registro de credencial. Por exemplo, Ethoca Alerts Credentials
      Nome de usuário Nome para identificar o usuário.
      Senha Senha para usar esta credencial.
      Ativo Opção de usar ativamente o registro de credencial. Selecione a opção.
      Ordem A ordem (sequência) na qual a plataforma experimenta esta credencial enquanto tenta fazer login nos dispositivos. Valor padrão: 100.
    5. Selecione Enviar.

    Criar registros de conexão

    Crie um registro de conexão para sua conta da Ethoca. Os aliases de conexão e credencial do spoke da Ethoca usam essas conexões para executar ações em Alertas da Ethoca.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexões e credenciais.
    2. Aberto para o registro de Alertas da Ethoca.
    3. Na guia Conexões, clique em Novo.
    4. Preencha o formulário.
      Tabela 2. Configurar conexão
      Campo Descrição
      Nome da Conexão Nome da conexão estabelecida com a instância da Ethoca. O nome padrão da primeira conexão é atribuído automaticamente para corresponder ao nome especificado no formulário Conexões e credenciais na página Aliases de conexão e credencial.
      Credencial Registro de credencial criado para Ethoca Alerts. Por exemplo, Ethoca Alerts Credentials.
      URL de conexão URL base para se conectar à sua instância da Ethoca. Insira: https://sandbox.ethocaweb.com/ethoca-rest.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.