Getting Started

You should have information such a the following:

docker login docker-your-company.artifactory.cloudentity.com
username: your-company
password: xxxxxxxxxxxx

You will need to set up Docker to use those credentials to build your project and retrieve supporting files. At this time you will need to request the permisson-service.zip file from your Cloudentity contact. Once you have downloaded and unzipped that file you will have minor configuration.

Docker Compose

First step is to change the location of your docker repository. Where the image says "docker-your-compnay.artifactory…​" change it to the server name provided by Cloudentity as described above

version: "2.4"
services:
  permission-service:
    mem_limit: 1024M
    container_name: permission-service
    image: docker-your-company.artifactory.cloudentity.com/permission-service:2405763
    volumes:
      - ./configs/permission-service:/configs
    ports:
      - 6969:8080
    env_file:
      - .env
      - ./configs/permission-service/.env
    restart: always
    logging:
      driver: json-file
      options:
        max-size: 16m
        max-file: "2"

Configuring the JWT_SECRET

By default the JWT_SECRET for this service is simply the word "secret" so it is critcally important you change that secret to something random and complicated.

Go to the folder permission-service/configs/permission-service — in there you will find a file named .env (remember it will be hidden on most Linux systems). Use a tool like head /dev/urandom | md5 to generate a random string to replace the word "secret"

JWT_SECRET=secret

In Memory or Cassandra

The permission service can be configured to either store in local memory for local usage or use the Distributed Data Store with Cassandra. Currently the Docker version is only configured for in memory — please check with your Cloudentity contacts for integraton with the Distributed Data Store.