AWS::Kendra::DataSource ServiceNowConfiguration - Amazon CloudFormation
SyntaxProperties
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

AWS::Kendra::DataSource ServiceNowConfiguration

Provides the configuration information to connect to ServiceNow as your data source.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

Properties

AuthenticationType

The type of authentication used to connect to the ServiceNow instance. If you choose HTTP_BASIC, Amazon Kendra is authenticated using the user name and password provided in the Amazon Secrets Manager secret in the SecretArn field. If you choose OAUTH2, Amazon Kendra is authenticated using the credentials of client ID, client secret, user name and password.

When you use OAUTH2 authentication, you must generate a token and a client secret using the ServiceNow console. For more information, see Using a ServiceNow data source.

Required: No

Type: String

Allowed values: HTTP_BASIC | OAUTH2

Update requires: No interruption

HostUrl

The ServiceNow instance that the data source connects to. The host endpoint should look like the following: {instance}.service-now.com.

Required: Yes

Type: String

Pattern: ^(?!(^(https?|ftp|file):\/\/))[a-z0-9-]+(\.service-now\.com)$

Minimum: 1

Maximum: 2048

Update requires: No interruption

KnowledgeArticleConfiguration

Configuration information for crawling knowledge articles in the ServiceNow site.

Required: No

Type: ServiceNowKnowledgeArticleConfiguration

Update requires: No interruption

SecretArn

The Amazon Resource Name (ARN) of the Amazon Secrets Manager secret that contains the user name and password required to connect to the ServiceNow instance. You can also provide OAuth authentication credentials of user name, password, client ID, and client secret. For more information, see Using a ServiceNow data source.

Required: Yes

Type: String

Pattern: arn:[a-z0-9-\.]{1,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}

Minimum: 1

Maximum: 1284

Update requires: No interruption

ServiceCatalogConfiguration

Configuration information for crawling service catalogs in the ServiceNow site.

Required: No

Type: ServiceNowServiceCatalogConfiguration

Update requires: No interruption

ServiceNowBuildVersion

The identifier of the release that the ServiceNow host is running. If the host is not running the LONDON release, use OTHERS.

Required: Yes

Type: String

Allowed values: LONDON | OTHERS

Update requires: No interruption