OCI Policy Analysis

Analyze Oracle Cloud IAM policies and identity data.

📘 Full documentation:
👉 https://agregory999.github.io/oci-policy-analysis

Quick Start

python3 -m venv .venv
source .venv/bin/activate
pip install -e .
python -m oci_policy_analysis.main

Or run a packaged release right feom your desktop:

oci-policy-analysis.exe   # Windows
oci-policy-analysis.app   # macOS

For the executables, disable the OS Security for the application so it can run.

• MAC: Settings -> Privacy & Security - Open Anyway

• Windows: Double-click EXE -> More Info - Run Anyway

Contents

User Guide

• Overview
  • Core Features
• Setup
  • Prerequisites
  • Installation Details
  • Authentication and Session Token Setup
  • Permissions (REQUIRED)
  • Running/Using the App
• Architecture
  • Data Model
  • Layers
• Simulation
  • Table of Contents
  • Introduction
  • Components of a Simulation
  • Loading and Editing Where-Clause Variables
  • Deny Statements
  • Running the Simulation
  • Interpreting Results
  • Simulation History
  • Best Practices & Advanced Usage
  • Related Features & See Also
• Recommendations
  • Table of Contents
  • Introduction
  • How Recommendations Are Created
  • Principles for Effective Recommendations
  • Displaying Recommendations to Users
  • Policy Intelligence: Overview
  • Further Reading
• Usage
  • Starting the UI
  • Settings Tab (Start Here)
  • Policy Browser Tab
  • Policy Tab
  • Groups / Users Tab
  • Dynamic Groups Tab
  • Resource Principals Tab
  • Cross Tenancy Tab
  • Permissions Report Tab
  • Historical Comparison Tab
  • Embedded MCP Tab
  • Condition Tester Tab
  • API Simulation
  • Recommendations Tab
  • Console Tab
  • Maintenance Tab
• MCP Server
  • MCP Architectures
  • Running MCP from OCI Policy Analysis
  • Setup for MCP Locally or on a Server
  • Secure Deployment on OCI (Outline Steps)
  • Available MCP Tools
  • 💡 Usage Tips
• Logging and Troubleshooting
  • 1. Global Logging by Component
  • 2. JSON Debugger Tab
  • 3. Troubleshooting Topics

API Reference

• OCI Policy Analysis Main Entry Points
  • User Interface application
  • Command Line Interface
  • Standalone MCP Server
• OCI Policy Analysis UI
  • SettingsTab
  • PoliciesTab
  • DynamicGroupsTab
  • UsersTab
  • ReportTab
  • ConsoleTab
  • PolicyRecommendationsTab
  • McpTab
  • ResourcePrincipalsTab
  • MaintenanceTab
  • DataTable
  • CheckboxTable
• OCI Policy Analysis Data and Logic
  • Policy Repository
  • Reference Data Repository
  • GenAI Integration
  • Policy Intelligence & Analytics
  • Simulation Engine
• OCI Policy Analysis Common Components
  • Data Models
  • Display Helper Functions
  • Cache Manager
  • Global Logger