The Perun Keystone Adapter is a library written in Python that parses data propagated by Perun and modifies a connected Openstack Keystone.
Additionally, the PKA offers the possibility to restrict created projects quotas and create network stuff for new projects.
- abstract keystone to simplify often used tasks (create/delete/update/list users and projects)
- parse SCIM or de.NBI portal compute center propagation data for users and projects
- modify Keystone according the propagated data:
- creates items (users or projects) in Keystone if they not exist but propagated
- modify items properties if they changed
- mark items as deleted and disable them in Keystone if they are not propagated anymore
- deleting (marked and disabled) items functionality is available but not integrated in the normal workflow.
- set/modify project quotas (needs a full openstack installation like DevStack for testing) [optional]
- create network (router, net and subnet) for new projects [optional]
- adjust default security group to support ssh access [optional]
- compatible with python 3.8+
Before installing Perun Keystone Adapter you must be sure that used openstack domain for propagation is empty or all existing projects and users that also exists in perun must be tagged to avoid naming conflicts and the project names must have the same names as the groups in perun. By default, everything created by the library is tagged as perun_propagation. This can be overwritten in the constructor of the KeyStone class.
As a help there are two scripts included in the assets directory of this repository that set a flag of your choice for a user and for a project.
-
First install all necessary dependencies (maybe in your virtual environment) by running
$ pip install -r requirements/default.txt -
The scripts expect that you sourced your OpenStack rc file:
$ source env.rc -
Run the python script
$ python set_project_flag.py project_id flag_nameor
$ python set_user_flag.py user_id flag_namewhere
user_idandproject_idare OpenStack specific IDsflag_namecan be any value which is set for theflagattribute. If you do not modify the perunKeystoneAdapter, it expectsperun_propagationas the value.
Install a specific version of this library by providing a tag of the releases page:
E.g: for version 0.1.1:
pip install git+https://github.com/deNBI/[email protected]The perun propagation service transfers a zipped tar file containing a users and groups file in scim format. The following script unzips and untars the propagated information and adds it to the keystone database. Keystone is addressed by environment variables (sourcing the openstack rc file) or directly by passing an environemt map (not used in the example). The Openstack user needs at least permission to modify entries in Keystone.
$ perun_propagation perun_upload.tar.gzThe python module also contains a built-in server version of the perun_propagation script.
The script uses flask to provide an upload function and run library
functions in a separate thread. It can be simply tested starting the flask built-in webserver.
$ perun_propagation_service
* Serving Flask app "denbi.scripts.perun_propagation_service" (lazy loading)
* Environment: production
WARNING: Do not use the development server in a production environment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)For running this in production it is easy to use gunicorn as follows:
$ gunicorn --workers 1 --bind 127.0.0.1:5000 denbi.scripts.perun_propagation_service:appThe Perun Keystone Adapter can be configured in two different ways, by environment or by configuration file.
# OpenStack credentials
# ---------------------
export OS_REGION_NAME="XXX"
export OS_PROJECT_DOMAIN_ID="XXX"
export OS_INTERFACE="public"
export OS_AUTH_URL="https://XXX"
export OS_USERNAME="admin"
export OS_PROJECT_ID="XXX"
export OS_USER_DOMAIN_NAME="Default"
export OS_PROJECT_NAME="admin"
export OS_PASSWORD="XXX"
export OS_IDENTITY_API_VERSION="3"
# Perun Keystone Adapater settings
# --------------------------------
# Location for storing propagated data
export PKA_BASE_DIR=/pka
# Location for storing logs, defaults to current working directory
export PKA_LOG_DIR=/log
# Log level, must be one of ERROR, WARNING, INFO, DEBUG, defaults to INFO
export PKA_LOG_LEVEL=INFO
# Do not make any modifications to keystone
export PKA_KEYSTONE_READ_ONLY=False
# Domain to create users and projects in, defaults to 'elixir'
export PKA_TARGET_DOMAIN_NAME=elixir
# Default role to assign to new users, defaults to 'user'
export PKA_DEFAULT_ROLE=user
export PKA_DEFAULT_NESTED=False
export PKA_ELIXIR_NAME=False
# Set quotas for projects
export PKA_SUPPORT_QUOTA=True
# Create router for new projects
export PKA_SUPPORT_ROUTER=True
# Create a default network/subnetwork for new projects
export PKA_SUPPORT_NETWORK=True
# Create
export PKA_EXTERNAL_NETWORK_ID=16b19dcf-a1e1-4f59-8256-a45170042790
# Add ssh rule to default
export PKA_SUPPORT_DEFAULT_SSH_SGRULE=True
PKA supports configuration files in JSON format. An example configuration could look like this:
{
"OS_REGION_NAME": "XXX",
"OS_PROJECT_DOMAIN_ID": "XXX",
"OS_INTERFACE": "public",
"OS_AUTH_URL": "https://XXXX",
"OS_USERNAME": "admin",
"OS_PROJECT_ID": "XXX",
"OS_USER_DOMAIN_NAME": "Default",
"OS_PROJECT_NAME": "admin",
"OS_PASSWORD": "XXX",
"OS_IDENTITY_API_VERSION": 3,
"BASE_DIR": "/pka",
"LOG_DIR": "/log",
"LOG_LEVEL": "INFO",
"KEYSTONE_READ_ONLY": false,
"TARGET_DOMAIN_NAME": "elixir",
"DEFAULT_ROLE": "user",
"NESTED": false,
"ELIXIR_NAME": false,
"SUPPORT_QUOTAS": true,
"SUPPORT_ROUTER": true,
"SUPPORT_NETWORK": true,
"EXTERNAL_NETWORK_ID": "16b19dcf-a1e1-4f59-8256-a45170042790",
"SUPPORT_DEFAULT_SSH_SGRULE": true,
"SSH_KEY_BLOCKLIST": [],
"CLEANUP": false
}Build docker container.
docker build -t denbi/pka .
Create environment file (pka.env) :
# OpenStack credentials
# ---------------------
OS_REGION_NAME="XXX"
OS_PROJECT_DOMAIN_ID="XXX"
OS_INTERFACE="public"
OS_AUTH_URL="https://XXX"
OS_USERNAME="admin"
OS_PROJECT_ID="XXX"
OS_USER_DOMAIN_NAME="Default"
OS_PROJECT_NAME="admin"
OS_PASSWORD="XXX"
OS_IDENTITY_API_VERSION="3"
# Perun Keystone Adapater settings
# --------------------------------
# Location for storing propagated data
PKA_BASE_DIR=/pka
# Location for storing logs, defaults to current working directory
PKA_LOG_DIR=/log
# Do not make any modifications to keystone
PKA_KEYSTONE_READ_ONLY=False
# Domain to create users and projects in, defaults to 'elixir'
PKA_TARGET_DOMAIN_NAME=elixir
# Default role to assign to new users, defaults to 'user'
PKA_DEFAULT_ROLE=user
PKA_DEFAULT_NESTED=False
PKA_ELIXIR_NAME=False
# Set quotas for projects
PKA_SUPPORT_QUOTA=True
# Create router for new projects
PKA_SUPPORT_ROUTER=True
# Create a default network/subnetwork for new projects
PKA_SUPPORT_NETWORK=True
# Create
PKA_EXTERNAL_NETWORK_ID=16b19dcf-a1e1-4f59-8256-a45170042790
# Add ssh rule to default
PKA_SUPPORT_DEFAULT_SSH_SGRULE=True
and run the container:
docker run --net host --env-file pka.env -v $(pwd)/perun/upload:/pka -v $(pwd)/perun/log:/log denbi/pkaAlternatively you can use a configuration file (pka.json) ...
docker run --net host -v $(pwd)/pka.json:/etc/pka.json -v $(pwd)/tmp/base:/pka -v $(pwd)/tmp/log:/log denbi/pkaThere are additional deployment options available if you prefer to run WSGI applications with Apache, or other setups.
The Library supports two different logger domains, which can be configured when instantiating the Keystone/Endpoint class (default "denbi" and "report"). All changes concerning the Openstack database (project, identity and quotas) are logged to the logging domain, everything else is logged to the report domain. The loggers are standard Python logger, therefore all possibilities of Python's logging API are supported. See service script for an example how to configure logging.
For testing and development it is recommended to configure and use a [DevStack] (https://docs.openstack.org/devstack/latest/) that fits your production environment.(see test/devstack/README.md)
The library comes with a set of unit tests - a full functional keystone is required to perfom all tests.
For testing the user/project management only a running keystone is enough. The Makefile included with
the project runs a docker container for providing a keystone server.
It is recommended to configure and use a [DevStack]. In any case it is not recommended to use your production keystone/setup .
$ make lint
will run flake8 on the source code directories.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent