ServiceNow conector V1.0 - Amazon Kendra
Características admitidasRequisitos previosInstrucciones de conexiónMás información

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ServiceNow conector V1.0

ServiceNow proporciona un sistema de administración de servicios basado en la nube para crear y administrar flujos de trabajo a nivel de organización, como los servicios de TI, los sistemas de emisión de tickets y el soporte. Puede utilizarlo Amazon Kendra para indexar sus ServiceNow catálogos, artículos de conocimiento y sus anexos.

nota

Está previsto que el soporte para el ServiceNow conector ServiceNowConfiguration V1.0/API finalice en 2023. Recomendamos migrar o utilizar el ServiceNow conector V2.0/API. TemplateConfiguration

Para solucionar problemas del conector de la fuente de Amazon Kendra ServiceNow datos, consulte. Solución de problemas con los orígenes de datos

Características admitidas

Amazon Kendra ServiceNow el conector de fuente de datos admite las siguientes funciones:

  • ServiceNow versiones de instancia: Londres, Otras

  • Patrones de inclusión/exclusión: catálogos de servicios, artículos de conocimiento y sus archivos adjuntos

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar la fuente de ServiceNow datos, realiza estos cambios en tus AWS cuentas ServiceNow y.

En ServiceNow, asegúrate de tener:

  • Creó una cuenta de ServiceNow administrador y creó una ServiceNow instancia.

  • Ha copiado el host de la URL de la ServiceNow instancia. Por ejemplo, si la URL de la instancia es https://your-domain.service-now.com, el formato de la URL del host que introduzca es your-domain.service-now.com.

  • Apuntó sus credenciales de autenticación básicas, que incluyen un nombre de usuario y una contraseña Amazon Kendra para poder conectarse a la ServiceNow instancia.

    nota

    Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).

  • Opcional: configuraste un token de credenciales de OAuth 2.0 que puede identificar Amazon Kendra y generar un nombre de usuario, una contraseña, un ID de cliente y un secreto de cliente. El nombre de usuario y la contraseña deben proporcionar acceso a la base de ServiceNow conocimientos y al catálogo de servicios. Consulte ServiceNow la documentación sobre la autenticación de OAuth 2.0 para obtener más información.

  • Ha agregado los siguientes permisos:

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_can_read_mtom

    • sc_catalog

    • sc_category

    • sc_cat_item

    • sys_attachment

    • sys_attachment_doc

    • sys_user_role

  • Comprobaste que cada documento es único en ServiceNow las demás fuentes de datos que planeas usar para el mismo índice y entre ellas. Cada origen de datos que desee utilizar para un índice no debe contener el mismo documento en varios orígenes de datos. Los ID de documento son globales para un índice y deben ser únicos por índice.

En el suyo Cuenta de AWS, asegúrese de tener:

  • Creó un Amazon Kendra índice y, si usa la API, anotó el ID del índice.

  • Creó un IAM rol para su fuente de datos y, si usa la API, anotó el ARN del IAM rol.

    nota

    Si cambias el tipo de autenticación y las credenciales, debes actualizar tu IAM rol para acceder al ID AWS Secrets Manager secreto correcto.

  • Guardó sus credenciales de ServiceNow autenticación en un AWS Secrets Manager secreto y, si usa la API, anotó el ARN del secreto.

    nota

    Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).

Si no tiene un IAM rol o secreto existente, puede usar la consola para crear un nuevo IAM rol y un Secrets Manager secreto al conectar su fuente de ServiceNow datos. Amazon Kendra Si utiliza la API, debe proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes y un ID de índice.

Instrucciones de conexión

Para conectarse Amazon Kendra a su fuente de ServiceNow datos, debe proporcionar los detalles necesarios de la fuente de ServiceNow datos para que Amazon Kendra pueda acceder a sus datos. Si aún no lo ha configurado ServiceNow , Amazon Kendra consulteRequisitos previos.

Console

