Developer Guide

JIM (Junctional Identity Manager) is an enterprise-grade identity management system built on .NET 10.0. The project is open for contribution under a source-available licence.

This guide covers everything you need to get started as a contributor: setting up your development environment, understanding the architecture, building and testing the code, and writing new connectors.

Getting Started

• Development Environment

  ---

  Set up your environment with GitHub Codespaces or a local devcontainer; everything is pre-configured.

  Environment setup

• Architecture

  ---

  Understand JIM's layered architecture, the metaverse pattern, and how services fit together.

  Architecture overview

• Building

  ---

  Build from source, manage database migrations, and work with Docker Compose.

  Build guide

• Testing

  ---

  TDD workflow, unit tests, worker tests, workflow tests, and integration tests.

  Testing guide

• Writing Connectors

  ---

  Implement custom connectors to integrate JIM with new external systems.

  Connector guide

• Contributing

  ---

  Code style, git workflow, security requirements, and contribution guidelines.

  Contributing

Quick Reference

Resource	Description
Repository	Source code on GitHub
Expression Language Guide	C#-like expression language for attribute mappings
SSO Setup Guide	Configure OIDC authentication for any identity provider
Deployment Guide	Production deployment instructions