Create connector for DRACOON

Requirements

To set up the Intrexx Connector for DRACOON, you should have the following information from the DRACOON Web App:

You should also have the following:

  • Dracoon Root URI ( e.g.: https://example.dracoon.software.com)

Step-by-step guide

To create the Intrexx DRACOON Connector, proceed as follows:

  1. Start the "Integration" module.

  2. yUnder "Consume data", select the "Connector for Connector API" item.

  3. Right-click on it.

  4. Select "+ New data source".

    The "General" dialog is opened.

    General properties

    Name

    Enter the name of the connection here. The name may only consist of letters [a-zA-Z], numbers [0-9], underscores and hyphens.

    Id

    The ID of the connector or connection is displayed here. This is automatically generated by Intrexx.

    Description

    You can enter a description of the connector here.

    Connector template

    Select "dracoon" here.

    Timeout

    Enter the number of milliseconds, seconds, minutes or hours for the timeout here. Select the time unit from the drop-down list to the right of the field.

    Active

    The timeout settings are activated with this checkbox.

  5. Click on "Next".

    The "Data groups" dialog box appears.

    Data groups

    The following data groups are available as standard:

    • DracoonDataSpace

    • UserRoles

    Detailed information on these and other data groups and their use can be found in the section Standard data groups in the Intrexx DRACOON Connector.

    Store data room ID, folder ID

    To access a data room or folder, you need its ID.

    You can find this ID in the URL of your DRACOON Web App.

    If you click on a data room or folder with the mouse, the ID is displayed at the end of the URL. The ID always follows "/node/".

    The dataspace ID or the folder ID is required in Intrexx for the data group attribute "dracoon.dataspace.id" or the parameter "parentId".

  6. Select a data group.

    The data group "DracoonDataSpace" is used as an example for the following steps.

  7. Click on the icon.

    The "Data groups" dialog box is displayed.

  8. Enter your data room ID or folder ID in the "dracoon.dataspace.id" attribute in the data group settings.

    The value stored here serves as a fallback value. You can adjust the fallback value in the external data group in the Intrexx application. See section Adjust fallback value for data room ID.

    If you do not enter a value here, the contents of the top-level data room will be loaded.

  9. Click on "Next".

    The "Authentication" dialog box appears.

  10. Select the value "OAUTH2" for the "Authentication type".

    The fields with the required information for "OAUTH2" are displayed.

    Authentication

    Authentication type

    Select "OAUTH2" here.

    Grant-Type

    Select "AUTHORIZATION_CODE " here.

    Authorization URI

    Enter the Authorization URI here.

    The Authorization URI is composed as follows:

    <DracoonRootURI>/services/oauth/authorize

    Example

    https://example.dracoon.software.com/services/oauth/authorize

    Token URI

    Enter the Token URI here.

    The token URI is composed as follows:

    <DracoonRootURI>/services/oauth/token

    Example

    https://example.dracoon.software.com/services/oauth/token

    Redirect URI (response URL)

    Here, the redirect URI is set automatically by Intrexx.

    The redirect URI is composed as follows:

    <BasisURL>/oauth2/token/<GUID des Intrexx DRACOON Connectors>

    Example:

    https://exampleportal.com/oauth2/token/1234560DEA655234B087EFC539FA0106789

    Base URL The base URL can be found in the main menu under "Portal > Portal properties > Front-end web server ".

    You must store the redirect URI (feedback URL) in the app configuration in the DRACOON Web App.

    You can find a description of this in section Store redirect URI in DRACOON.

    Client ID

    Static Enter the client ID from the portal registration in DRACOON here (see Register Intrexx Portal as an app in DRACOON).

    Client secret

    Statically Store the Client Secret Client ID from the portal registration in DRACOON here (see Register Intrexx Portal as an app in DRACOON).

    Scope

    Static Enter the value "all" here.

    The value entered here refers to the OAuth scope in DRACOON.

  11. Click on "Next".

    The "Service users" dialog box appears.

    Service user

    Service users offer the option of logging in to DRACOON without using a personal user. A service user is useful, for example, if an automated login to DRACOON is to take place when processes are executed. It is also possible to set up an external data group so that the login to DRACOON takes place via a service user.

    Detailed information on creating and using service users can be found in the following sections:

  12. Click on "Next".

    The "Expert settings" dialog box appears.

    Expert settings

    The following information is displayed here:

    Attribute Value
    connector.auth.type OAUTH2
    oauth2.accessTokenUri https://example.dracoon.software/oauth/token
    oauth2.authenticationScheme header
    oauth2.clientAuthenticationScheme client_secret_basic
    oauth2.clientId 123456789XYZ123456789
    oauth2.clientId.source STATIC
    oauth2.clientSecret ABCDEFG123456789 ABCDEFG
    oauth2.clientSecret.source STATIC
    oauth2.grantType authorization_code
    oauth2.redirectUri https://exampleportal/oauth2/token/12345FE97543051C90DC647A95E99A6789
    oauth2.scope all
    oauth2.scope.source STATIC
    oauth2.userAuthorizationUri https://example.dracoon.software/oauth/authorize
    serviceTimeout 0

  13. Add the following attribute with the corresponding value:

    Attribute Value
    dracoon.service.root.uri https://example.dracoon.software (example)

    1. Click on the icon.

      A line is inserted.

    2. Write "dracoon.service.root.uri" and the corresponding value in the line.

  14. Click on "Finish".

    The connector is displayed.