Zum Hauptinhalt springen

Installation Manual

Overview​

This section describes

  • the installation of the ADOIT Enterprise Architect for Confluence app for Atlassian Confluence Cloud

  • the set-up of the connection between the Confluence Cloud instance and one or more ADOIT instances

Where to get ADOIT Enterprise Architect for Confluence​

The ADOIT Enterprise Architect for Confluence app can be found in the Atlassian Marketplace ADOIT Enterprise Architect.

Configuration of ADOIT​

This chapter describes the needed configuration to allow access to the ADOIT instances by ADOIT Enterprise Architect for Confluence.

Hinweis

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

REST API with OAuth 2.0​

Detailed documentation can be found here:

Please note that some specific settings are required:

  1. Administration Toolkit REST scenarios required (more details):

  • Repository read APIs

  • Repository search APIs

  • Users read APIs

  • Metamodel read APIs

  1. OAuth 2.0 client configuration (more details):

ADOIT CORS policy​

All ADOIT REST API requests are sent directly from the client web browser. To allow such requests, the following settings of the adoxx_web.properties server file must be set to true:

  • for all requests: security.rest.allow.cors

  • for OAuth 2.0 authentication process requests: security.allow.cors

Hinweis

If you are using ADOIT as SaaS, you can contact hotline@boc-group.com to configure the CORS policy.

Installation of the ADOIT Enterprise Architect for Confluence app in Atlassian Confluence Cloud​

This chapter describes the steps to install the ADOIT Enterprise Architect for Confluence app in Atlassian Confluence Cloud.

  1. In your Confluence Cloud instance go to Find new apps
  2. In the search field enter ADOIT Enterprise Architect for Confluence.
  3. On the right of the ADOIT Enterprise Architect for Confluence marketplace entry, select Try it free or Buy now.
  4. Proceed as suggested by the Atlassian Marketplace dialogs.

Set-up the connection from your Confluence Cloud instance to your ADOIT instance(s)​

After the app has been obtained, an email with further instructions is sent to the submitted email address.

Alternatively, you can directly contact cloud-integration-boc-ag@boc-group.com to provide the following inputs for the Customer Map Service:

  • URL of your Confluence Cloud instance

  • URL(s) of your ADOIT instance(s) that should be accessible by ADOIT Enterprise Architect for Confluence