These docs are under active development and cover the v0.20 Kobicha security model.

Identity

Concept
Understanding Identity on Peios

Every process runs with a token — a structured bundle of security information the kernel evaluates on every access decision.

Concept
What Are Security Identifiers (SIDs)

How Security Identifiers uniquely and permanently identify every user, group, service, and machine on Peios.

Concept
How Tokens Work

What a token contains, how tokens are created and inherited, and why identity is immutable but policy is adjustable.

Concept
Primary Tokens vs Impersonation Tokens

The difference between a process's primary token and per-thread impersonation tokens, and when the kernel uses each.

Concept
Understanding Logon Sessions

What logon sessions are, the different logon types, and how the logon SID scopes access to a single session.

Concept
Service Identities and Per-Service SIDs

How services get purpose-built tokens with per-service SIDs to isolate authority between services sharing an account.

Concept
Machine Identity in a Domain

How machines are security principals with their own SIDs, domain accounts, and authentication credentials.

Concept
How Linked Tokens and Elevation Work

How linked token pairs give administrators standard-user defaults with explicit elevation to full privileges.

How-to
Inspecting a Process's Identity

How to use idn show to inspect the token attached to the current process or another process by PID.

How-to
Inspecting a Thread's Impersonation State

How to check whether a thread is impersonating and inspect its impersonation token with idn show.

How-to
Querying Token Information (SIDs, Groups, Privileges)

How to query specific token fields — user SID, group memberships, and privileges — using idn subcommands.

How-to
Comparing Two Tokens

How to use idn compare to diff two tokens and find mismatched groups, privileges, or integrity levels.

How-to
Working with Elevation

How to check elevation status and launch processes with the elevated token using idn and elevate.

How-to
Well-Known SIDs Reference

Reference table of well-known SIDs including universal, NT Authority, built-in, service, and confinement SIDs.