Cisco DNA connector documentation reference

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x 

Connection

Connection

The connection types that can be provided to this configuration.

x 

Expiration Policy

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform will expire the instance at the exact moment that it becomes eligible. The runtime will actually purge the instances when it sees it fit.

Host Name

String

x 

User Name

String

x 

Password

String

x 

Connection Timeout

Number

10

Connection Timeout Unit

Enumeration, one of:

• NANOSECONDS
• MICROSECONDS
• MILLISECONDS
• SECONDS
• MINUTES
• HOURS
• DAYS

Time unit to be used in the Connection Timeout

SECONDS

TLS Configuration

Tls

Reconnection

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn't pass after exhausting the associated reconnection strategy

Host

String

Port

Number

User Name

String

Password

String

NTLM Domain

String

Configuration

String

The name of the configuration to use.

x 

Create Event Subscription Payloads

Array of Any

Input payload for the request body

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Delete Event Subs Payload

Any

Input payload for the request body

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Get Event Subscription Payload

Any

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Array of Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Get Events Payload

Any

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Array of Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Get Issue Enrichment Details Payload

Any

Input payload for the request body

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Get Issues Payload

Any

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Array of Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Get Webhook Subscription Payload

Any

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Array of Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Update Event Subscription Payloads

Array of Any

Input payload for the request body

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Any

Attributes Type

Response Headers

Configuration

String

The name of the configuration to use.

x 

Update Issues Status Payload

Any

Input payload for the request body

#[payload]

Target Variable

String

The name of a variable on which the operation's output will be placed

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

Reconnection Strategy

• Reconnect
• Reconnect Forever

A retry strategy in case of connectivity errors

Type

Any

Attributes Type

Response Headers

Enabled Protocols

String

A comma separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma separated list of cipher suites enabled for this context.

Trust Store

Trust Store

Key Store

Key Store

Revocation Check

• Standard Revocation Check
• Custom Ocsp Responder
• Crl File

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.

Password

String

The password used to protect the trust store.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the trust store.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.

Type

String

The type of store used.

Alias

String

When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the key store.

Algorithm

String

The algorithm used by the key store.

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer Crls

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy.

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the trust store), if present.

Path

String

The path to the CRL file.

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn't pass after exhausting the associated reconnection strategy

Reconnection Strategy

• Reconnect
• Reconnect Forever

The reconnection strategy to use

Frequency

Number

How often (in ms) to reconnect

Count

Number

How many reconnection attempts to make

Frequency

Number

How often (in ms) to reconnect

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it's considered eligible for expiration

Time Unit

Enumeration, one of:

• NANOSECONDS
• MICROSECONDS
• MILLISECONDS
• SECONDS
• MINUTES
• HOURS
• DAYS

A time unit that qualifies the maxIdleTime attribute

Headers

Object

Status Code

Number