Versions Compared

Old Version 1

changes.mady.by.user Paul Nguyen

Saved on

compared with

New Version Current

changes.mady.by.user Paul Nguyen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


HTML
<style>
.release-box {
	height: 30px; 
	width: 100px; 
	padding-top: 8px;
	text-align: center; 
	border-radius: 5px; 
	font-weight: bold; 
	background-color: #8efeb3#828995;  
	border-color: #FCE28A;
}

.release-box:hover {
  	cursor: hand;
    cursor: pointer;
    opacity: .9; 
}
</style>
<meta name="robots" content="noindex">

<div class="release-box">
<a href="https://docs.perspectium.com/display/kryptonLithium" style="text-decoration: none; color: #FFFFFF; display: block;">
KryptonLithium
</a>
</div>



The file that controls the configuration settings for a Perspectium Meshlet is a yaml file, generally named application.yml or application-dev.yml. This file is included as part of a meshlet's installation. To make changes to the configuration settings for your meshlet, open the yaml file in a text editing application and modify the configurations described in the sections below.



Panel
titleWhat's on this page?

Table of Contents
maxLevel2
absoluteUrltrue




UI Text Box
typetip

The configurations described below are the essential configurations that must be set for your meshlet. Additional configurations will depend on your integration; see the respective documentation (such as DataSync for Snowflake or ServiceBond for Jira) for further details.



Spring - Main Configuration

Note

To fix Spring security vulnerabilities CVE-2024-22262, CVE-2024-22259 and CVE-2024-22243, the Spring libraries used by the meshlets were upgraded to newer versions that have different requirements for their configuration. You will need to include the allow-circular-references configuration below for a meshlet to properly run.



KeyDefault ValueDescription

allow-circular-references


Required in Krypton 8.0.5 Release and Newer

This must be set to true for the meshlet to run correctly as Krypton 8.0.5 and newer uses versions of the Spring library (for security fixes) that require this configuration.

Code Block
languageyml
spring:
    main:
      allow-circular-references: true




Spring - RabbitMQ Configuration

Meshlets connect to the Perspectium Integration Mesh over AMQP/AMQPS. To configure your connection to the Integration Mesh, you will need to include the following configurations under spring.rabbitmq: 


KeyDefault ValueDescription

host


Host name for connecting to the Perspectium Integration Mesh.

Code Block
languageyml
spring:
   rabbitmq:
      host: localhost


port 

The AMQP or AMQPS port for connecting to the Perspectium Integration Mesh. The value for this configuration is generally 5672 for connecting over AMQP or 5671 for a secure connection over AMQPS (SSL).

Code Block
languageyml
spring:
   rabbitmq:
      port: 5671


username

Username for connecting to the Perspectium Integration Mesh.

Code Block
languageyml
spring:
   rabbitmq:
      username: testuser


password

Password for connecting to the Perspectium Integration Mesh.

Code Block
languageyml
spring:
   rabbitmq:
      password: password123


vhost

 Your virtual space (vhost) in the Perspectium Integration Mesh. This value will generally be provided to you by Perspectium Support.

Code Block
languageyml
spring:
   rabbitmq:
      vhost: /


exclusivetrue

Sets the meshlet to be the exclusive consumer of messages in the queue specified in the below perspectium.message.inboundQueue configuration. When this value is true, any other meshlet that tries to connect to the queue will be denied access until this meshlet is no longer connected. Using this value as true prevents other meshlets (such as a test or dev meshlet) from consuming messages on accident.

This can also be useful for high availability when you are running two meshlets at once. The first meshlet ran will continue to access and consume the queue while the second meshlet will continually retry every 30 seconds. If the first meshlet should die and lose connection, then the second meshlet will start connecting to consume messages.

Code Block
languageyml
spring:
   rabbitmq:
      exclusive: true


ssl:

   enabled


false

Enables a secure connection over AMQPS (SSL) to RabbitMQ. The spring.rabbitmq.port configuration above will also need to be an AMQPS port that accepts secure connections. 

Code Block
languageyml
spring:
   rabbitmq:
      ssl: 
         enabled: true





Perspectium - Message Configuration

To configure Perspectium-related properties including which queues to connect to in the Integration Mesh, you will need to include the following configurations under perspectium.message: 


KeyDefault ValueDescription

inboundQueue


Represents the queue in the Integration Mesh that the meshlet will consume messages from.

Code Block
languageyml
perspectium: 
   message:
      inboundQueue: psp.in.meshlet.servicenow.incident.psp_demo

Queues are generally in the following format:

DataSync:

Code Block
psp.in.meshlet.<application>.<customer/key>

Example: psp.in.meshlet.servicenow.psp_demo.

ServiceBond:

Code Block
psp.in.meshlet.<application>.<process>.<customer/key>

Example: psp.in.meshlet.servicenow.incident.psp_demo.

For more information on how to name your queues, contact Perspectium Support.

outboundQueue

Represents the queue in the Integration Mesh that the meshlet will be publishing messages to. This is normally a ServiceNow instance, such as another application that is being integrated with ServiceNow sending messages (records) to the instance. 

Code Block
languageyml
perspectium: 
   message:
      inboundQueue: psp.out.servicenow.dev123456


wrapCDATAfalse

Enabling this configuration will wrap all outbound message fields in a CDATA section. This is useful for when you have a ServiceBond integration with an API that receives XML payloads.

Code Block
languageyml
perspectium: 
   message:
      wrapCDATA: false


instanceKey


Enabling this feature will limit the meshlet to only process messages that have a key matching the value specified in this configuration. Perspectium applications generate messages that include a key field that represents the key of where the messages was generated from. In the case of ServiceNow, this is the instance name i.e. dev12345.

With this feature, the meshlet will only process messages with the matching key and skip all other messages. This allows you to filter out any messages so the meshlet is reading messages from only one source.

Code Block
languageyml
perspectium: 
   message:       
      instanceKey: dev12345

If this configuration is not specified, the meshlet will process all messages it consumes from its inbound queue.




Example of a meshlet configuration yaml file

The example below shows a basic configuration of the meshlet configuration yaml file (i.e. application.yml or application-dev.yml).

Code Block
languageyml
spring:
    main:
      allow-circular-references: true
    rabbitmq:
      host: localhost
      port: 5672
      username: georvioloan
      password: password123
      vhost: /
      exclusive: false
perspectium:
   message:
      inboundQueue: psp.in.meshlet.servicenow.incident.psp_demo
      outboundQueue: psp.out.servicenow.dev123456
      wrapCDATA: false