Skip to main content

Hardware and Software Requirements

Architecture

ADOIT instanceADOIT instance which is deployed either on premise, in a private cloud or at BOC cloud services. The deployment must be accessible from the ADOIT x Confluence App and the Feature and Foundation Services.
ADOIT x Confluence AppCloud native application that integrates Confluence Cloud with ADOIT instances. This application embeds functionalities of Feature and Foundation Services.
ADOIT x Confluence InstallationThe app that has been installed in the Confluence Cloud instance.
AuthenticationAuthenticates the user at ADOIT instances with OAuth 2.0.
AWSUsed hyperscaler Amazon Web Services.
BOC Cloud ServicesCloud native application services provided by BOC and hosted on AWS.
BrowserWeb client used to access both ADOIT instance and Confluence Cloud by the user.
ConfluenceConfluence Cloud instance that has the ADOIT x Confluence App installed.
Customer Map ServiceCloud database that stores a mapping between Atlassian Confluence Cloud instance and the ADOIT instances. No sensitive data is stored here.
Feature ServicesCloud native application services that implement reusable and 3rd party-platform-agnostic business functionalities.
Foundation ServicesCloud native application services that provide the underlying technical services like authentication and customer mapping.
MacrosConfluence Macros that provide business functionalities to embed ADOIT instance data to Confluence Cloud pages.

Software Requirements

note

In order to use ADOIT Enterprise Architect for Confluence with your ADOIT Enterprise Edition, the Standard RESTful services module must be licensed and enabled!

Requirements
ADOITEnterprise Edition:
ADOIT 15.1.3 or higher

The Standard RESTful Services component is required
PlattformAtlassian Confluence Cloud
BrowserMicrosoft Edge
Google Chrome

Confluence Setup

This section describes the setup requirements for Confluence.

Requirements
Plugins configurationA Confluence administrator is required to install and configure the ADOIT Enterprise Architect for Confluence apps.
Instance mappingThe ADOIT instance URLs that shall be accessed by the Confluence Cloud instance have to be added to the Customer Map Service.
UsersUsers with edit permissions to Confluence pages can add, remove, and manage ADOIT Enterprise Architect macros.

NOTE: Only ADOIT models and objects that the user has access to can be used by macros.

ADOIT Setup

This section describes the setup requirements for ADOIT when using ADOIT Enterprise Architect for Confluence together with the ADOIT.

Requirements
AuthenticationTo fetch data from ADOIT instances, the REST API with OAuth 2.0 must be enabled for each of them.
UsersTo enable a user to embed and view ADOIT contents in Confluence Cloud, the user must have an active ADOIT user with an user group and a repository assigned.

NOTE: Only content (repository/models/objects) that the user has access to, will also be available via ADOIT Enterprise Architect in Confluence.
CORS policyCORS policy settings have to be configured.
SecuritySSL/HTTPS is required.
RESTful servicesLicensed and activated.

For more information on the setup process, please check the Installation Manual document.

Hardware Requirements

Make sure the requirements for Atlassian Confluence Cloud and the BOC Products are met in order to use the ADOIT Enterprise Architect for Confluence.

Depending on the usage scenario of the ADOIT Enterprise Architect for Confluence, it might be required to increase the hardware resources for ADOIT.