Minids (Minimal Viable Identifiers) are identifiers that are sufficiently simple to make creation and use trivial, while still having enough substance to make data easily findable, accessible, interoperable, and reusable (FAIR).

This repository contains the minid server. Minid client code is avaialble at https://github.com/fair-research/minid.

Installation

The minid server is a Python Flask application. The following steps outline how to install the server in a development setting.

Download the source code:

$ git clone git@github.com:ini-bdds/minid-server.git

Create a local configuration for development (an example configuration is included below):

$ vim local_config.cfg

Run the server:

$ python main.py

Note: you will need to edit your minid client configuration to point to your local development server.

For production deployments we suggest using Apache and uWSGI. An example WSGI configuration script is avaialble here.

Configuration

Here is an example configuration file that uses a local SQLite database and the EZID test shoulder for minting ARKs.

class Config(object):
    DEBUG = True
    TESTING = True

    SQLALCHEMY_DATABASE_URI = "sqlite:////tmp/minid.db"
    SQLALCHEMY_TRACK_MODIFICATIONS = True

    HOSTNAME = "http://localhost:5000/minid"
    PORT = 5000
    LANDING_PAGE = "http://localhost:5000/minid/landingpage"
    GLOBUS_AUTH_ENABLED = False

    EZID_SERVER = "https://ezid.cdlib.org"
    EZID_SCHEME = "ark:/"
    EZID_SHOULDER = "99999/fk4"
    EZID_USERNAME = "apitest"
    EZID_PASSWORD = "apitest"

    TEST_EZID_SERVER = "https://ezid.cdlib.org"
    TEST_EZID_SCHEME = "ark:/"
    TEST_EZID_SHOULDER = "99999/fk4"
    TEST_EZID_USERNAME = "apitest"
    TEST_EZID_PASSWORD = "apitest"

    # AWS account used for sending email
    AWS_ACCESS_KEY_ID = ""
    AWS_SECRET_ACCESS_KEY = ""
    AWS_EMAIL_SENDER = ""