Azure PIM CLI (azpim)

أداة سطر أوامر لإدارة تفعيل أدوار Azure Privileged Identity Management (PIM) مباشرة من الطرفية الخاصة بك.

الميزات

• 🔐 تفعيل الدور - تفعيل أدوار Azure PIM المؤهلة بسرعة
• 🔓 إلغاء تنشيط الدور - إلغاء تنشيط الأدوار النشطة عند عدم الحاجة إليها
• 📋 قائمة تفاعلية - واجهة سهلة الاستخدام تعمل بالقوائم
• ✨ واجهة مستخدم جميلة - تجربة طرفية مصقولة مع مؤشرات التحميل والألوان
• 🔄 دعم أدوار متعددة - تفعيل أو إلغاء تنشيط أدوار متعددة في وقت واحد
• 📊 تتبع الحالة - ردود فعل فورية حول حالة التفعيل/إلغاء التنشيط
• 💾 الإعدادات المسبقة - حفظ وإعادة استخدام إعدادات التفعيل/إلغاء التنشيط
• ⭐ المفضلة - وضع علامة على الاشتراكات كمفضلة للوصول السريع
• 🗃️ ذاكرة تخزين مؤقت للاشتراكات - تخزين تلقائي للاشتراكات (مدة صلاحية 6 ساعات) لبدء تشغيل أسرع
• 🚀 وضع غير تفاعلي - علامات CLI للنصوص البرمجية والأتمتة
• 🔔 إشعارات التحديث - فحص تلقائي للتحديثات مع سلوك قابل للتكوين
• 📤 مخرجات JSON - مخرجات قابلة للقراءة آليًا للتكامل مع الأدوات الأخرى
• 👤 عزل البيانات لكل مستخدم - تخزين الإعدادات والذاكرة المؤقتة لكل معرف مستخدم Azure

المتطلبات الأساسية

قبل استخدام azpim، تأكد من أن لديك:

1. Node.js (الإصدار v18 أو أحدث)
2. Azure CLI مثبت ومهيأ
3. حساب Azure بأدوار مؤهلة لـ PIM

إعداد Azure CLI

# Install Azure CLI (if not installed)
# See: https://docs.microsoft.com/en-us/cli/azure/install-azure-cli

# Login to Azure
az login

# Verify you're logged in
az account show

التثبيت

التثبيت العام (موصى به)

# Using npm
npm install -g azpim

# Using pnpm
pnpm add -g azpim

# Using yarn
yarn global add azpim

بعد التثبيت، سيكون الأمر azpim متاحًا بشكل عام.

الترحيل من azp-cli

إذا كنت تستخدم سابقًا azp-cli، فسيتم تخزين الإعدادات المسبقة الخاصة بك في ~/.config/azp-cli/ (أو %APPDATA%\azp-cli\ على Windows). للترحيل:

1. انسخ ملف presets.json إلى الموقع الجديد: ~/.config/azpim/ (أو %APPDATA%\azpim\)
2. قم بإلغاء تثبيت الحزمة القديمة: npm uninstall -g azp-cli

من المصدر (تطوير)

# Clone the repository
git clone https://github.com/tapanmeena/azpim.git
cd azpim

# Install dependencies
pnpm install

# Build the project
pnpm build

# Link globally for development
npm link

الاستخدام

تشغيل CLI

# After global installation
azpim

# Or with specific commands
azpim activate
azpim deactivate
azpim preset list
azpim update

# Development mode (from source)
pnpm dev

الأوامر

الأمر	الاسم المستعار	الوصف
activate	a	تفعيل دور في Azure PIM (افتراضي)
deactivate	d	إلغاء تنشيط دور في Azure PIM
preset	-	إدارة الإعدادات المسبقة القابلة لإعادة الاستخدام
favorites	fav	إدارة الاشتراكات المفضلة
check-update	update, upgrade	التحقق من وجود إصدار أحدث
help	-	عرض معلومات المساعدة

العلامات العامة:

• --debug - تمكين تسجيل التصحيح
• --version - إظهار رقم الإصدار

أوامر الإعدادات المسبقة الفرعية

الأمر	الوصف
preset list	سرد جميع الإعدادات المسبقة المتاحة
preset show	عرض تفاصيل إعداد مسبق معين
preset add	إضافة إعداد مسبق جديد (معالج تفاعلي)
preset edit	تعديل إعداد مسبق موجود (معالج تفاعلي)
preset remove	إزالة إعداد مسبق

