View a markdown version of this page

Configurar a autenticação de credenciais do cliente OAuth 2.0 para ServiceNow - Amazon Bedrock
Etapa 1: habilitar o tipo de concessão de credenciais do clienteEtapa 2: criar uma conta de serviço dedicadaEtapa 3: atribuir funções de conta de serviçoEtapa 4: Registrar o aplicativo OAuthEtapa 5: configurar o aplicativo OAuthEtapa 6: configurar políticas de acesso à APIEtapa 7: Verificar o fluxo do OAuthEtapa 8: Crie o segredo do Secrets ManagerPróximas etapas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar a autenticação de credenciais do cliente OAuth 2.0 para ServiceNow

Use a API ServiceNow de tabela com credenciais de cliente do OAuth 2.0 (2LO) para autenticação. Conclua todas as etapas a seguir em sua ServiceNow instância antes de configurar a fonte de dados no Amazon Bedrock.

Etapa 1: habilitar o tipo de concessão de credenciais do cliente

  1. Em ServiceNow, navegue até sys_properties.list usar o navegador de filtros.

  2. Crie uma nova propriedade do sistema com os seguintes valores:

    • Nome: glide.oauth.inbound.client.credential.grant_type.enabled

    • Tipo: true | false

    • Value (valor): true

Etapa 2: criar uma conta de serviço dedicada

  1. Navegue até Administração de usuários > Usuários.

  2. Escolha Novo e preencha o formulário:

    • ID de usuário — Um nome descritivo (por exemplo,svc.amazon.quick.kb).

    • Somente acesso ao serviço Web — Marcado. Isso evita o login interativo.

    • Senha — Defina uma senha forte. O conector usa OAuth, mas é necessária uma senha para a criação da conta.

  3. Selecione Enviar.

Etapa 3: atribuir funções de conta de serviço

  1. Abra a conta de serviço (Administração de usuários > Usuários > sua conta de serviço).

  2. Na guia Funções, escolha Editar e adicione as seguintes funções:

    • knowledge_admin— Acesso completo de leitura a todos os artigos da base de conhecimento. Ignora as restrições de critérios de usuário por KB.

    • catalog_admin— Acesso total de leitura a todos os itens do catálogo de serviços. Ignora as restrições por catálogo.

  3. Escolha Salvar.

nota

Depois de salvar, você vê aproximadamente 14 funções no total. ServiceNowherda automaticamente as funções contidas das funções principais_admin. Você só atribui manualmente as duas funções listadas na etapa 2 (knowledge_adminecatalog_admin). Não atribua as snc_read_only funções adminitil,, ou.

Etapa 4: Registrar o aplicativo OAuth

  1. Navegue até System OAuth > Application Registry.

  2. Escolha Novo > Criar um endpoint da API OAuth para clientes externos.

  3. Preencha o formulário:

    • Nome — Um nome descritivo (por exemplo,Amazon-Quick-KB-Client).

    • URL de redirecionamento — Deixe em branco. Não é necessário para o fluxo de credenciais do cliente.

  4. Selecione Enviar.

  5. Copie imediatamente o ID do cliente e o segredo do cliente. O segredo do cliente é exibido apenas uma vez.

Importante

Você deve usar a página do interceptor para criar o aplicativo. Não crie o registro inserindo-o diretamente na oauth_entity tabela.

Etapa 5: configurar o aplicativo OAuth

  1. Re-open o registro do aplicativo na lista do Registro de Aplicativos.

  2. Se o campo Usuário do aplicativo OAuth não estiver visível, adicione-o usando Configurar > Construtor de formulários.

  3. Defina os seguintes campos:

    • Usuário do aplicativo OAuth — Sua conta de serviço (por exemplo,svc.amazon.quick.kb).

    • Restrição de escopo —Broadly scoped.

    • Tipo de cliente —integration_as_a_service.

  4. Selecione Atualizar.

Etapa 6: configurar políticas de acesso à API

Sem políticas de acesso à API, os tokens são autenticados, mas a API de tabela retorna HTTP 401. Conclua as duas subetapas abaixo.

Criar o perfil de autenticação de entrada

  1. Navegue até System Web Services > Políticas de acesso à API > Perfil de autenticação de entrada.

  2. Escolha Novo e defina:

    • Nome — Por exemplo,Amazon-Quick-KB-Client-Profile.

    • Digite – OAuth.

    • Entidade OAuth — Selecione seu aplicativo OAuth.

  3. Selecione Enviar.

  4. Re-open o perfil. Na lista relacionada Políticas de autenticação, escolha Editar e adicione Permitir política de acesso. Escolha Salvar.

Crie a política de acesso à API REST

  1. Navegue até System Web Services > Políticas de acesso à API > Políticas de acesso à API REST.

  2. Escolha Novo e defina:

    • Nome — Por exemplo,Table API Oauth access policy.

    • API REST —Table API.

    • Caminho da API REST —now/table.

    • Aplicar a todos os métodos — Marcado.

    • Aplicar a todos os recursos — Marcado.

    • Aplicar a todas as tabelas — Marcado.

    • Aplicar a todas as versões — Marcado.

  3. Selecione Enviar.

  4. Re-open a política. Na lista relacionada de perfis de autenticação de entrada, escolha Editar e adicione seu perfil de autenticação de entrada. Escolha Salvar.

Etapa 7: Verificar o fluxo do OAuth

Antes de configurar a fonte de dados, verifique se o fluxo do OAuth funciona de ponta a ponta.

Solicite um token: 

curl -s -X POST "https://INSTANCE.service-now.com/oauth_token.do" \
  -d "grant_type=client_credentials" \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET"

Verifique o acesso à API Table: 

curl -s "https://INSTANCE.service-now.com/api/now/table/kb_knowledge?sysparm_limit=1" \
  -H "Authorization: Bearer ACCESS_TOKEN"

A tabela a seguir descreve cada resultado da verificação e a ação a ser tomada.

Resultados da verificação
Resultado Significado Ação
HTTP 200 com dados Funcionando corretamente Prossiga com a criação do segredo do Secrets Manager.
HTTP 200 com matriz vazia knowledge_adminFunção ausente Atribua a knowledge_admin função à conta de serviço.
HTTP: 401 Política de acesso à API não configurada Verifique o perfil de autenticação de entrada e a configuração da política de acesso da API REST.

Etapa 8: Crie o segredo do Secrets Manager

Armazene as credenciais em um AWS Secrets Manager segredo da Região da AWS mesma forma que sua base de conhecimento com os seguintes pares de valores-chave:

{
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "instanceUrl": "https://YOUR_INSTANCE.service-now.com"
}
Campos secretos
Campo Description
clientId O ID do cliente do aplicativo da etapa 4.
clientSecret O segredo do App Client revelado no momento da criação na etapa 4.
instanceUrl URL da ServiceNow instância completa (incluirhttps://, sem barra final).
Importante

Eles não instanceUrl devem ter uma barra final.

Crie o segredo com AWS Command Line Interface:

aws secretsmanager create-secret \
  --name bedrock-servicenow-creds \
  --secret-string file://secret.json

Registre o ARN secreto da resposta. Você o usa como fonte de dadossecretArn.

Próximas etapas

Depois de armazenar o segredo, crie a fonte de dados. Consulte Conectar uma fonte ServiceNow de dados.