Configurar o spoke da Amazon Alexa

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • Integre a instância [ ServiceNow e a conta da Amazon Alexa criando uma aplicação OAuth personalizada em da Amazon Alexa para autenticar solicitações ServiceNow.

    Antes de Iniciar

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

    Criar um perfil de segurança

    Crie e registre um perfil de segurança por meio do Console do desenvolvedor para usar o Login with Amazon em sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login no Amazon Developer Portal com credenciais de administrador.
    2. Crie um perfil de segurança.
      Para obter informações sobre como criar um perfil de segurança, consulte Criar um perfil de segurança LwA na Documentação do desenvolvedor da Amazon.
    3. Copie e registre os valores de ID do cliente e segredo do cliente para uso posterior.
    4. Configure o perfil de segurança e especifique esses valores em Configurações da Web:
      Campo Valor
      Origens permitidas ServiceNow URL da instância.
      URLs de retorno permitidos ServiceNow URL de redirecionamento de instância neste formato: https://<Instance-Name> .com/oauth_redirect.do
      Para obter mais informações sobre como configurar a política de segurança, consulte Adicionar seu site ao seu perfil de segurança na Documentação do desenvolvedor da Amazon.

    Registrar da Amazon Alexa como um provedor OAuth

    Use as informações geradas durante a configuração do perfil de segurança para registrar da Amazon Alexa como um provedor OAuth e permitir que a instância ServiceNow solicite tokens OAuth 2.0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Aberto para registro, Amazon Alexa.
    3. No formulário, preencha estes valores.
      Tabela 1. Formulário de registros de aplicações
      Campo Descrição
      ID de cliente ID do cliente criado durante a configuração do perfil de segurança.
      Segredo do cliente Segredo do cliente criado durante a configuração do perfil de segurança.
      URL de Autorização Endpoint do código de autorização do OAuth. Insira: https://www.amazon.com/ap/oa
      URL de Token Endpoint do token do servidor OAuth. Insira: https://api.amazon.com/auth/o2/token
      URL de redirecionamento Endpoint de retorno de chamada do OAuth neste formato: https://<instance> .service-now.com/oauth_redirect.do
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Código de autorização.
      Aplicação Escopo da aplicação que contém este registro.
      Ativo Opção para usar ativamente o registro da aplicação.
    4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Criar um registro de credencial para o spoke da Amazon Alexa

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.

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

    3. Selecione Credenciais OAuth 2.0.
    4. No formulário, preencha estes valores.
      Tabela 2. Formulário de credenciais OAuth 2.0
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Alexa Cred.
      Ativo Opção de usar ativamente o registro de credencial.
      Perfil de Entidade OAuth Perfil OAuth criado durante o registro de da Amazon Alexa como um provedor OAuth. Por exemplo, Amazon Alexa default_profile.
      Alias de credencial Alias de credencial associado ao spoke.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Enviar.
    6. Para gerar o token OAuth, clique no link relacionado Obter Token OAuth.
      Você será redirecionado para o portal da Amazon.
    7. Clique em Permitir.
      Você será redirecionado de volta para a instância ServiceNow.

    Criar um registro de conexão para o spoke da Amazon Alexa

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexões e credenciais.
    2. Abra o registro de alias, AmazonAlexa.
    3. Na guia Conexões, clique em Novo.
    4. No formulário, preencha estes campos.
      Tabela 3. Formulário de conexão
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Alexa Connection.
      Credenciais Registro de credencial criado para o spoke do Amazon Alexa. Por exemplo, Alexa Cred.
      Alias de conexão Registro de alias associado a esta conexão.
      URL de Conexão URL base para se conectar a da Amazon Alexa. Insira: https://api.amazonalexa.com
      Ativo Opção para usar ativamente o registro de conexão.
      Domínio Domínio no qual a ação é executada.
    5. Na guia Atributos, insira v1 para a versão.
    6. Clique em Enviar.

    Configurar webhook para o spoke da Amazon Alexa

    Autentique as solicitações de entrada da conta da Amazon Alexa para sua instância ServiceNow criando um registro de webhook.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. No navegador de filtros, insira token_verification.list.
      Os registros na tabela Verificações de token [token_verification] são exibidos.
    2. Clique em Nova.
    3. No formulário, preencha estes valores.
      Tabela 4. Formulário de Verificação de token
      Campo Descrição
      Nome Nome para identificar o registro do token. Por exemplo, token da Alexa.
      Descrição Breve descrição do token.
      Token Valor do token. Este valor é criptografado antes de ser usado.
    4. Clique em Enviar.
    5. Navegar até Webhooks da Alexa > Registros de webhook da Alexa.
    6. Clique em Nova.
    7. No formulário, preencha estes valores.
      Tabela 5. Formulário de registro do Webhook da Alexa
      Campo Descrição
      Nome Nome para identificar o registro do webhook. Por exemplo, token da Alexa.
      Descrição Breve descrição do registro do webhook.
      Token Token que você criou. Por exemplo, token da Alexa.
      Caminho Endpoint de REST com script. Um endpoint padrão está disponível. Você pode alterar o valor padrão de acordo com seus requisitos.
    8. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    9. Clique em URL de retornode chamada .
      A URL de retorno de chamada do Webhook é exibida na mensagem de confirmação. Copie e registre este valor.
    10. Faça login no Console de gestão da AWS.
    11. Na função do AWS Lambda, especifique a URL de retorno de chamada do Webhook e salve as mudanças.
      URL de retorno de chamada do Webhook
    12. Faça login no Console do desenvolvedor da Alexa.
    13. Navegar até Compilação > PERSONALIZADO > Endpoint e especifique o ARN da função do AWS Lambda que você configurou.
      ARN do AWS Lambda