About • Release Status • Contributing • Licensing
This repository hosts source code for the reference implementation of GovStack Consent Building Block service APIs
Released. Refer to the wiki page for the latest status of the deliverables.
The prerequisites for getting the server up and running are as follows:
- Docker is up and running on your server. You can check it using the command docker ps.
- Pre-install jq, a lightweight and flexible command-line JSON processor for parsing and manipulating JSON data.
You can request a pre-defined configuration file and skip the following steps by contacting support@igrant.io. Please specify the desired admin username in your request. Alternatively, you can proceed with steps 3 and 4 for manual installation and configuration.
- Install keycloak and use the parameters in step 4 configurations below.
- The configuration parameters used by the Consent BB API server is created at /bb-consent-api/resources/config/config-development.json. This sets up the default parameters for the Consent BB server instance, such as organisation details, admin access security (with keycloak, etc. This can also be modified later but would require building the server again.
Note: It is recommended to remove all container instances and volumes running using docker container rm -f $(docker container ls -aq) and docker volume rm $(docker volume ls -q). If any of the steps below need to be repeated, we recommend this step to ensure a clean environment.
Now, follow the steps below to get the ConsentBB API server up and running:
- Clone this repository to your local server using
git clone. - Check out the latest release or any available release you wish to run. E.g.
git checkout tags/2023.10.4. - Execute
make setup. This sets up the necessary dependencies and configurations for running the Consent BB API server instance. - Execute
make api/build. The compiles and assembles source code into executable files or libraries, following the instructions specified in the Makefile of Consent BB API server instance. - Execute
make api/run. This executes a predefined set of instructions in the Makefile to launch or run the compiled Consent BB API server instance.
The server is up and running now locally at https://api.bb-consent.dev/v2. You can use openAPIs with postman or the admin dashboard to interact with the Consent BB server instance.
Feel free to improve the plugin and send us a pull request. If you find any problems, please create an issue in this repo.
Copyright (c) 2023-25 LCubed AB (iGrant.io), Sweden
Licensed under the Apache 2.0 License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.