DCKAP Integrator
Getting StartedIntegrator StatusRoadmapRelease Notes
  • Overview
    • Enterprise Integration Platform
    • What is DCKAP Integrator?
    • Integrator Architecture
    • Integrator Security
  • GETTING STARTED
    • Quick Start Guide
    • New User Registration
      • Available Plans
    • Integrator Dashboard
    • Analytics
  • User Guide
    • The Basics
    • Account Management
      • User Groups
      • Account Settings
      • Two-Factor Authentication
    • Projects
      • Add New Project
      • Managing Projects
      • Transfer Project Ownership
    • API Access Keys
    • Project Invitations
    • Help and Support
      • Raise a Ticket
      • Visibility and Collaborators
      • Help and Support - A Quick Overview
    • Exchange
  • PROJECT MANAGER
    • Integrations
      • Add New Pipe
      • Flows and Handlers
      • Mapping and Modifiers
      • Advanced Modifiers
      • Advanced Scheduler
    • Workflows
      • Flow Builder
      • Snippets
      • Actions
        • API Call
        • Console
        • Decision
        • Loop
        • Detail Logger
        • Error Logger
        • Code Runner
        • Formatter
        • Notification
        • Snippet
        • Return
        • Sleep
      • Mock Data
      • FAQs
    • Systems
      • Credentials
      • API Manager
        • API Components
        • Test API
      • Private Systems
      • Authentication Types
        • OAuth 2.0
    • Logs
    • Project Settings
    • Project Analytics
    • Advanced
      • Flows
    • Project Documents
  • TECHNICAL GUIDE
    • Flows & Handlers
      • Add New Flow
      • Simulator
      • Flows: Best Practices
      • Flows: Use Cases
      • Timezone Converter Handler
      • Supported Timezones
    • API and Mapping
  • Tutorials
    • Create a new Integration Pipe
    • Create a new Flow
    • How to Map data?
    • Working with Modifiers
    • Managing User Groups
    • How to use DCKAP Integrator Dynamic URL's?
  • API Documentation
    • Quick Start
    • Projects API
    • Credentials API
    • Templates API
    • Posting and Reading XML data via DCKAP Integrator
    • Commonly used APIs
  • Others
    • Product Roadmap
      • Past Roadmaps
    • Release Notes
      • 4.4.0 April 29, 2025
      • 4.3.0 February 25, 2025
      • 4.2.0 December 19, 2024
      • 4.0.0 August 29, 2024
      • 3.4.8 May 27, 2024
      • 3.4.7 March 14, 2024
      • 3.4.6 January 4, 2024
      • 3.4.5 October 18, 2023
      • 3.4.4 May 16, 2023
      • 3.4.3 March 1, 2023
      • 3.4.2 December 20, 2022
      • 3.4.1 October 4, 2022
      • 3.4.0 August 10, 2022
      • 3.3.6 July 20, 2022
      • 3.3.5a June 23, 2022
      • 3.3.5 May 26, 2022
      • 3.3.4 March 31, 2022
      • 3.3.3 Feb 4, 2022
      • 3.3.2 November 24, 2021
      • 3.3.1 October 22, 2021
      • 3.3.0 August 28, 2021
      • 3.2.7 June 18, 2021
      • 3.2.6 May 11, 2021
      • 3.2.3 and 3.2.4 March 8, 2021
      • 3.2.2 Dec 24, 2020
      • 3.2.1 Nov 12, 2020
      • 3.2.0 - October 7, 2020
      • 3.1.10 - September 16, 2020
      • 3.1.9 - September 3, 2020
      • 3.1.8 - August 15, 2020
      • 3.1.7 - July 19, 2020
      • 3.1.6 - June 21, 2020
      • 3.1.5 - May 15, 2020
      • 3.1.4 - April 27, 2020
      • 3.1.3.0 - April 20, 2020
      • 3.1.3 - April 8, 2020
      • 3.1.2 - March 26, 2020
      • 3.1.1 - March 13, 2020
      • 3.1.0 - March 10, 2020
Powered by GitBook
On this page
  • Add Private System
  • Test Connection
  • Edit a Private System

Was this helpful?

  1. PROJECT MANAGER
  2. Systems

Private Systems

PreviousTest APINextAuthentication Types

Last updated 6 months ago

Was this helpful?

If you cannot find the system that you are looking for, you can create a private system and use it. These systems are private and only accessible to the project members.

Add Private System

Step 1: Choose from Systems

Step 2: Provide system details

