Configure o. Amazon Alexa spoke

Integre o. ServiceNowe. Amazon Alexa Criando uma aplicação OAuth personalizada em Amazon Alexa para autenticar ServiceNowsolicitações.

Antes de Iniciar

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

Crie 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 no ServiceNowinstância.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Faça login em 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 Crie um perfil de segurança LwA em 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 estes valores em Configurações da web :

   Campo	Valor
   Origens permitidas	ServiceNow URL da instância.
   URLs de retorno permitidos	ServiceNowURL 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 Adicione seu site ao seu perfil de segurança em Documentação do desenvolvedor da Amazon .

Registrar Amazon Alexa Como um provedor de OAuth

Use as informações geradas durante a configuração do perfil de segurança para registrar Amazon Alexa Como um provedor de OAuth e permita o. ServiceNowInstância para solicitar tokens OAuth 2,0.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações.
2. Aberto para o 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. Inserir: https://www.amazon.com/ap/oa
   URL de Token	Endpoint do token do servidor OAuth. Inserir: https://api.amazon.com/auth/o2/token
   Redirecional URL	Endpoint de retorno de chamada de 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.

Crie um registro de credencial para Amazon Alexa spoke

Crie um registro de credencial para Amazon Alexa conta. . Amazon Alexa spoke o alias de conexão e credencial usa 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. 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, Crédito da Alexa .
   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 de 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 ServiceNowinstância.

Crie um registro de conexão para Amazon Alexa spoke

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

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 o registro de alias, AmazonAlexa .
3. Em 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, Conexão da Alexa .
   Credencial	Registro de credencial criado para Amazon Alexa spoke . Por exemplo, Crédito da Alexa .
   Alias de conexão	Registro de alias associado a esta conexão.
   URL de conexão	URL de base para se conectar Amazon Alexa . Inserir: 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. Em Atributos , insira v1 para versão .
6. Clique em Enviar.

Configure o webhook para Amazon Alexa spoke

Autentique as solicitações de entrada de Amazon Alexa para seu ServiceNowcriando 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 de token. Por exemplo, Token da Alexa .
   Descrição	Descrição resumida do token.
   Token	Valor do token. Este valor é criptografado antes de ser usado.

4. Clique em Enviar.
5. Navegar até Webhooks da Alexa > Registros do webhook da Alexa.
6. Clique em Nova.
7. No formulário, preencha estes valores.

   Tabela 5. Formulário de registro do webhook do Alexa

   Campo	Descrição
   Nome	Nome para identificar o registro de registro do webhook. Por exemplo, Token da Alexa .
   Descrição	Descrição resumida do registro de registro do webhook.
   Token	Token que você criou. Por exemplo, Token da Alexa .
   Caminho	Endpoint REST com script. Um endpoint padrão está disponível. Você pode mudar o valor padrão de acordo com sua necessidade.

8. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
9. Clique em URL de retorno de chamada .
   O URL de retorno de chamada do webhook é exibido na mensagem de confirmação. Copie e registre este valor.
10. Faça login em 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.

    

12. Faça login em Console do desenvolvedor do Alexa .
13. Navegar até Construir > PERSONALIZADO > Endpoint E especifique ARN da função do AWS Lambda que você configurou.