Para conectarse Amazon Kendra a ServiceNow

  1. Inicie sesión en la consola AWS de administración y abra la Amazon Kendra consola.

  2. En el panel de navegación izquierdo, elija Índices y, a continuación, elija el índice que desee usar de la lista de índices.

    nota

    Puede elegir configurar o editar los ajustes de Control de acceso de usuarios en la Configuración del índice.

  3. En la página Introducción, seleccione Agregar origen de datos.

  4. En la página Agregar fuente de datos, elija el ServiceNowconector V1.0 y, a continuación, elija Agregar fuente de datos.

  5. En la página Especificar detalles del origen de datos, introduzca la siguiente información:

    1. En Nombre y descripción, en Nombre del origen de datos: introduzca un nombre para el origen de datos. Puede incluir guiones, pero no espacios.

    2. (Opcional) Descripción: introduzca una descripción opcional para el origen de datos.

    3. En el idioma predeterminado: elija un idioma para filtrar los documentos para el índice. A menos que especifique lo contrario, el idioma predeterminado es el inglés. El idioma especificado en los metadatos del documento anula el idioma seleccionado.

    4. En Etiquetas, para añadir una nueva etiqueta: incluya etiquetas opcionales para buscar y filtrar sus recursos o realizar un seguimiento de sus AWS costes.

    5. Elija Siguiente.

  6. En la página Definir acceso y seguridad, introduzca la siguiente información:

    1. ServiceNow host: introduzca la URL del ServiceNow host.

    2. ServiceNow versión: seleccione su ServiceNow versión.

    3. Elija entre Autenticación básica y Autenticación OAuth 2.0 según el caso de uso.

    4. AWS Secrets Manager secreto: elija un secreto existente o cree uno nuevo Secrets Manager para almacenar sus credenciales de ServiceNow autenticación. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager .

      1. Nombre del secreto: un nombre para su secreto. El prefijo 'AmazonKendra- ServiceNow -' se añade automáticamente a tu nombre secreto.

      2. Si utilizas la autenticación básica, introduce el nombre secreto, el nombre de usuario y la contraseña de tu cuenta. ServiceNow

        Si utilizas la autenticación OAuth2, introduce el nombre secreto, el nombre de usuario, la contraseña, el ID de cliente y el secreto de cliente que creaste en tu cuenta. ServiceNow

      3. Haga clic en Guardar y agregar secreto.

    5. IAM rol: elige un IAM rol existente o crea uno nuevo IAM para acceder a las credenciales del repositorio y al contenido del índice.

      nota

      IAM los roles utilizados para los índices no se pueden usar para las fuentes de datos. Si no está seguro de si un rol existente se utiliza para un índice o para las preguntas frecuentes, elija Crear un nuevo rol para evitar errores.

    6. Elija Siguiente.

  7. En la página Configurar ajustes de sincronización, introduzca la siguiente información:

    1. Incluir artículos de conocimiento: elija si desea indexar los artículos de conocimiento.

    2. Tipo de artículos de conocimiento: elija entre incluir solo artículos públicos e Incluir artículos según una consulta de ServiceNow filtro según su caso de uso. Si selecciona Incluir artículos según una consulta de ServiceNow filtro, debe introducir una consulta de filtro copiada de su ServiceNow cuenta.

    3. Incluir archivos adjuntos de artículos de conocimiento: elija si desea indexar los archivos adjuntos de los artículos de conocimiento. También puede seleccionar tipos de archivos específicos para indexarlos.

    4. Incluir elementos del catálogo: elija si desea indexar los elementos del catálogo.

    5. Incluir archivos adjuntos de elementos del catálogo: elija si desea indexar los archivos adjuntos de los elementos del catálogo. También puede seleccionar tipos de archivos específicos para indexarlos.

    6. Frecuencia: la frecuencia con la Amazon Kendra que se sincronizará con la fuente de datos.

    7. Elija Siguiente.

  8. En la página Establecer asignaciones de campos, especifique la siguiente información:

    1. Artículos de conocimiento y catálogo de servicios: seleccione entre los campos de fuentes de datos predeterminados Amazon Kendra generados y otras asignaciones de campos sugeridas que desee asignar a su índice.

    2. Agregar campo: para agregar campos de origen de datos personalizados para crear un nombre de campo de índice al que asignarlos y el tipo de datos del campo.

    3. Elija Siguiente.

  9. En la página Revisar y crear, compruebe que la información que ha introducido es correcta y, a continuación, seleccione Añadir origen de datos. También puede elegir editar la información desde esta página. El origen de datos aparecerá en la página Orígenes de datos una vez que el origen de datos se haya agregado correctamente.

API

Para conectarse a Amazon Kendra ServiceNow

Debe especificar lo siguiente mediante la ServiceNowConfiguration API:

  • URL de la fuente de datos: especifique la ServiceNow URL. El punto de conexión del host debe tener el siguiente aspecto your-domain.service-now.com.

  • Instancia de host de la fuente de datos: especifique la versión de la instancia de ServiceNow host como oLONDON. OTHERS

  • Nombre secreto de recurso de Amazon (ARN): proporcione el nombre de recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación que creó en su cuenta. ServiceNow

    Si está utilizando la autenticación básica, el secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "username": "user name",
    "password": "password"
}

    Si está utilizando la autenticación OAuth2, el secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}

  • IAM rol: especifique RoleArn cuándo llama CreateDataSource para proporcionar un IAM rol con permisos para acceder a su Secrets Manager secreto y para llamar a las API públicas requeridas para el conector y. ServiceNow Amazon Kendra Para obtener más información, consulte las IAM funciones de las fuentes ServiceNow de datos.

También puede añadir las siguientes características opcionales:

  • Asignaciones de campos: elija asignar los campos de la fuente de ServiceNow datos a los campos de índice. Amazon Kendra Para obtener más información, consulte Asignación de campos de origen de datos.

    nota

    El campo del cuerpo del documento o el cuerpo del documento equivalente de sus documentos es obligatorio Amazon Kendra para poder buscarlos. Debe asignar el nombre del campo del cuerpo del documento en la fuente de datos al nombre del campo de índice_document_body. Todos los demás campos son opcionales.

  • Filtros de inclusión y exclusión: especifique si desea incluir o excluir determinados archivos adjuntos de catálogos y artículos de conocimiento.

    nota

    La mayoría de los orígenes de datos utilizan patrones de expresiones regulares, que son patrones de inclusión o exclusión denominados filtros. Si especifica un filtro de inclusión, solo se indexará el contenido que coincida con el filtro de inclusión. Los documentos que no coincidan con el filtro de inclusión no se indexan. Si especifica un filtro de inclusión y exclusión, los documentos que coincidan con el filtro de exclusión no se indexarán, aunque coincidan con el filtro de inclusión.

  • Parámetros de indexación: también puede optar por especificar si desea:

    • Indexar artículos de conocimiento y catálogos de servicios, o ambos. Si decide indexar artículos de conocimiento y elementos del catálogo de servicios, debe proporcionar el nombre del ServiceNow campo que está asignado al campo de contenido del documento de índice en el Amazon Kendra índice.

    • Indexar los archivos adjuntos de los artículos de conocimiento y los elementos del catálogo.

    • Utilice una ServiceNow consulta que seleccione documentos de una o más bases de conocimiento. Las bases de conocimiento pueden ser públicas o privadas. Para obtener más información, consulte Especificar documentos a indexar con una consulta.

Más información

Para obtener más información sobre la integración Amazon Kendra con la fuente de ServiceNow datos, consulte: