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:
JSON
{ "AuthenticationType" :
String
, "HostUrl" :String
, "KnowledgeArticleConfiguration" :ServiceNowKnowledgeArticleConfiguration
, "SecretArn" :String
, "ServiceCatalogConfiguration" :ServiceNowServiceCatalogConfiguration
, "ServiceNowBuildVersion" :String
}
YAML
AuthenticationType:
String
HostUrl:String
KnowledgeArticleConfiguration:ServiceNowKnowledgeArticleConfiguration
SecretArn:String
ServiceCatalogConfiguration:ServiceNowServiceCatalogConfiguration
ServiceNowBuildVersion:String
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 theSecretArn
field. If you chooseOAUTH2
, 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, useOTHERS
.Required: Yes
Type: String
Allowed values:
LONDON | OTHERS
Update requires: No interruption