Yivi IBAN Issuer

This repository implements a system for verifying IBANs using iDEAL payments and issuing credentials via Yivi. It consists of a Go-based backend and a React-based frontend.

Prerequisites

• Node.js: For running the React frontend.
• Go: For running the backend.
• Docker: For containerized deployment.
• OpenSSL: For generating private/public keys.

Setup Instructions

1. Generate Secrets

Run the following commands to generate the private and public keys:

mkdir -p .secrets
openssl genrsa 4096 > .secrets/priv.pem
openssl rsa -in .secrets/priv.pem -pubout > .secrets/pub.pem

2. Install Dependencies

Backend

Navigate to the server directory and install Go dependencies:

cd server
go mod download

Frontend

Navigate to the react-cra directory and install Node.js dependencies:

cd react-cra
npm install

Running the Application

1. Run Backend

Start the backend server with the following command:

go run . --config ../local-secrets/local.json

2. Run Frontend

Start the React app:

cd react-cra
npm start

The frontend will be available at http://localhost:3000.

Docker Deployment

To deploy the application using Docker, run:

docker-compose up --build

This will start the backend, frontend, and required services (e.g., Redis, IRMA server).

Configuration

The backend configuration is stored in local-secrets/local.json. A sample for a local docker compose setup:

{
    "server_config": {
        "host": "0.0.0.0",
        "port": 8080,
        "static_path": "../frontend/build"
    },
    "jwt_private_key_path": "/secrets/priv.pem",
    "irma_server_url": "https://is.staging.yivi.app",
    "issuer_id": "iban_issuer",
    "full_credential": "pbdf-staging.pbdf.iban",
    "cm_iban_config": {
        "base_url": "https://api.cm.com/ibancheck/v1.0/",
        "timeout_ms": 5000,
        "merchant_token": "<redacted>",
        "return_url": "http://localhost:8080/%s/return"
    },
    "storage_type": "redis",
    "redis_config": {
        "host": "redis",
        "port": 6379,
        "password": "password"
    },
    "redis_sentinel_config": {
        "sentinel_host": "redis-sentinel",
        "sentinel_port": 26379,
        "sentinel_username": "sentinel_user",
        "password": "password123",
        "master_name": "mymaster"
    }
}

License

This project is licensed under the Apache License 2.0.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.