Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Current »

Here you can learn how to host and configure an additional Developer Portal.

Each Developer Portal can be customized individually. This is especially interesting if you want to bring different API products closer to different customers.

Create your new Developer Portal in the Admin Portal

Go to Configuration > Developer Portals > Create New Developer Portal in your Admin Portal.

  • Name

    • The name of the Developer Portal is displayed in the login screen.

  • Organization

    • When an organization is selected, only API products that this organization is allowed to see will appear there.

  • URL

    • We need the URL to avoid CORS problems. It must start with your subdomain and then a ".".

After creating, you will be shown a token. Copy it. We need it in a moment.

Get the Developer Portal Image

We provide you with a Docker image and also recommend docker to host it.

docker pull apiida/controlplane-devportal

Host and Configure your Developer Portal

Here is a docker-compose.yml script

services:
  obsidian-devportal:
    image: apiida/controlplane-devportal
    container_name: joshn-doe-api-shop
    ports:
      - "3009:443"
    environment:
      BACKEND_URL: https://<tenant>.backend.apiida.io
      # To disable the insertion of the tenant ID the string must not contain 'addTenantIdToBack'.
      # INSERT_TENANT_ID: doNotInsertIt
      DEV_PORTAL_TOKEN: vpfw2d823h8uQRN
      TINY_EDITOR_API_KEY: YourEditorKey
      # ssl configuration - here you can mount your certificate in the container and if you want, also change the whole nginx configuration.
      # volumes:
      #   - ./frontend.crt:/etc/ssl/certs/devportal.crt
      #   - ./frontend.key:/etc/ssl/private/devportal.key
      # http://nginx.org/en/docs/
      #   - ./nginx.conf:/etc/nginx/conf.d/default.conf

A few more environment variables

Variable

Default Value

Description

BACKEND_URL

https://localhost:8080

The public URL of your Control Plane backend. This must be accessible from your webbrowser. For example: https://<tenant>.backend.apiida.io

SUPPORT_URL

http://support.apiida.com

The link to the support portal. Is displayed as a button in the main menu and on the 'Not Found' page.

DEV_PORTAL_TOKEN

0qPG7xXzm65SnioUM2fK

The token of the Developer Portal. You can find this in the Administrations Portal.

INSERT_TENANT_ID

addTenantIdToBackendUrl

To disable the insertion of the tenant ID the string must not contain 'addTenantIdToBack'.

NGINX_PORT_SSL

443

Nginx Port with SSL.

NGINX_PORT

80

Nginx Port with out SSL.

TINY_EDITOR_API_KEY

You must create and provide your own tiny api key here. This is free of charge!

https://www.tiny.cloud/blog/how-to-get-tinymce-cloud-up-in-less-than-5-minutes/

Execute the following command in the console where your docker-compose.yml is located:

docker compose up -d

#That's it. Go to your new Developer Portal.

https://localhost:3009

Customizing

Don't forget to customize your Developer Portal!

Content Management System (CMS)

Table of Contents

  • No labels