# timothy-itayi/okta-iam-lifecycle-lab architecture

> Architecture diagram of the GitHub repository timothy-itayi/okta-iam-lifecycle-lab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/timothy-itayi/okta-iam-lifecycle-lab
- Repository: https://github.com/timothy-itayi/okta-iam-lifecycle-lab

## Overview

This repository is an Okta IAM learning lab, not an executable application. Its central workflow is to prepare an HR source, configure Okta identity and access controls, then record operational evidence. Completed work covers the domain and org decisions, initial staff and group setup, policies, and MFA recovery; SaaS onboarding, SCIM, lifecycle automation, governance, and failure drills remain planned. The graph reflects README-documented relationships only; source excerpts were unavailable, so implementation-level calls cannot be verified.

Main entry points: [`hr/okta-import.csv`](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/hr/okta-import.csv) (One-time import), [`docs/phases/01-foundation.md`](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/phases/01-foundation.md) (Okta foundation), [`hr/employees.json`](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/hr/employees.json) (HR employee source), [`docs/decisions/00-domain.md`](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/00-domain.md) (Domain setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Identity inputs"]
  node_hr_source["HR employee source<br/>[employees.json]"]
  node_import_csv["One-time import<br/>[okta-import.csv]"]
end

subgraph group_okta["Okta administration"]
  node_okta_org["Okta org"]
end

subgraph group_records["Plans and evidence"]
  node_domain_decision["Domain setup<br/>[00-domain.md]"]
  node_org_decision["Org and access decisions<br/>[01-org.md]"]
  node_design_decision["IAM design<br/>[02-design.md]"]
  node_foundation["Okta foundation<br/>[01-foundation.md]"]
  node_mfa_runbook["MFA reset procedure<br/>[mfa-reset.md]"]
  node_audit_evidence["Admin evidence"]
  node_future_lifecycle["Planned SaaS and lifecycle work"]
  node_worklog["Project worklog<br/>[week-1.md]"]
end

node_admin(("IAM administrator"))

node_admin -->|"administers"| node_okta_org
node_import_csv -->|"loads staff"| node_okta_org
node_hr_source -->|"source of truth"| node_import_csv
node_domain_decision -->|"documents setup"| node_okta_org
node_org_decision -->|"documents setup"| node_okta_org
node_design_decision -->|"guides design"| node_okta_org
node_foundation -->|"records configuration"| node_okta_org
node_admin -->|"follows reset"| node_mfa_runbook
node_okta_org -->|"produces evidence"| node_audit_evidence
node_worklog -->|"records progress"| node_foundation
node_admin -->|"plans onboarding"| node_future_lifecycle

click node_hr_source "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/hr/employees.json"
click node_import_csv "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/hr/okta-import.csv"
click node_domain_decision "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/00-domain.md"
click node_org_decision "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/01-org.md"
click node_design_decision "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/02-design.md"
click node_foundation "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/phases/01-foundation.md"
click node_mfa_runbook "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/runbooks/mfa-reset.md"
click node_audit_evidence "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/evidence/1.7-jonah-factor-reset.csv"
click node_worklog "https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/worklog/week-1.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_hr_source,node_import_csv toneBlue
class node_okta_org toneAmber
class node_domain_decision,node_org_decision,node_design_decision,node_foundation,node_mfa_runbook,node_audit_evidence,node_future_lifecycle,node_worklog toneMint
class node_admin toneIndigo
```

## Components

### Identity inputs

- [HR employee source](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/hr/employees.json): `hr/employees.json`
- [One-time import](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/hr/okta-import.csv): `hr/okta-import.csv`

### Okta administration

- **Okta org**

### Plans and evidence

- [Domain setup](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/00-domain.md): `docs/decisions/00-domain.md`
- [Org and access decisions](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/01-org.md): `docs/decisions/01-org.md`
- [IAM design](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/decisions/02-design.md): `docs/decisions/02-design.md`
- [Okta foundation](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/phases/01-foundation.md): `docs/phases/01-foundation.md`
- [MFA reset procedure](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/runbooks/mfa-reset.md): `docs/runbooks/mfa-reset.md`
- [Admin evidence](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/evidence/1.7-jonah-factor-reset.csv): `evidence/1.7-jonah-factor-reset.csv`
- **Planned SaaS and lifecycle work**
- [Project worklog](https://github.com/timothy-itayi/okta-iam-lifecycle-lab/blob/main/docs/worklog/week-1.md): `docs/worklog/week-1.md`

### Other components

- **IAM administrator**

## Connections

- IAM administrator → Okta org: administers (evidence: `README.md`)
- One-time import → Okta org: loads staff (evidence: `README.md`)
- HR employee source → One-time import: source of truth (evidence: `README.md`)
- Domain setup → Okta org: documents setup (evidence: `README.md`)
- Org and access decisions → Okta org: documents setup (evidence: `README.md`)
- IAM design → Okta org: guides design (evidence: `README.md`)
- Okta foundation → Okta org: records configuration (evidence: `README.md`)
- IAM administrator → MFA reset procedure: follows reset (evidence: `README.md`)
- Okta org → Admin evidence: produces evidence (evidence: `README.md`)
- Project worklog → Okta foundation: records progress (evidence: `README.md`)
- IAM administrator → Planned SaaS and lifecycle work: plans onboarding (evidence: `README.md`)
