Configurar o spoke da Amazon Alexa

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

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

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub.
    • 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 com a Amazon na 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 de cliente e Segredo do cliente para uso posterior.
    4. Configure o perfil de segurança e especifique estes 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 Amazon Alexa como um provedor OAuth

    Use as informações geradas durante a configuração do perfil de segurança para registrar 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 de 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 do token Endpoint do token do servidor OAuth. Insira: https://api.amazon.com/auth/o2/token
      URL de redirecionamento Endpoint de retorno de chamada 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 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 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 Amazon Alexa. Os aliases de conexão e credencial do spoke do Amazon Alexa usam essas conexões para executar ações em 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 esses campos.
      Tabela 3. Formulário de conexão
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Alexa Connection.
      Credencial Registro de credencial criado para o spoke da 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 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 Amazon Alexa

    Autentique as solicitações de entrada da conta 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 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 REST de 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.
      O URL de retorno de chamada do Webhook é exibido 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 o 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