Versions Compared

Key

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

On this page you will learn how to connect your Gravitee Gateway to Obsidian Boomi´s API Control Plane step-by-step.

Overview of this Guide

...

...

Prerequisites

The following is required to proceed:

Create a new Environment

To get started, simply open your API Control Plane instance and follow the instructions below.

Add an Environment for Gravitee

  • Navigate to “Environments” in the menu on the left side

  • Click on the “Create New Environment” button in the top right corner

  • Fill in the form (as exemplarily shown below)

...

  • Confirm by clicking on the "Create New Environment" button

Select your Provider

  • Choose your provider by clicking on it

  • Confirm by clicking on the "Next" button

    Image Removed

(tick) You’ve completed the first step!

...

Insert excerpt
How to connect to AWS
How to connect to AWS
nameCreate a new Environment
nopaneltrue

...

Provide the Gateway Information

...

  • url: Insert the URL to your Gravitee Management API

    • This is not the URL of your Gravitee Management UI!

    • To test if this is the correct Url, try calling <Url>/management/organizations/DEFAULT/console and check that you get a valid response and no errors.

  • user/password: Credentials of a user of your Gravitee instance with access rights to the Management API

...

  • Your configuration file will download automatically.

  • Confirm by clicking on the "Download and Next" button

(tick) You’ve completed the second step!

Create an Agent as Intermediary

The following describes how to create a Docker container for the agent. It is described using a Docker compose file so that additional agents can be easily added to your docker stack later.

...

  • image: The docker image of the API Control Plane Agent

  • container_name: You can freely choose the name of your Agent here as well as in line 3.

  • environment

    • backendUrl: The agent will establish a web-socket to this URL and thereby connect to your API Control Plane.

    • gateway-config: The path inside the container to the configuration you downloaded in step 2.

  • volumes

    • The outer path of the configuration file : The inner path of the configuration file

  • Click on “Download” to download your agent docker compose

  • Put both files in the same folder. Then run the following commands.

    • Code Block
      docker pull ghcr.io/apiida/obsidian-agent:latest
      • Download the latest image of the agent.

    • Code Block
      docker compose up
      • Starts the agent. It will connect automatically.

(tick) You’ve completed the third step!

Check the Agent's Status

  • Head over to your API Control Plane instance

  • Select “Environments” in the menu on the left side

    • Your AWS Agent should now be connected to API Control Plane

  • Click on the tile or the entry in the table to get more detailed information about the status of the connection. This can be very useful in case of an error.

(tick) You’ve completed the last step!

You can now interact with your AWS Gateway through APIIDA´s API Control Plane.

Try it right now and discover your APIs!

💡 Tip: It is easy to add more agents!

Repeat this guide or that of another gateway and simply add the agents to the existing Docker compose file.

...

Insert excerpt
How to connect to AWS
How to connect to AWS
nameCreate an Agent as Intermediary
nopaneltrue

...

Insert excerpt
How to connect to AWS
How to connect to AWS
nameCheck the Agent's Status
nopaneltrue

...

Q&A

Expand
titleHow do I now my URL for Gravitee Management API is correct?
  • Calling <URL>/management/organizations/DEFAULT/console will return a valid response.

  • Note that the URL for Gravitee Management API is not the same as the URL for Gravitee Management UI, which you may be using to access gravitee in your browser - though the difference may be in port only.

Expand
titleHow do I manage users in Gravitee?