أوامر المفضلة الفرعية

الأمر	الوصف
favorites list	سرد جميع الاشتراكات المفضلة
favorites add	إضافة اشتراك إلى المفضلة
favorites remove	إزالة اشتراك من المفضلة
favorites clear	مسح جميع المفضلة
favorites export	تصدير المفضلة إلى ملف
favorites import	استيراد المفضلة من ملف
favorites refresh	تحديث الذاكرة المؤقتة للاشتراكات

التحديثات

يمكنك التحقق من توفر إصدار أحدث:

azpim update
# alias
azpim upgrade

ملاحظات:

• azpim update يخرج برمز 0 عندما يكون محدثًا، و2 عندما يتوفر تحديث، و1 عند حدوث خطأ.
• --check-only - فقط تحقق واطبع الحالة دون عرض تعليمات الترقية.
• --output json يعيد استجابة منظمة مناسبة للنصوص البرمجية.
• افتراضيًا، سيعرض كل من azpim activate و azpim deactivate تلميحًا قصيرًا عن "تحديث متاح" (وضع النص فقط) مرة واحدة على الأكثر يوميًا.
• قم بتعطيل فحص التحديثات عبر AZPIM_NO_UPDATE_NOTIFIER=1 (أو AZPIM_DISABLE_UPDATE_CHECK=1).

يتم تخزين ذاكرة فحص التحديث المؤقتة بجانب الإعدادات المسبقة في دليل الإعدادات الخاص بك:

• macOS/Linux: ~/.config/azpim/update-check.json (أو $XDG_CONFIG_HOME/azpim/update-check.json)
• Windows: %APPDATA%\azpim\update-check.json

الوضع غير التفاعلي (الأتمتة)

استخدم العلامات لتفعيل أو إلغاء تنشيط أدوار PIM مباشرة دون المرور عبر القائمة التفاعلية، مثالي للنصوص البرمجية وسير عمل CI/CD.

أمثلة التفعيل

# Activate a single role by name (non-interactive)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --duration-hours 2 \
   --justification "Break-glass for incident" \
   --output json

# Activate multiple roles (repeat --role-name)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --role-name "User Access Administrator"

# If a role name matches multiple eligible roles (different scopes),
# --non-interactive will error unless you explicitly allow activating all matches
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --allow-multiple

# Preview what would happen without submitting requests
azpim activate --non-interactive --dry-run \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --output json

أمثلة إلغاء التنشيط

# Deactivate specific roles
azpim deactivate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --justification "Task completed"

# Deactivate across all subscriptions (omit subscription-id)
azpim deactivate --non-interactive --yes \
   --role-name "Contributor" \
   --allow-multiple

العلامات المتاحة

العلامات المشتركة (تفعيل/إلغاء تنشيط):

• --non-interactive - تعطيل المطالبات التفاعلية
• -y, --yes - تخطي مطالبات التأكيد
• --subscription-id <id> - الاشتراك المستهدف (اختياري لإلغاء التنشيط)
• --role-name <name> - اسم (أسماء) الدور المستهدف (يمكن تكراره)
• --allow-multiple - السماح بتطابقات أدوار متعددة
• --dry-run - معاينة بدون إرسال
• --output <text|json> - تنسيق المخرجات (افتراضي: text)
• --quiet - إخفاء المخرجات غير الأساسية

خاصة بالتفعيل:

• --duration-hours <n> - المدة (1-8 ساعات، المدة الافتراضية تختلف حسب الدور)
• --justification <text> - مبرر التفعيل

خاصة بإلغاء التنشيط:

• --justification <text> - مبرر إلغاء التنشيط (اختياري)

الإعدادات المسبقة

تتيح لك الإعدادات المسبقة حفظ روتينات التفعيل/إلغاء التنشيط اليومية (الاشتراك + أسماء الأدوار + المدة + المبرر) وإعادة استخدامها باستخدام --preset <name>.

موقع ملف الإعدادات المسبقة

افتراضيًا، يتم تخزين الإعدادات المسبقة في ملف إعدادات لكل مستخدم:

• macOS/Linux: ~/.config/azpim/presets.json (أو $XDG_CONFIG_HOME/azpim/presets.json)
• Windows: %APPDATA%\azpim\presets.json

تجاوز الموقع باستخدام:

• AZPIM_PRESETS_PATH=/path/to/presets.json