Configure um ServiceNow Instância para integração de CPQ
Configure um ServiceNow, gere um token da web JSON (JWT) e autentique chamadas de API para Logik.ai.
Antes de Iniciar
Função necessária: administrador
Procedimento
-
Confirme se a aplicação de integração CPQ está instalada no ServiceNow fazendo o seguinte
- Navegue até: https://<service_instance_url>/oauth_entity.do?sys_id
-
Verifique se o registro da aplicação de IU do administrador Logik.AI existe com um ID de cliente e um segredo.
Essas informações serão usadas posteriormente.
-
Em um diretório em sua máquina local, crie os certificados privados e públicos usando OpenSSL e, em seguida, use a keytool para converter o certificado do formato PKCS para JKS.
-
Crie a chave privada inserindo: openssl genrsa -out private.key 2048
A chave é criada em um arquivo chamado private.key.
-
Crie um certificado autoassinado que use a chave privada digitando: openssl req -new -x509 -key private.key -out publickey.cer -days 3650
Você será solicitado a inserir informações incluídas na solicitação de certificado. O certificado, chamado publickey.cer, contém a chave pública derivada da chave privada e dos metadados, como assunto e emissor. O certificado é assinado digitalmente usando a chave privada.
-
Crie um arquivo de armazenamento de chaves PKCS nº 12 (um arquivo .p12) digitando: openssl pkcs12 -export -in publickey.cer -inkey private.key -out keystore.p12 -name "<cert_name>"
Este arquivo de armazenamento de chaves agrupa o certificado assinado e a chave privada e define o alias para a entrada de chave e certificado no armazenamento de chaves. O arquivo é criptografado usando uma senha (também chamada de senha de exportação). Esta senha é necessária para importar e exportar o certificado.
-
Converta o arquivo de armazenamento de chaves .p12 (PKCS nº 12) para o formato .jks (armazenamento de chaves Java) digitando: keytool -importkeystore -srckeystore keystore.p12 -srcstoretype pkcs12 -destkeystore.jks
- Você será solicitado a fornecer a senha de exportação da etapa 2c para ler a chave privada e o certificado do arquivo .p12.
- Você será solicitado a inserir uma nova senha do armazenamento de chaves para proteger o arquivo do armazenamento de chaves JKS. Registre e retenha esta senha para mais tarde, já que ela é necessária para configurar o. ServiceNow instância.
-
Crie a chave privada inserindo: openssl genrsa -out private.key 2048
-
Em ServiceNow faça login como administrador e faça o seguinte:
-
Defina a Integração de CPQ como o escopo atual usando o ícone do menu de seleção de escopo
No menu Navegação unificada.
-
No filtro de navegação, insira sys_properties.list e abra o. glide.security.file.mime_type.validationpropriedade do sistema.
Defina o. Valor para falso e selecione Enviar .
-
Navegue até https://<service_instance_url>/sys_certificate.do?sys_id
- Anexe o arquivo keystore.jks criado na Etapa 2d ao registro do certificado. Insira a senha do armazenamento de chaves da etapa 2d no campo Senha do armazenamento de chaves.
- Selecione Ativo .
- Salve o certificado.
- (Opcional). Valide o certificado usando o link relacionado para o certificado K509.
-
Navegue até https://<service_instance_url>/jwt_keystore_aliases.do?sys_id: 3ab40bde2beeea1001bff246f291bfc8.
Insira a senha do armazenamento de chaves da etapa 2d como a chave de assinatura e salve o registro.
-
No filtro de navegação, insira sys_properties.list e abra o. glide.security.file.mime_type.validationpropriedade do sistema.
Defina o. Valor para verdadeiro e selecione Enviar .
-
Defina a Integração de CPQ como o escopo atual usando o ícone do menu de seleção de escopo
-
Configure a autenticação de API criando as funções de usuário de integração incluídas com o. Gestão de relacionamento com clientes de vendas aplicações:
-
Crie um usuário de integração.
- Navegar até Tudo > Segurança do sistema > Usuários e Grupos > Usuários.
- Selecione um novo usuário Novo .
- Insira o userID, o nome e o sobrenome.
- Selecione Enviar
- Abra o registro do usuário e, na guia Função, selecione Editar .
- Adicione as seguintes funções:
- snc_internal
- sn_sales_common.sales_agent
- sn_csm_pricing.pricing_integrador
- sn_prd_pm_adv.catalog_integrator
- sn_quote_mgmt_core.quote_integrator
- sn_ind_tmt_orm.order_integrador
- sn_opty_mgmt_core.opportunity_integrator
- sn_sales_cart.cart_integrator
- Navegue até: https://<service_instance_url>/oauth_entity_list.do?sysparm_query
-
Crie um usuário de integração.
-
Personalize a exibição de lista para adicionar o. Usuário da aplicação OAuth coluna.
Use o. Atualizar lista personalizada ícone.
- Na exibição de lista, clique duas vezes em Usuário da aplicação OAuth campo para editá-lo.
-
Defina o usuário criado na Etapa 4a como o registro da API Logik.ai.
Se você não puder modificar este campo, verifique se você está no escopo correto (integração de CPQ).
- Abra este registro de API Logik.ai.
- Selecione Ativo e salve o registro.
- Alterne para o escopo global.
-
Crie uma nova propriedade do sistema.
- No filtro de navegação, insira sys_properties.list.
- Selecione Novo.
- Insira o nome da propriedade glide.oauth.inbound.client.credential.grant_type.enabled .
- Selecione os ícones de edição para Funções de leitura e funções de gravação e selecione administrador para cada um.
- Defina o. Valor para verdadeiro.
- Selecione Atualizar.