Provide the following information and then provide the necessary credentials to make the connection.

  • System Name: Name of the system

  • System Logo: Image file of the system logo

  • Get Hostname from User (Yes/No):

    • If yes, the hostname will be prompted from the Credentials. This will be helpful when you have multiple environments like staging and production.

    • If no, the user has to provide the URL with the hostname in the API Manager

  • Status enabled/disabled: To enable or disable the system to use in other modules

  • Authentication Type: The Authentication to be used by the system. The following authentication methods are available in the dropdown list:

    • No Auth

    • Cookies Authentication

    • OAuth1

    • NTLM

    • Basic Authentication

    • MySQL Authentication

  • Description: Description of the system

  • Token Failure Status Code: The status code that the system will return for an invalid token. Example: 401, 403

  • Timeout: This is the "maximum allowed time" value, before which a Timeout error is thrown. You can set a time (in seconds) for both the "Connect" and "Read" fields.

    • "Connect" refers to the maximum allowed time for DCKAP Integrator to establish communication with the system to which the API call is made.

    • "Read" refers to the maximum allowed time for the system to respond back to DCKAP Integrator.

Users can enter only 4-digit numeric values in the Connect and Read fields.

  • The default value for Connect = 30 seconds

  • The default value for Read = 240 seconds

Test Connection

URL

The Test connection API is used to check if DCKAP Integrator is successfully connected to your system.

If the user has chosen Get Hostname from User as NO, then the hostname should be provided in the URL here.

Some example URLs are:

/SapB1/controller/testConnection
https://www.example.com/api/Ping/PingToken

Params, Header, and Body

Three fields are set for each parameter/header/body:

Field

Description

Example

Label

A suitable display name for headers/params/body data

Content-Type

Key

Variable name at which the value is populated

Content-Type

Value

The actual value stored in the Key

Support Content Types

  • application/json

  • application/xml

DCKAP Integrator has the ability to provide a static value directly here. But if the dynamic token is to be generated from a different URL, this keyword can be used.

Error Handler

By default, DCKAP Integrator treats all status codes other than 200 as errors. But some systems provide error responses in the 200 OK status code itself. This section is used to identify those scenarios and treat them as errors. Users can configure the error messages that need to be displayed during the "Test Connection" process.

Provide the following details:

  • Status Code: The code for which the error is thrown. Example: 200

  • Validator: The logic that validates the error message. Example: isValid= Yes/No

  • Message: Enter the content that needs to be displayed in the error message. The "key" of the message to be displayed is given here.

    Example:

    200 Error Response

    {"isValid": "No", message: "Some Error Occured"}

    200 Success Response

    {"isValid": "Yes", data: {...}}

Available Keywords

1. DYNAMIC_TOKEN

Example Dynamic Token URL: /connect/token

The Dynamic token body contains information on how the token is generated. It can either be a username/ password combination or a client id/ client secret combination got from the user. The token generated using this information is utilized while triggering any API Call to the system.

DYNAMIC_TOKEN is also supported in the raw body of the request. While using in the body, the user can provide a content type to pass in the respective format. By default, DYNAMIC_TOKEN will be passed as a string. To pass as JSON, add content-type: application/json.

Authorization: This is the Header that is used in most API calls and is used to validate the API request using the authorization token. This token is stored in the system and will be inherited whenever the API is called.

Define the TokenURL in the System page as /get/token or /connect/token, etc.. depending on the system.

Sample Use Cases: Now, let's say your system requires a Username and Password to return a token. After providing the Username and Password on the System page, DCKAP Integrator will use that information to get the token by triggering the TokenUrl.

The following are four use cases explaining how to provide Authorization details in the API Manager page to retrieve token details from the TokenURL API response.

Sample Response from the TokenURL API

Format in which the system API Accepts token

Structure to enter in your API manager

Value:

Label: As you wish

Key: Usually "Authorization". This might differ according to your system

response =

{

"token":"TOKEN_VALUE_FROM_THE_SYSTEM"

}

Bearer TOKEN_VALUE_FROM_THE_SYSTEM

Bearer DYNAMIC_TOKEN[token]

response = "TOKEN_VALUE_FROM_THE_SYSTEM"

Bearer TOKEN_VALUE_FROM_THE_SYSTEM

Bearer DYNAMIC_TOKEN

response =

{

"authentication":{

"access_token":"TOKEN_VALUE_FROM_THE_SYSTEM"

}

}

Bearer TOKEN_VALUE_FROM_THE_SYSTEM

Bearer DYNAMIC_TOKEN[authentication][access_token]

response = {

"authentication":{

"access_token":"TOKEN_VALUE_FROM_THE_SYSTEM"

}

}

Basic TOKEN_VALUE_FROM_THE_SYSTEM

Basic DYNAMIC_TOKEN[authentication][access_token]

2. GET_FROM_CREDENTIALS

The data field for which GET_FROM_CREDENTIALS is entered here will be obtained from the user while configuring the System Credentials.

In the following example, the "username" value will be populated in the Credentials section for the user to enter.

Below is the prompt in the credentials section

Edit a Private System

Click "Edit System" on the System details page to manage the system fields.

If the Authorization Header key has a value: "DYNAMIC_TOKEN", and then the Dynamic Token section gets populated on the screen.

OAuth2
Learn more.
Add a Private System
Edit a Private System
"username" field populates in Credentials page